[ci skip] READMEs (written by qwen)

好罢我是区(太懒了不想写了而且差不多这个项目也是半封闭的状态了大概率也没几个人看这东西(x))

README.md

@@ -1,18 +1,45 @@
 # Shiroha
 
-Shiroha is a fork of [Folia](https://github.com/PaperMC/Folia) — a multithreaded Minecraft server based on Paper.
+![License](https://img.shields.io/badge/License-GPL--3.0-blue)
+![MC](https://img.shields.io/badge/Minecraft-26.2-green)
+![Upstream](https://img.shields.io/badge/Upstream-Folia-orange)
 
-This project aims to provide additional performance optimizations and bug fixes on top of Folia, targeting the latest Minecraft versions (currently 26.2).
+Shiroha 是 [Folia](https://github.com/PaperMC/Folia) 的一个分支。Folia 是基于 Paper 的多线程 Minecraft 服务端，Shiroha 在其基础上跟进最新 Minecraft 版本（当前为 26.2，见 `gradle.properties`），做一些修正、性能优化和配置化的功能扩展。
 
-## Building
+本项目为半闭源项目，以本仓库内的内容为准。
+
+## 构建
+
+需要 Java 25+（构建工具链见 `build.gradle.kts`）。
 
 ```bash
 ./gradlew applyAllPatches
 ./gradlew createPaperclipJar
 ```
 
-Requires Java 25+.
+产物为 paperclip jar，位于 `shiroha-server/build/libs/`。构建任务基于 paperweight-patcher，其余任务可通过 `./gradlew tasks` 查看。
 
-## License
+## 功能
 
-Licensed under the [GNU General Public License v3.0](LICENSE).
+功能大多带有配置开关，配置项定义集中在 `shiroha-server/src/main/java/io/nanachiyo0721/shiroha/config/modules/`，各项的说明直接写在配置文件的注释中，建议以生成出的配置文件和源码注释为准。
+
+具体改动以 patch 文件为准：
+
+- `shiroha-server/minecraft-patches/features/` — 对 Minecraft 源码的改动
+- `shiroha-server/paper-patches/features/` — 对上游 Paper 的改动
+- `shiroha-api/paper-patches/features/` — API 侧改动
+
+主要类别：
+
+- **修正**：Folia 相关的线程与区域化问题、传送与末影珍珠、地狱门 ticket、实体同步等，对应文件名前缀多为 `Fix-*` / `Correct-*`。
+- **优化**：包含部分来自 Leaf、Gale、Purpur、Pufferfish、Lithium 等项目的移植与改写，对应 patch 文件名带有来源前缀；移植的准确性建议对照 patch 内容与原项目确认。
+- **配置系统**：自研的注解式配置框架（`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/config/`），支持热重载与基于 dialog 的图形化配置界面，由 `/shirohaconfig` 命令操作（`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/commands/config/`）。
+- **存档格式**：除原版 `.mca` 外支持 `linear` 与 `b_linear`（带缓冲刷写的 Linear）区域格式（`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/enums/EnumRegionFormat.java`）。
+- **状态栏**：TPS、内存、区域信息状态栏，由 `/bar` 命令与配置控制（`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/functions/bars/`）。
+- **其他**：实体唤醒时长、实体数量限制（Kaiiju）、传送门速率限制、CPU 亲和性等，详见对应 patch 与配置模块。
+
+以上列表不保证完整，未列出的改动请自行查阅 patch 目录。
+
+## 许可
+
+本项目按 [GPL-3.0](LICENSE) 许可。其中从其他项目移植的代码，其归属与许可情况见各 patch 文件内的说明。

README_EN.md

@@ -0,0 +1,45 @@
+# Shiroha
+
+![License](https://img.shields.io/badge/License-GPL--3.0-blue)
+![MC](https://img.shields.io/badge/Minecraft-26.2-green)
+![Upstream](https://img.shields.io/badge/Upstream-Folia-orange)
+
+Shiroha is a fork of [Folia](https://github.com/PaperMC/Folia), a multithreaded Minecraft server based on Paper. It tracks recent Minecraft versions (currently 26.2, see `gradle.properties`) and applies fixes, performance optimizations, and configurable features on top of upstream.
+
+This is a partially closed-source project; the contents of this repository are the reference.
+
+## Building
+
+Requires Java 25+ (build toolchain configuration is in `build.gradle.kts`).
+
+```bash
+./gradlew applyAllPatches
+./gradlew createPaperclipJar
+```
+
+The output is a paperclip jar in `shiroha-server/build/libs/`. The build is based on paperweight-patcher; other tasks can be listed with `./gradlew tasks`.
+
+## Features
+
+Most features are behind configuration switches. Config definitions live in `shiroha-server/src/main/java/io/nanachiyo0721/shiroha/config/modules/`, with per-option documentation written directly into the generated config file comments — treat the generated config and the source annotations as the authoritative description.
+
+The actual changes are tracked as patch files:
+
+- `shiroha-server/minecraft-patches/features/` — changes to Minecraft sources
+- `shiroha-server/paper-patches/features/` — changes to upstream Paper
+- `shiroha-api/paper-patches/features/` — API-side changes
+
+Main categories:
+
+- **Fixes**: Folia threading and regionization issues, teleport and ender pearl behavior, nether portal tickets, entity desync, etc. — patch filenames mostly use the `Fix-*` / `Correct-*` prefixes.
+- **Optimizations**: includes ports and reworkings taken from projects such as Leaf, Gale, Purpur, Pufferfish, and Lithium; these are marked with their source prefixes in patch filenames. Verify the patch contents against the original projects for attribution and accuracy.
+- **Config system**: a custom annotation-based configuration framework (`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/config/`) with hot reload and a dialog-based GUI editor, operated through the `/shirohaconfig` command (`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/commands/config/`).
+- **Region formats**: supports `linear` and `b_linear` (buffered-flush Linear) region formats in addition to vanilla `.mca` (`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/enums/EnumRegionFormat.java`).
+- **Status bars**: TPS, memory, and region info bars, controlled via the `/bar` command and config (`shiroha-server/src/main/java/io/nanachiyo0721/shiroha/functions/bars/`).
+- **Miscellaneous**: entity wake-up duration, entity limits (Kaiiju), portal rate limiting, CPU affinity, and more — see the corresponding patches and config modules.
+
+This list is not guaranteed to be complete; for anything not listed here, check the patch directories yourself.
+
+## License
+
+Licensed under [GPL-3.0](LICENSE). Code ported from other projects retains its own attribution and licensing terms as documented in the respective patch files.