FarlandsOrigin

插件

· 作者 xeef

ClassicFarlands 的 Folia/Paper 移植版,用于在现代服务器上恢复远界(Farlands)

0 本站下载 0 关注 更新于 2 周前

最新 1.1.0 · 26.3 · Folia / Paper

一键开服(送7天)

FarlandsOrigin

适用于 Paper/Folia 服务器的 Farlands

ThePotatoArchivist's ClassicFarlands(MIT 许可 - 请阅读 LICENSE 文件)从 Fabric 移植到 Paper/Folia, 针对 Minecraft 26.1 / 26.2。

警告:由 AI 制作(因为我不懂 Java)- 请支持 原作者

我是一个随机的开发者,你真的不应该信任你在互联网上找到的随机东西。看看源代码,它只有几百行。(点击侧边的 GitHub “查看源码”链接)。如果你愿意,也可以使用 mvn clean package 自行编译项目(需要安装 Java JDK 21+ 和 Maven)。

在部署前请通读整个文件。 这不是常规的“针对不同 API 重新编译”的移植。Fabric 给模组提供了三样 Paper 插件 API 所没有的东西:在 Mojang 注册表冻结之前运行的初始化钩子、对内部世界生成类进行 Mixin 字节码注入,以及在加载时对数据包文件进行通用的 JSON 修补。以下内容都是为了在不使用上述任何一项的情况下替代这三项功能而存在的。

与 Fabric 模组的区别及原因

Fabric 模组部分 Paper 移植版 原因
Registry.register(BuiltInRegistries.DENSITY_FUNCTION_TYPE, ...) in onInitialize FarlandsOriginBootstrap (一个 PluginBootstrap) + NmsRegistryUnfreezer, 反射 Paper 插件在 BuiltInRegistries 已经被冻结之后才加载;Paper API 根本没有这个注册表的接口(对照当前的 RegistryEvents javadocs 检查过——它只涵盖附魔/实体变体/对话框等,不包含世界生成)。
RadiusCheck.java 逐字移植 纯原版 DensityFunction 代码,没有任何 Fabric 特定内容。
BlendedNoiseMixin / PerlinNoiseMixin (SpongePowered Mixin) FarlandsOriginAgent + BlendedNoiseTransformer / PerlinNoiseTransformer (通过 java.lang.instrument agent 使用原始 ASM) 现代 SpongePowered Mixin(版本 mixinextras/@ModifyExpressionValue 所需的那个)在没有模组加载器的情况下没有支持的独立模式——它是围绕与特定启动平台绑定的 IMixinService 构建的。与其发布一个不可验证的 Mixin 引导序列,我直接使用 ASM 进行了相同的两个字节码编辑,这是完全独立可用的。
Mixson (noise_settings 的通用运行时 JSON 修补) FarlandsOriginDatapackInstaller (自动,在引导时) / tools/build_datapack.py (手动后备) + 配套数据包 Fabric 的资源重载事件之外不存在等效项。数据包只能覆盖整个注册表文件,而不能修补一个字段——因此与其在这里无法验证的某个 Minecraft 版本的 vanilla noise_settings.json 内容进行猜测,而是从运行中服务器自己的 classpath(或手动地,你的服务器 jar)中读取它,并仅修补 final_density,就像 Mixson 所做的那样,只是在安装时而不是每次加载时进行。
Quilt Config (FarlandsOriginConfig) FarlandsOriginState + config.yml Kaleido/Quilt Config 在 Paper 上不可用;替换为普通的 Bukkit 配置。相同的 distance 选项,相同的算术运算。

安装

  1. 如果你还没有 Gradle wrapper,请先生成一个。 使用 Gradle 9.1.0 或更高版本——Gradle 仅在 9.1.0 中添加了对运行于 JDK 25 的支持(较旧的 Gradle,包括整个 8.x 系列,在 JDK 25 系统上会因“Unsupported class file major version 69”而失败):

    cd farlandsorigin
    gradle wrapper --gradle-version 9.7
    

    从那时起,对以下每个命令都使用 ./gradlew 而不是 gradle。 使用 JDK 25 构建,而不仅仅是“任何最近的 LTS”——Paper 26.2 的 dev bundle 本身就需要 25+ 运行时来编译对抗(build.gradle 中的 options.release/sourceCompatibility 已经设置为 25 以匹配; 不要降低它们而不也降低 minecraft_version,否则你会遇到 “依赖解析正在寻找与 JVM 运行时版本 X 兼容的库,但 paper-api ... 仅与 ... 25 兼容”)。

  2. 在 gradle.properties 中设置你的确切目标版本 - minecraft_version=26.2(或 26.1.2)会通过 .build.+ 解析为该版本的最新已发布 构建;一旦你选定了一个,将其固定到特定的构建(例如 26.2.build.102),这样后来的重建就不会静默跳转到更新版的 Paper 构建。

  3. 构建。 ./gradlew shadowJar - 需要网络访问,因为它第一次会从 Paper 的 Maven 拉取 minecraft_version 的 paperweight dev bundle。输出:build/libs/farlandsorigin-<mod_version>.jar。 没有单独的“reobf”步骤——Paper 26.1+ 提供完全未混淆的 (Mojang 映射一直到底层),所以这个 jar 就是 服务器运行的内容;没有什么需要重新映射的。

  4. 将该 jar 放入 Folia(或 Paper)服务器的 plugins/ 目录中。

  5. 添加 java agent 标志。 在你的启动脚本中,在 -jar paper.jar 之前(对 Folia 的 jar 同样有效):

    java -javaagent:plugins/farlandsorigin-<mod_version>.jar <your normal flags> -jar folia-<version>.jar nogui
    

    这是可选的,不能从插件内部设置——agents 是一个 JVM 级别的概念,在进程启动时固定,在任何插件代码运行之前。

  6. 启动服务器。 截至此版本,配套的数据包会自动生成和安装——FarlandsOriginBootstrap 直接从 classpath 读取你服务器自己的 vanilla noise_settings.json 文件(就像它已经读取真实的 NMS 类一样),并在扫描该文件夹之前将数据包写入 <level-name>/datapacks/farlandsorigin/,所以对于常见情况,不需要手动查找 jar 或运行脚本。检查日志是否包含:

    • Wrote Far Lands override for overworld.(以及 amplified, large_biomes)
    • FarlandsOrigin datapack auto-installed at ...

如果你没看到这些日志——例如你的服务器使用了非默认的 plugins 文件夹位置,导致安装程序的服务器根目录猜测错误——请改用手动路径:

python3 farlandsorigin/tools/build_datapack.py path/to/your/server.jar farlandsorigin
cp datapack/farlandsorigin/data/farlandsorigin/worldgen/density_function/old_overworld_noise.json \
   farlandsorigin/data/farlandsorigin/worldgen/density_function/
cp -r farlandsorigin <world-folder>/datapacks/

(脚本也能自动检测 Mojang 的 bundler-jar 格式,因此你指向的任何服务器 jar 文件——启动器存根、原始 Mojang jar、已解压的 jar——均可正常工作)

无论是自动还是手动模式,这都必须在世界首次创建/加载之前完成——Far Lands 的世界生成注册表在服务器启动时固化一次,不会回溯应用到之前生成的区块,这与原版模组存在相同的限制。

  1. 检查日志其余部分是否包含以下内容:

    • Registered farlandsorigin:radius_check density function type.
    • [FarlandsOrigin] BlendedNoise.compute: patched 2 call site(s).
    • [FarlandsOrigin] PerlinNoise.wrap: patched to identity function.
    • FarlandsOrigin agent attached; Far Lands generation active at distance ...

    如果缺少上述任何一项或显示修补站点数为 0,则 Far Lands 生成未激活——请参阅故障排除。

配置

plugins/FarlandsOrigin/config.yml:

distance: 12550824

与 Fabric 模组的配置具有相同的选项和算术逻辑。

Folia 注意事项

此移植版不涉及按区域调度,因此无需专门针对 Folia 的线程化区域模型进行移植——世界生成密度函数会在生成特定区域的任意线程上运行,无论使用的是 Folia 还是 Paper,且此插件的代码均未触及 Bukkit 的单线程 API(无实体、无方块更新、无调度)。在 Folia 上唯一需要双重检查的是 PluginBootstrap 相对于注册表冻结的时间点是否与 Paper 上一致(Folia 是 Paper 的分叉版本,因此理应一致,但请在你的 Folia 构建版本中进行验证)。

已知限制 / 在生产环境信任此插件前需验证的内容

本代码是在无法编译或在真实 Paper/Folia 26.1/26.2 服务器上运行的情况下编写和审查的(生产环境缺乏网络访问权限及 NMS jar 包)。具体未验证项如下:

  • NmsRegistryUnfreezer.FROZEN_FIELD = "frozen" —— vanilla 的 MappedRegistry 中用于保存其冻结状态的字段的名称。如果在启动时抛出 NoSuchFieldException,请检查你版本中的 MappedRegistry(例如通过反编译器查看 Paper/NMS jar),并更新该常量。
  • BlendedNoiseTransformer/PerlinNoiseTransformer 的目标签名 —— 基于你自己的 Fabric 模组 mixins 已经定位的方法/类名构建(BlendedNoise.compute、PerlinNoise.wrap、FunctionContext.blockX/blockZ`),这些是 Mojang 的官方映射名称,应原样保留到 Paper 的 mojmap 运行时中。两个转换器都在启动时记录了它们修补了多少个调用站点,以便不匹配的情况能够被明显察觉而非静默失败——如果你看到“found 0 ... to patch”的警告,请反编译你版本中的实际类并进行调整。
  • build_datapack.py / FarlandsOriginDatapackInstaller 对 final_density 的引用与内联检测 —— 基于你的模组自己的 old_overworld_noise.json 中已可见的模式(通过 ID 引用同级条目,如 minecraft:overworld/sloped_cheese),因此 final_density 在现代 vanilla 数据中很可能也是一个纯字符串引用——但两者也处理了内联对象的情况以防万一。
  • FarlandsOriginDatapackInstaller 的服务器根目录检测 —— 使用服务器进程的工作目录(Path.of("").toAbsolutePath()),这是正常启动的服务器(从服务器文件夹内运行 java -jar ... folia.jar)中 server.properties/world//plugins/ 所在的路径。此代码的早期版本尝试从 context.getDataDirectory() 推导该路径,但在真实服务器上抛出了 NullPointerException——该路径实际上是相对的,而非绝对的,因此向上回溯两级父目录会超出根目录范围。如果你使用的工作目录并非实际的服务器文件夹启动服务器(这种情况较少见,但某些包装脚本/进程管理器可能如此),此检测仍会出错——症状与之前相同(出现“Wrote Far Lands override...”日志但生成并未实际更改),修复方法也相同(回退到手动脚本,该脚本通过直接获取世界的数据包路径来规避此问题)。
  • pack.mcmeta 中的 pack_format —— 如果存在,则从类路径上的 version.json(对于手动脚本则是服务器 jar 中)自动检测;如果生成因 pack-format 警告/错误而拒绝加载,请对照服务器的实际 vanilla 数据包进行验证。
  • Java agent 的自足性 —— Launch-Agent-Class/Premain-Class 均在清单中设置,因此无论通过 -javaagent: 附加(推荐,上文所用)还是在运行时自我附加(如果你偶尔需要的话),同一个 jar 都能工作;此处仅仔细推演过 -javaagent: 这一路径。

以上都不是“肯定无法工作”的问题——它们是依赖此插件前应在真实测试服务器上检查的具体、可证伪的事项,列出而非一笔带过。

在真实服务器测试期间修复的问题(保留此处作为记录)

已在实时 Folia 26.1.2 服务器上确认:

  • ASM 完全无法解析 JDK 25 的类文件(Unsupported class file major version 69)—— ASM 在 9.8 版本中才添加了对 Java 25 的支持;更早的版本会直接失败。已锁定 asm_version=9.8。
  • ClassWriter 默认的 getCommonSuperClass 无法识别 NMS 类型 —— 它默认通过代理自身的类加载器进行解析,而该加载器对 Folia 的服务端类没有可见性。通过使用 TargetLoaderClassWriter 修复,该类针对实际加载正在转换类的类加载器进行解析。
  • 从 BlendedNoise 到独立辅助类的普通 invokestatic 调用因 NoClassDefFoundError 失败 —— JVM 使用 BlendedNoise 自身的定义类加载器来解析该符号引用,而 Paperclip/Folia 的加载器在其搜索路径上并未包含此插件的 jar 包。通过让 BlendedNoiseTransformer 将辅助类的编译字段和方法字节码直接复制到 BlendedNoise 本身来修复(参见该类的 Javadoc),从而避免在运行时进行跨类加载器的解析。出于相同原因,配置也通过 JVM 系统属性(farlandsorigin.coordinateDistance / farlandsorigin.baseDistance)而非共享类的静态字段跨越同一边界。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源