2024-02-26 23:20:14 +08:00
|
|
|
|
# DeerFolia
|
|
|
|
|
|
|
2024-03-26 11:02:05 +08:00
|
|
|
|
DeerFolia 是一个基于 [Folia](https://papermc.io/software/folia) 的 Minecraft
|
|
|
|
|
|
服务器核心，它是由 [Mojang](https://mojang.com) 的 Minecraft 服务器核心 [Paper](https://papermc.io) 修改而来。
|
|
|
|
|
|
|
2024-04-01 10:13:08 +08:00
|
|
|
|
<div style="text-align: center;">
|
|
|
|
|
|
|
|
|
|
|
|
<img src="https://ssl.lunadeer.cn:14437/i/2024/04/01/660a164f1873d.png" alt="" width="70%">
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
2024-02-26 23:20:14 +08:00
|
|
|
|
|
|
|
|
|
|
## 此分支特性
|
|
|
|
|
|
|
|
|
|
|
|
- 还原了 [虚空交易](patches/server/0002-Allow-void-trading.patch)；
|
|
|
|
|
|
- 还原了 [刷沙机制](patches/server/0003-Sand-duplication.patch)；
|
|
|
|
|
|
|
2024-03-26 10:31:10 +08:00
|
|
|
|
## 将补丁应用到 Folia 源码
|
|
|
|
|
|
|
|
|
|
|
|
1. 在终端执行 `./gradlew applyPatches` 应用补丁；
|
|
|
|
|
|
2. 完成后会在项目目录下生成 `deer-folia-server` 和 `deer-folia-api` ，前者即为源码目录;
|
|
|
|
|
|
|
2024-02-26 23:20:14 +08:00
|
|
|
|
## 生成服务器核心
|
|
|
|
|
|
|
|
|
|
|
|
1. 应用补丁；
|
|
|
|
|
|
2. 执行 `./gradlew createMojmapPaperclipJar` ，完成后会在 `build/libs` 下生成服务器核心文件；
|
|
|
|
|
|
|
|
|
|
|
|
## 添加新补丁
|
|
|
|
|
|
|
|
|
|
|
|
1. 修改 `deer-folia-server` 或 `deer-folia-api` 中的源码；
|
|
|
|
|
|
2. 在 `deer-folia-server` 或 `deer-folia-api` 目录中将修改内容添加 `git add .` 并提交 `git commit` ，填写补丁信息；
|
|
|
|
|
|
3. 在根目录运行 `./gradlew rebuildPatches` ，将刚才提交的修改生成为新补丁；
|
|
|
|
|
|
|
|
|
|
|
|
## 修改已有补丁
|
|
|
|
|
|
|
|
|
|
|
|
修改已有的补丁步骤相对复杂：
|
|
|
|
|
|
|
|
|
|
|
|
### 方法一
|
|
|
|
|
|
|
|
|
|
|
|
这种方法的工作原理是暂时将 `HEAD` 重置为所需的提交，然后使用 `git rebase` 进行编辑。
|
|
|
|
|
|
|
2024-03-26 11:02:05 +08:00
|
|
|
|
> ❗ 在编辑过程中，除非您 *同时* 将对应模块重置为相关提交，否则将无法编译。就 API 而言，您必须重新应用 Server 补丁，如果正在编辑
|
|
|
|
|
|
> Server 补丁，则必须重新应用 API 补丁。还要注意的是，这样做时任何一个模块都可能无法编译。这不是一个正常的现象，但这种情况时有发生。请给
|
|
|
|
|
|
> Paper 官方提交 ISSUE ！
|
2024-02-26 23:20:14 +08:00
|
|
|
|
|
2024-03-26 11:02:05 +08:00
|
|
|
|
1. 在 `deer-folia-server` 或 `deer-folia-api` 目录中执行 `git rebase -i base`
|
|
|
|
|
|
，应该会输出 [这样的](https://gist.github.com/zachbr/21e92993cb99f62ffd7905d7b02f3159) 内容。
|
2024-02-26 23:20:14 +08:00
|
|
|
|
2. 将你需要修改的补丁由 `pick` 替换为 `edit` 然后保存退出；
|
2024-05-01 11:51:55 +08:00
|
|
|
|
- 一次只能修改 **一个** 文件！
|
2024-02-26 23:20:14 +08:00
|
|
|
|
3. 对你需要修改的补丁作出新的修改；
|
|
|
|
|
|
4. 使用 `git add .` 添加补丁，再使用 `git commit --amend` 提交；
|
2024-05-01 11:51:55 +08:00
|
|
|
|
- **确保添加了 `--amend` 选项** 否则将会创建一个新补丁而不是修改原补丁。
|
|
|
|
|
|
- 此处提交时也可以修改补丁信息。
|
2024-02-26 23:20:14 +08:00
|
|
|
|
5. 终端执行 `git rebase --continue` 应用更新；
|
|
|
|
|
|
6. 再在跟项目目录执行 `./gradlew rebuildPatches` 生成新的补丁；
|
|
|
|
|
|
|
|
|
|
|
|
### 方法二
|
|
|
|
|
|
|
|
|
|
|
|
如果你只是在编辑一个较新的提交，或者你的改动很小，那么在 HEAD 上进行改动，然后在测试后移动提交可能会更简单。
|
|
|
|
|
|
|
|
|
|
|
|
这种方法的好处是可以编译测试你的改动，而不必弄乱你的 HEAD。
|
|
|
|
|
|
|
|
|
|
|
|
#### 手动
|
|
|
|
|
|
|
|
|
|
|
|
1. 修改相应位置源码；
|
|
|
|
|
|
2. 提交修改（可以不写提交内容）；
|
|
|
|
|
|
3. 在 `deer-folia-server` 或 `deer-folia-api` 目录中执行 `git rebase -i base` ，将刚才的提交移动到你想要修改的补丁提交下方；
|
|
|
|
|
|
4. 将新提交的 `pick` 修改为如下内容：
|
2024-05-01 11:51:55 +08:00
|
|
|
|
- `f`/`fixup`：将你的新修改合并到补丁内，但不改变补丁信息；
|
|
|
|
|
|
- `s`/`squash`：将你的新修改合并到补丁内，并用新的补丁信息替换原补丁信息；
|
2024-02-26 23:20:14 +08:00
|
|
|
|
5. 在跟项目目录执行 `./gradlew rebuildPatches` 应用补丁更新；
|
|
|
|
|
|
|
|
|
|
|
|
#### 自动
|
|
|
|
|
|
|
|
|
|
|
|
1. 修改相应位置源码；
|
|
|
|
|
|
2. 提交修改内容 `git commit -a --fixup <要修改的补丁 hash 值>`；
|
2024-05-01 11:51:55 +08:00
|
|
|
|
- 如果希望更新补丁信息，你可以使用 `--squash` 替换 `--fixup`；
|
|
|
|
|
|
- 如果你不知道要修改的补丁 hash 值，你可以使用 `git log` 查看；
|
|
|
|
|
|
- 如果你只知道补丁的名称，你可以使用 `git log --grep=<补丁名称>` 查看；
|
2024-02-26 23:20:14 +08:00
|
|
|
|
3. 执行 `git rebase -i --autosquash base` ，这将会自动将你的修改移动到对应的补丁下方；
|
|
|
|
|
|
4. 在跟项目目录执行 `./gradlew rebuildPatches` 应用补丁更新；
|
2024-05-01 11:51:55 +08:00
|
|
|
|
|
|
|
|
|
|
## 更新上游 Folia 修改
|
|
|
|
|
|
|
|
|
|
|
|
1. 在终端执行 `./gradlew updateFoliaRef` 更新上游 Folia 修改；
|
|
|
|
|
|
2. 应用更新的补丁：`./gradlew applyPatches`。
|
|
|
|
|
|
3. 如果存在冲突，解决冲突，然后运行 `git am --continue` 继续应用补丁；
|
|
|
|
|
|
4. 全部补丁应用完成后，更新补丁：`./gradlew rebuildPatches`。
|
