NSUK-Pam’s HarvestCraft: Crops_Addons

Pam’s HarvestCraft: Crops Addon
Every Pam’s HarvestCraft crop, handed to a hired farmer — including the ones you never got around to planting.
This addon connects Pam’s HarvestCraft 2 – Crops to the New: Sim-U-Kraft farmland box. It registers no blocks and no items of its own. At startup it walks the block registry, finds every pam*crop block in the pamhc2crops namespace that extends CropBlock, resolves its seed and produce item, and registers the result into the NSUK Crop API.
Because the list is scanned at runtime, the exact number of available crops follows the version of Pam’s HarvestCraft you have installed. Updating the source mod adds crops without updating this addon.
Features

• Automatic crop discovery. No fixed list. Any pamhc2crops crop block that follows the naming convention and extends CropBlock is picked up.
• Whole-area field preparation. The farmer fills the selected area with moist farmland, consuming dirt from the chest. A box built on stone, gravel, or deepslate is planted across the full area instead of only on the few spots that already had soil.
• No water channels. The host normally reserves rows for water troughs. This addon answers the water stage as "not needed", so the whole area is planted, including the rows that would have been channels. Channels you already dug are not backfilled.
• Self-contained Chinese translation. The jar ships a Simplified Chinese language file for pamhc2crops with 320 keys, 97 of which are crop block names. It is useful when the source mod has no Chinese translation of its own.
• Separate picker group. Crops appear under the group name "Pam’s HarvestCraft: Crops" in the farmland box picker.
  Requirements
• Minecraft — 1.21.1
• NeoForge — 21.1.228 or newer, below 21.2
• New: Sim-U-Kraft — 2.0.0 or newer (required)
• NSUK: Crop API — 1.0.0 or newer (required)
• Pam’s HarvestCraft 2 – Crops — 1.0.0 or newer (required)
  All four are hard requirements. Without Pam’s HarvestCraft 2 – Crops the scan finds nothing and the picker group stays empty.
  Installation

1. Install NeoForge 21.1.228 or newer for Minecraft 1.21.1.
2. Put New: Sim-U-Kraft, NSUK: Crop API, Pam’s HarvestCraft 2 – Crops, and this jar into mods.
3. Launch the game once so the registry scan runs.
4. Place a farmland box and hire a farmer.
   The mod is required on both client and server.
   Usage
5. Place the farmland box and select its area.
6. Open the box screen and pick a Pam’s HarvestCraft crop from the group.
7. Put the matching seeds and some dirt into the chest next to the box.
8. The farmer tills, plants, harvests, and replants.
   If the chest has no dirt, field preparation stops and the box reports a missing-material state. Dirt is consumed per block, so a large area needs a corresponding amount.
   Configuration
   The addon has no config file of its own. Crop source toggles are handled by the NSUK Crop API settings screen, opened from the mod list’s Config button. Turning this source off hides its crops from the picker and leaves existing boxes running.
   Notes and limits

• The addon adds nothing that can be crafted or placed. Removing it leaves no orphan blocks in the world.
• Crops are matched by the pam prefix and the crop suffix in the block id, and must extend CropBlock. A source mod that renames its blocks outside that convention will not be picked up.
• Paddy-style crops that need standing water are outside the farmland work cycle.
• If you remove Pam’s HarvestCraft while a box is planted, the box keeps an id that no longer resolves and waits. Pick another crop to recover.

License
GPL-3.0.

潘马斯农场：作物附属
潘马斯农场的作物，全部交给雇农——包括你一直没空种的那些。
本附属把《潘马斯农场 2：作物》接入《New: Sim-U-Kraft》的农田盒。它自己不注册任何方块或物品。启动时，它会遍历方块注册表，找出 pamhc2crops 命名空间下所有以 pam 开头、以 crop 结尾并继承 CropBlock 的方块，解析出对应的种子与产物，再注册进 NSUK 作物 API。
由于清单是运行时扫描的，可用作物数量取决于你安装的潘马斯版本。升级本体就会多出作物，不需要等本附属更新。
功能

• 自动发现作物。 没有固定清单。凡符合命名规则且继承 CropBlock 的作物方块都会被收录。
• 整片铺地。 雇农消耗箱中泥土，把选定区域整片铺成湿润耕地。农田盒搭在石头、沙砾或深板岩平台上时，也会整片种满，而不是只在原本有土的几格里零星种几株。
• 不挖水渠。 宿主默认会留出水渠行。本附属把浇水阶段答成"不需要"，因此整片区域都参与种植，包括原本要留作水渠的那些行。已经挖好的水渠不会被回填。
• 自带简中翻译。 jar 内附带 pamhc2crops 的简体中文语言文件，共 320 个键，其中 97 个是作物方块名。本体缺少中文翻译时可以直接用。
• 独立分组。 作物在农田盒选择界面里显示为「潘马斯农场：作物」分组。
  前置要求
• Minecraft —— 1.21.1
• NeoForge —— 21.1.228 或更新，低于 21.2
• New: Sim-U-Kraft —— 2.0.0 或更新（必需）
• NSUK：作物 API —— 1.0.0 或更新（必需）
• 潘马斯农场 2：作物 —— 1.0.0 或更新（必需）
  四项都是硬性前置。缺少《潘马斯农场 2：作物》时，扫描找不到任何方块，分组会是空的。
  安装

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.228 或更新版本。
2. 把《New: Sim-U-Kraft》、NSUK：作物 API、《潘马斯农场 2：作物》与本 jar 放入 mods。
3. 启动一次游戏，让注册表扫描执行。
4. 放置农田盒并雇佣农民。
   本模组需要在客户端与服务端同时安装。
   使用
5. 放下农田盒并划定区域。
6. 打开盒子界面，在潘马斯分组里选一种作物。
7. 把对应种子和一些泥土放进盒子旁边的箱子。
8. 雇农会翻地、播种、收割、补种。
   箱子里没有泥土时，铺地会停下，界面显示等待材料。泥土按格消耗，区域越大需要的量越多。
   配置
   本附属没有独立配置文件。作物来源开关由 NSUK 作物 API 的设置界面统一管理，入口在模组列表的 Config 按钮。关闭本来源只会把作物从选择界面隐藏，已经在跑的农田盒不受影响。
   说明与限制

• 本附属不添加任何可合成或可放置的内容。移除它不会在世界里留下孤立方块。
• 作物按方块 id 的 pam 前缀与 crop 后缀匹配，并要求继承 CropBlock。若来源模组改了命名规则，就不会被收录。
• 需要泡水的水田类作物不在农田盒的作业范围内。
• 若在农田盒种着潘马斯作物时移除本体，盒子会停在无法解析的编号上等待。重新选一种作物即可恢复。

许可
GPL-3.0。