NSUK: Crop API

A shared crop registry and work pipeline for New: Sim-U-Kraft farmland boxes.
Back to Files

nsukcropapi-1.1.0.jar

File namensukcropapi-1.1.0.jar
Uploader
anmuchenanmuchen
Uploaded
Nov 16, 2026
Downloads
27
Size
168.1 KB
Mod Loaders
NeoForge
File ID
9647594
Type
R
Release
Supported game versions
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:nsuk-crop-api-1781246:9647594"

Learn more about Curse Maven

What's new

NSUK: Crop API — 1.1.0 更新日志 / Changelog 适配宿主:New: Sim-U-Kraft 2.3.0 及以上(已核对 2.3.0 与 2.3.1) 环境:Minecraft 1.21.1 · NeoForge

Overview Version 1.1.0 is built for New: Sim-U-Kraft 2.3.0 or newer (New-Sim-U-Kraft-2.3.1-neoforge-1.21.1.jar, or 2.3.0). That release renamed the host's Java packages from common.cn.kafei.simukraft to common.cn.nsimu.simukraft, and this API version follows the new layout. Do not use this build with Sim-U-Kraft 2.2.x or older. The host classes it references do not exist there, and the game will fail at startup. Added

  • api.PlotView — a read-only view of farmland plot geometry (min/max corners, width, depth, cell count, serpentine cellAt, column containment).
  • api.BoxView — farmland box position, plot geometry, current crop id, running state, and adjacent containers.
  • api.Boxes — the public entry point for the farmland box context (push / pop / clear / current / all).
  • api.BuiltinCrops — id and translation-key lookup for the six crops built into the host mod.
  • nsuk.WorkContainers#insert — counterpart of the host's insertIntoAny.
  • api.CropWork#usesTrellisWork — a new default method used by the positioning mixins.
  • mixin/v2/FarmlandReachMixin and mixin/v2/FarmlandWorkGeometryMixin — trellis reachability and work-anchor takeover.
  • nsuk.TrellisGate — trellis detection and teleport throttling (40 ticks of pathfinding first, then a 10-tick cooldown per teleport). Changed
  • All host references migrated to common.cn.nsimu.simukraft, matching Sim-U-Kraft 2.3.0.
  • CropApiMixinPlugin now gates reach and geometry separately; the integration log reports six flags instead of four.
  • Version bumped from 1.0.0 to 1.1.0. Compatibility
  • Host: Sim-U-Kraft 2.3.0 or newer (checked against 2.3.0 and 2.3.1). The mod declares simukraft [2.3.0,), so an older host is rejected at the dependency check instead of failing later at class loading.
  • In the com.nsukcropapi.api package, four classes are new (BoxView, Boxes, BuiltinCrops, PlotView). Among the pre-existing classes only CropWork changed, and only by gaining one default method (usesTrellisWork); the remaining pre-existing classes are line-for-line identical.
  • 20 classes in 1.0.0 referenced the old host package (common/cn/kafei); in 1.1.0 all 25 host-referencing classes point at the new package (common/cn/nsimu), and references to the old one are zero.
  • Six published crop addons were checked at bytecode level: 0 unresolved API references, so they do not need recompiling.
  • Build baseline: Minecraft 1.21.1, NeoForge 21.1.250.

概述 1.1.0 是为 New: Sim-U-Kraft 2.3.0 及以上构建的版本(开发基线 New-Sim-U-Kraft-2.3.0-neoforge-1.21.1.jar,已核对 2.3.1)。该宿主版本把 Java 包名由 common.cn.kafei.simukraft 重构为 common.cn.nsimu.simukraft,本版随之切换。 请勿与 Sim-U-Kraft 2.2.x 或更早版本搭配使用。 本版引用的宿主类在旧版中不存在,启动阶段就会报错。 新增

  • api.PlotView —— 农田盒地块几何的只读视图(最小/最大角、宽、深、格数、蛇形顺序取格、列包含判定)。
  • api.BoxView —— 农田盒位置、圈地几何、当前作物 id、运行状态与相邻容器。
  • api.Boxes —— 农田盒上下文的公共入口(push / pop / clear / current / all)。
  • api.BuiltinCrops —— 宿主内置六种作物的 id 与翻译键查询。
  • nsuk.WorkContainers#insert —— 对应宿主的 insertIntoAny。
  • api.CropWork#usesTrellisWork —— 供站位接管判定使用的新默认方法。
  • mixin/v2/FarmlandReachMixin 与 mixin/v2/FarmlandWorkGeometryMixin —— 藤架可达性与作业落脚点接管。
  • nsuk.TrellisGate —— 藤架判定与传送节流(先让雇农自行寻路 40 tick,之后每次传送冷却 10 tick)。 变更
  • 全部宿主引用迁移到 common.cn.nsimu.simukraft,对应 Sim-U-Kraft 2.3.0。
  • CropApiMixinPlugin 将 reach 与 geometry 拆为两道独立 gate,集成日志由四项扩为六项。
  • 版本号由 1.0.0 升至 1.1.0。 兼容性
  • 宿主:Sim-U-Kraft 2.3.0 及以上(已核对 2.3.0 与 2.3.1)。本模组声明 simukraft [2.3.0,),旧版宿主会在依赖检查阶段被拒绝,而不是拖到类加载才失败。
  • com.nsukcropapi.api 包新增四个类(BoxView、Boxes、BuiltinCrops、PlotView);既有类中只有 CropWork 发生变化,且仅新增一个默认方法 usesTrellisWork,其余既有类逐行一致。
  • 1.0.0 有 20 个类的字节码引用旧包名 common/cn/kafei;1.1.0 中 25 个涉及宿主的类全部指向新包名 common/cn/nsimu,旧包名引用为 0。
  • 六个在架作物附属已做字节码级核对:对 1.1.0 的引用零缺失,因此不需要重新编译。
  • 构建基线:Minecraft 1.21.1,NeoForge 21.1.250。 升级提示 / Upgrade Notes
  • 从 1.0.0 升级:直接替换 jar,存档与本模组配置文件无需迁移。
  • 升级前请先确认宿主为 2.3.0 或更高;仍在使用 2.2.x 的整合包应保留 nsukcropapi-1.0.0.jar。
  • Before upgrading, confirm that the host is 2.3.0 or newer. Packs still on 2.2.x should keep nsukcropapi-1.0.0.jar.