通用工具包

通用工具包

一个NeoForge库模组，提供共享开发者工具：声明式配置、网络辅助、带客户端同步的动态JSON驱动注册表、加权装备/酿造混合系统，以及创造模式标签填充。

🧪 Common Toolkit

一个 NeoForge 库模组，为开发者提供共享工具：声明式配置、网络辅助、由 JSON 驱动的动态注册表（含客户端同步）、加权装备/酿造混合系统，以及创造模式标签页填充。

NeoForge Minecraft 26.2



✨ 概述

Common Toolkit 本身并非游戏性模组——它是一个**库**，供其他模组依赖。它整合了一套基础设施，免去了每个模组从头构建这些繁琐组件的麻烦：配置声明、网络负载管道、在服务器与客户端之间保持同步的 JSON/数据包驱动注册表，以及基于该基础设施构建的几个现成注册表（装备组、酿造混合）。

如果有人让你安装此模组，那是因为整合包中的另一个模组依赖它——它本身不添加任何内容。

 Codex Stalking Dragons

🎯 特性

⚙️ 配置

声明式通用/客户端/服务端配置定义，并带有游戏内配置界面，免去了为每个值手动编写 ModConfigSpec 模板代码的麻烦。

🔧 动态注册表

由 JSON 驱动的注册表，随数据包重载，并通过网络自动将内容从服务器同步至客户端——同时支持加权（用于随机选择场景）和非加权变体。

📡 网络辅助

在 NeoForge 负载 API 之上的一层轻封装，消除了自定义网络数据包重复的注册/处理样板代码。

🎯 装备组与酿造混合

基于上述框架构建的两个现成动态注册表：可配置的加权装备组和自定义酿造配方，供其他模组的游戏逻辑调用。

📦 创造模式标签页填充

声明式注册表，无需为每个模组编写事件处理器即可向现有创造模式标签页（原版或模组）注入物品。

🎨 颜色与编解码器工具

渐变颜色辅助功能，以及上述工具共用的通用 Codec/StreamCodec 构建块。


📄 需求

Minecraft26.2
NeoForge26.2.0.32-beta+
运行端客户端和服务端（两端均需安装）

🎮 使用方法

  1. 作为另一个需要它的模组的**依赖**安装，客户端和服务端均需安装。
  2. 仅运行无需任何配置——它仅向其他模组公开 API 和注册表以供其构建。


🙏 致谢

Common Toolkit 是 Placebo 的重写版、独立品牌移植，原作者为 Shadows_of_Fire（MIT 许可证），以新的模组 ID、包名和 API 重新面向 Minecraft 26.2 开发。原本受 Patreon 赞助门槛限制的装饰系统已被移除。完整的署名信息请参见仓库中的 NOTICE.md，其中包含原出自 Minecraft Forge 配置系统的 LGPL-2.1 部分内容。

由 Stalking Dragons 开发。



Codex Stalking Dragons
https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft 模组开发