基本信息
我的世界Java版本
1.21.1
平台
NeoForge
运行环境
分类
创作者
详情信息
许可证 GPL-3.0-or-later
发布于 2026-11-03
更新于 2026-11-03
NSUK:作物 API 是一个前置库。它不添加方块、物品或作物,也不改变原版农田盒已有的作物行为。它解决的问题是:多个作物附属同时安装时,各自接管农田盒作业阶段会互相覆盖,导致其中一部分作物停在原地不动。
本模组把这件事收敛成一套公共设施:
- 附属用一次注册声明自己的作物;
- 由 API 统一应答宿主的浇水、翻地、播种、骨粉、收割五个阶段;
- 由 API 提供统一的选择界面与存档字段;
- 多个附属声明同一种作物时,由 API 判定归属。 对于玩家,直观的变化是:装了几个作物附属之后,选择界面里会同时出现它们的作物,按来源分组,可以搜索;农田盒选哪个就种哪个,不会再出现"只有最后装的那个能用"。 功能特性
- 作物注册表。 附属在 FMLCommonSetupEvent 阶段注册 CropSpec,注册表按编号索引,重复编号不覆盖先注册者。
- 五阶段作业接管。 浇水、翻地、播种、骨粉、收割由 API 代为应答。只想种普通耕地的附属无需编写作业类。
- 作物选择界面。 支持中英文搜索、按来源模组分组、分组折叠,原版作物单独成组。
- 存档兼容。 农田盒只记录一个稳定编号,增删附属后旧存档仍可读取。
- 共存仲裁。 归属由独立模块判定,不依赖模组加载顺序。
- 兜底命令。 /nsukcrop farmland <作物编号>,权限等级 2,准星对准 8 格内农田盒。 依赖项 类型 名称 版本要求 必需 Minecraft 1.21.1 必需 NeoForge 21.1.228 及以上,低于 21.2 必需 New: Sim-U-Kraft 2.0.0 及以上 本模组需要在客户端与服务端同时安装。 请注意:本 API 自身不含任何作物。只安装它,选择界面里不会出现新作物,还需要至少一个作物附属。
安装
- 为 Minecraft 1.21.1 安装 NeoForge 21.1.228 或更新版本。
- 将 nsukcropapi-1.0.0.jar 与《New: Sim-U-Kraft》放入 mods 文件夹。
- 放入所需的作物附属。
- 启动游戏,确认日志中没有与 nsukcropapi 相关的报错。
- 首次启动后会在 config/ 下生成 nsukcropapi-common.toml。 使用 选择作物 为农田盒雇佣农民后,打开农田盒界面选择作物。选中后,把对应种子放进农田盒旁边的箱子。农民会自行铺土、播种、收割并补种。 配置 在模组列表点击本模组的 Config 按钮,打开「NSUK 作物设置」。 配置项 默认值 说明 autoDiscovery false 开启后扫描没有 JSON 定义的 CropBlock 并加入农田盒。因为种子与产物只能按方块反推,默认关闭。 disabledSources 空 被关闭的来源模组 id,建议在界面中修改。 关闭某个来源只影响选择界面的显示。已经在种该来源作物的农田盒不会中断,也不会损坏存档。 命令 /nsukcrop farmland <作物编号> 权限等级 2。准星对准农田盒后执行,可直接设定作物,供界面无法打开时使用。
常见问题
问:装了 API,为什么选择界面里还是没有新作物? 答:本 API 只提供接入层,不含作物。请确认已安装至少一个作物附属,并且该附属的前置模组(例如它要种的那几个食物模组)也已安装。附属在找不到种子物品或作物方块时会跳过对应条目,并在日志中留下警告。 问:删掉某个附属后,农田盒不动了,存档是不是坏了? 答:不是。盒子当前记录的作物编号已不存在,因此该作业会停下等待。重新选择一种已注册的作物即可恢复,存档本身没有被破坏。 问:能不能用 autoDiscovery 代替装附属? 答:可以打开,但不建议长期使用。扫描只能按方块推断种子与产物,遇到结构特殊的作物(多格高、需要搭架、需要特殊土壤)时结果可能不符合预期。 问:这个模组会改变原版作物的行为吗? 答:不会。原版作物仍由宿主处理,本 API 只是在选择界面里把它们单独列为一组。
许可与来源
本模组以 GPL-3.0 协议发布。整合包收录与转载时请保留作者署名与许可声明,不要移除 jar 内的元数据。 作者:XiaoLiang小亮、安沐尘。



