Crop Sticks（作物 Stick）

基本信息

功能

Crop Sticks 是 CropsNH 的核心方块，负责承载作物生长。每个 Stick 上方可以种植一株作物，作物在该方块上进行生长、变异、收割。

种植与生长

• 种植：右键点击空 Stick，手持种子可种植（需要下方是注册的土壤方块）
• 生长 Tick：每 128 刻（TileEntityCropSticks.TICK_RATE）作物尝试生长一次
• 生长要素：作物需要光照、水分、化肥、土壤才能正常生长；缺水/缺肥会减速，杂草会降低产量
• 变异：两株相邻（同种类/不同种类）作物有机会在生长过程中触发 cross-breed，产生新种子

交互处理

BlockCropSticks 通过 onBlockActivated / onBlockClicked 将交互委托给 ICropStickTile：

// 右键：优先检查 ICropRightClickHandler（如 ItemCropRightClick）
// 再调用 crop.onRightClick(player, heldItem)
onBlockActivated → ICropRightClickHandler → ICropStickTile.onRightClick()

// 左键：优先检查 ICropLeftClickHandler（如 ItemSpadeNH 铲平）
// 再调用 crop.onLeftClick(player, heldItem)
onBlockClicked → ICropLeftClickHandler → ICropStickTile.onLeftClick()

收割与掉落

• 作物成熟后右键收割，掉落 getBreakItems()：包含 Stick 本身（不破坏）+ 作物掉落物
• 破坏 Stick 时若上有作物，也会触发收割逻辑并掉落

相邻方块变化检测

• onNeighborBlockChange 检测下方土壤是否被移除，若作物无法在新土壤上生长则转化为迁居者（Migrator）作物

渲染

• renderAsNormalBlock() = false，使用自定义 RenderCrop 渲染器
• 无碰撞箱（getCollisionBoundingBoxFromPool = null），允许实体通过

摆放要求

• 下方必须有注册的土壤：SoilRegistry.instance.isRegistered(blockBelow, metaBelow)
• 土壤类型变更时作物会转为 Migrator（杂草化）
• 不需要光照即可放置（但作物生长需要光照）

TileEntityCropSticks 关键方法

核心注册表

第三方集成