肥料运行时
服务端生长处理、有限田块施肥与骨粉仅作材料的约定。
FertilizerGrowth 是内部实现,由 FertilizerItem.useOnBlock 调用。它在物品使用期间修改现有植物,不保存独立的作物状态,也不新增逐刻管理器。
它做什么
四个 Grade 值分别选择作物进度或植物催生方式。玩家效果与商人报价见肥料。物品在 IsekaiMiscItems 注册,SimpleModelProvider 使用现有贴图生成各自的杂项物品模型。
BoneMealMaterialMixin 仅在物品堆为 Items.BONE_MEAL 时取消原版的两个静态辅助方法:BoneMealItem.useOnFertilizable 与 useOnGround。因此,通过这些方法施肥的手持、发射器与原版农民路径均不再催生;秘法肥料仍能调用水下生长辅助方法。骨粉物品及其配方不被移除。
运行时模型
| 等级 | 作物操作 | 其他植物 |
|---|---|---|
COMMON | 当前生长阶段 + 1,不超过最大值 | 传递交互 |
PREMIUM | 当前生长阶段 + 3,不超过最大值 | 传递交互 |
VERDANT | 同高度 3×3,每株阶段 + 1 | 传递交互 |
MYSTIC | 最大生长阶段 | 原生 Fertilizable 尝试,再检查水下生长 |
客户端预测交互结果。服务端写入方块、发送 WorldEvents.BONE_MEAL_USED,并在作物处理成功时消耗一个物品。有效的原生植物催生尝试即使 canGrow 返回 false 也消耗一份。创造模式不扣物品。
约定
点击位置要求存在玩家、玩家可修改方块、世界允许该位置的修改,且具有 ProtectedAction.BUILD 权限。DungeonWorldPolicy 拒绝地下城世界。丰茂肥料最多处理 9 格,每格另外检查区块已加载及建造权限。中心必须为 CropBlock;中心已成熟时,周围未成熟作物仍可接受施肥。
growCrop 对成熟或不支持的方块返回 false;服务端拒绝状态写入时也返回 false。没有作物改变时,finish 不扣物品。原生多方块生长仍处于现有 ProtectionItemUseMixin 的玩家作用域中,由 ProtectionScope 检查目标写入。水下辅助方法收到物品堆副本,其内部扣减不会再次扣除真实物品堆。
不新增旧版生长配置、物品 NBT 或另一条骨粉催生路径。未注册肥料专用发射器行为。
扩展方式
仅在确有不同生长行为时增加等级,并同时维护注册、提示、商人报价及杂项模型生成。肥料没有合成配方;农民与园艺家的报价写在 .agents/skills/isekai-expansion-trade-authoring/scripts/generate_ktm2_trade_overrides.py 中,由它生成 trade_overrides/vanilla/farmer.json 与 trade_overrides/compat/villagersplus_horticulturist.json。继承 CropBlock 的植物自动采用自身的最大生长阶段。其他植物需实现 Fertilizable,才能进入秘法肥料的原生植物路径。
范围生长必须保留逐格权限检查。原生催生可能写入多个方块,因此应保留玩家保护作用域,不能只检查点击位置。
验证
运行 gradlew.bat compileJava 编译,并用 gradlew.bat generateMiscItemModels 重新生成杂项模型。在开发世界中检查未成熟与成熟作物、跨保护边界的混种田块、创造模式消耗、生长失败的树苗、水下植被及发射器内的骨粉。确认被拒绝的作物处理不消耗,整片田块处理只消耗一个物品。