Forge 1.20.1: backport 20.2.4.6, fix AE2 UI/bookmarks and clean diagnostics

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,113 @@
+name: Bug report / 错误报告
+description: 游戏崩溃、行为异常或模组冲突？请在这里报告。/ Found a crash or an unexpected behaviour? Report it here.
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        请在上方标题中概括问题现象。**只报告一个 bug**——多个无关问题请分开提交，便于定位与关闭。
+
+  - type: checkboxes
+    id: existing-issue
+    attributes:
+      label: 已检查现有问题 / Checked for existing issues
+      description: 提交前请先搜索 open 与 closed 的 issue，避免重复报告。
+      options:
+        - label: 我已搜索过现有 issue，未发现相同报告。/ I have searched existing issues and found none.
+          required: true
+        - label: 我确认这是本模组自身的问题，而非其它模组、启动器或整合包配置导致。/ I confirmed this originates from this mod, not another mod, launcher or modpack config.
+          required: true
+
+  - type: input
+    id: mod-version
+    attributes:
+      label: 模组版本 / Mod version
+      description: 见文件名或 mods 列表中显示的版本号。
+      placeholder: "例如 1.21.1-2.4.5.8"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: 运行环境 / Environment
+      description: 混合端（如 Mohist、CatServer）不受支持。/ Hybrid server cores are unsupported.
+      options:
+        - "单人游戏 / Singleplayer"
+        - "多人游戏 - 局域网 / Multiplayer - Open to LAN"
+        - "多人游戏 - 专用服务器 / Multiplayer - Dedicated Server"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: side
+    attributes:
+      label: 问题出现在哪一侧 / Affected side
+      options:
+        - "客户端与服务器均出现 / Both client and server"
+        - "仅客户端 / Client only"
+        - "仅服务器 / Server only"
+        - "不确定 / Not sure"
+    validations:
+      required: true
+
+  - type: textarea
+    id: other-mods
+    attributes:
+      label: 其他已安装模组 / Other installed mods
+      description: 填写整合包名称，或列出关键模组（尤其 AE2、Mekanism、KubeJS、JEI/EMI/REI 及其版本）。
+      placeholder: |
+        - 整合包名称或「自制整合包」
+        - AE2:
+        - Mekanism:
+        - KubeJS:
+        - 配方查看器（JEI/EMI/REI）:
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 问题描述 / Describe the bug
+      description: 尽可能详细地说明发生了什么，附上相关方块、物品或界面名称。
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: 预期行为 / Expected behavior
+      description: 你认为应当发生什么。
+    validations:
+      required: true
+
+  - type: textarea
+    id: result
+    attributes:
+      label: 实际行为 / Actual behavior
+      description: 实际发生了什么。必要时附截图。
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: 复现步骤 / Steps to reproduce
+      description: 缺少复现步骤的报告通常无法修复，请逐步写清。
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: input
+    id: logs
+    attributes:
+      label: 日志或崩溃报告 / Log or crash report
+      description: |
+        请提供链接（[Gist](https://gist.github.com/)、[pastebin](https://pastebin.com/) 等），不要直接粘贴大段文本，也不要用会过期的链接。
+        非崩溃问题时可在游戏中按住 F3+C 十秒以上强制生成一份报告。
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 搜索已有 issue / Search existing issues
+    url: https://github.com/SorrowMist/UselessMod/issues?q=is%3Aissue
+    about: 提问或报告前请先搜索 open 与 closed 的 issue，避免重复提交。
+  - name: 模组 Wiki / Documentation
+    url: https://github.com/SorrowMist/UselessMod/tree/1.21/wiki
+    about: KubeJS 与数据包 API 的使用文档，提交前请先查阅。

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,52 @@
+name: Feature request / 功能请求
+description: 提出新功能或改进建议。/ Suggest a new feature or an improvement.
+title: "[Feature] "
+labels: ["feat"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        请在上方标题中概括你的建议。提交前请先搜索现有 issue，避免重复提出。
+        本模板用于**功能建议**；使用疑问请先查阅 Wiki 或搜索已有 issue，缺陷请用 Bug report。
+
+  - type: checkboxes
+    id: existing-issue
+    attributes:
+      label: 已检查现有建议 / Checked for existing suggestions
+      options:
+        - label: 我已搜索过现有 issue，未发现相同建议。/ I have searched existing issues and found none.
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 想解决的问题 / Problem to solve
+      description: 说明当前的使用痛点或缺失的能力，而不是直接跳到实现方案。
+      placeholder: "例如：批量处理时每条配方都要手动填一遍，效率很低。"
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 期望的方案 / Proposed solution
+      description: 你希望模组提供什么功能？若涉及 KubeJS / 数据包 API，请给出期望的调用写法。
+      placeholder: |
+        例如：希望能这样调用——
+        ```js
+        // 期望的 API 示例
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 考虑过的替代方案 / Alternatives considered
+      description: 目前你用什么方式绕过？可选填。
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 补充信息 / Additional context
+      description: 涉及的具体模组联动、参考实现、截图或上游 issue 链接等。可选填。

.github/labels.yml

@@ -0,0 +1,49 @@
+# GitHub 标签定义（用于 gh label sync / labeler 工具）
+#
+# 同步方式（需要已登录的 gh CLI，且对仓库有 write 权限）：
+#   gh label sync --file .github/labels.yml
+#
+# 注意：gh label sync 会以本文件为准，删除仓库中未在此声明的其它标签。
+# 若只想新增而不想删除现有标签，请改用：
+#   gh label create bug --color D73A4A --description "..." --force
+#   gh label create feat --color 0E8A16 --description "..." --force
+
+- name: bug
+  color: d73a4a
+  description: 确认或疑似由本模组导致的缺陷、崩溃与行为异常
+
+- name: feat
+  color: 0e8a16
+  description: 新功能、功能改进与体验优化建议
+
+- name: question
+  color: d876e3
+  description: 使用方式、配置与兼容性疑问（请先查阅 Wiki 与已有 issue）
+
+- name: documentation
+  color: 0075ca
+  description: 文档、Wiki 与指南相关
+
+- name: compatibility
+  color: fbca04
+  description: 与其它模组、加载器或服务端的兼容性问题
+
+- name: crash
+  color: b60205
+  description: 游戏启动或运行崩溃
+
+- name: duplicate
+  color: cfd3d7
+  description: 与已有 issue 重复
+
+- name: invalid
+  color: e4e669
+  description: 描述不清、无法复现或不属于本模组范围
+
+- name: wontfix
+  color: ffffff
+  description: 已确认但不会处理
+
+- name: stale
+  color: ededed
+  description: 长期无回应，待关闭

.github/workflows/build.yml

@@ -0,0 +1,35 @@
+name: Build
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Setup JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      # This is needed to be able to run ./gradlew below
+      # You can run `git update-index --chmod +x gradlew` then remove this step.
+      - name: Make Gradle wrapper executable
+        run: chmod +x ./gradlew
+
+      - name: Build with Gradle
+        run: ./gradlew build --console=plain

.gitignore

@@ -1,4 +1,3 @@
-<<<<<<< HEAD
 # eclipse
 bin
 *.launch
@@ -17,33 +16,40 @@ out
 # gradle
 build
 .gradle
+.gradle-tmp
+
+# vscode
+.vscode
+
+#.dbg
+.dbg
 
 # other
 eclipse
 run
-
-# Files from Forge MDK
-forge*changelog.txt
-=======
-.gradle
-**/build/
-!**/src/**/build/
-
-# Ignore Gradle GUI config
-gradle-app.setting
-
-# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
-!gradle-wrapper.jar
-
-# Avoid ignore Gradle wrappper properties
-!gradle-wrapper.properties
-
-# Cache of project
-.gradletasknamecache
-
-# Eclipse Gradle plugin generated files
-# Eclipse Core
-.project
-# JDT-specific (Eclipse Java Development Tools)
-.classpath
->>>>>>> 002d2504eea88f706742ae452f086971844209c3
+runs
+run-data
+net
+repo
+.codegraph
+othermods
+crashreport
+.cursor
+.cache
+.codex
+# external reference code
+references/
+.crashinfo
+.dsh-drop
+.workbuddy
+.workbuddy-ai
+
+# Local builds, verification captures and one-off migration artifacts
+output/
+verification/
+libs/
+__pycache__/
+*.pyc
+*.log
+hs_err_pid*
+*.cleanup-tmp

.vscode/settings.json

@@ -1,6 +1,4 @@
 {
     "java.compile.nullAnalysis.mode": "automatic",
-    "java.dependency.packagePresentation": "hierarchical",
-    "java.jdt.ls.vmargs": "-XX:+UseParallelGC -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xmx4G -Xms100m -Xlog:disable",
-    "java.configuration.updateBuildConfiguration": "automatic"
+    "java.configuration.updateBuildConfiguration": "interactive"
 }