村民箱子整理器:一个箱子分类模组

村民箱子整理器:一个箱子分类模组

雇佣专职组织者,将物品从源容器搬运到带框架、带标签或备用存储中,并配备可配置的多人安全自动化功能。

你可以通过以下方式支持我 - https://ko-fi.com/knightmare61825

本模组添加了可雇佣的工人 NPC,它们会自动将物品从选定的源容器搬运到附近带有标签的存储容器中。无需搭建复杂的自动化流水线,你可以雇佣一名整理员(Organizer),将其分配到源箱子、木桶、潜影盒、漏斗或其他受支持的存储容器上,让它根据物品展示框、标签和后备规则对物品进行分类。

每名整理员都是一个专属的自定义实体,具有所有者、跟随模式、同步状态、真实的携带物品栏、可配置行为以及多人游戏安全的服务端逻辑。整理员可以在容器之间搬运物品、使用门、为铁门使用附近的按钮和拉杆、使用梯子、记住目的地,并在空闲时返回其源区域。

本模组设计为可在单人模式和多人模式下运行。

主要特性:

  • 使用可配置的货币物品和费用,从村民处雇佣一名整理员
  • 每名被雇佣的整理员都会获得一个唯一名称,如 Organizer 1、Organizer 2 等
  • 雇佣时会为该特定整理员创建一本绑定的署名书
  • 使用羽毛和绑定书来分配源容器
  • 支持通过物品展示框进行精确物品分类
  • 支持通过 [tag] 告示牌进行分组分类
  • 支持通过 [fallback] 告示牌设置后备存储
  • 使用真实的携带物品栏,而非虚假转移
  • 在整理员上方显示状态,如 Idle(空闲)、Walking to source(前往源容器)、To destination(前往目的地)、Carrying(搬运中)、Paused(暂停)、Blocked(受阻)或 Destination full(目的地已满)
  • 潜行右键切换跟随模式
  • 多人游戏中的所有权保护
  • 可选的团队访问权限
  • 区块安全行为:当所需区块未加载时暂停,而非破坏行为
  • 可配置的工作范围、携带数量、雇佣费用、货币物品、寻路失败上限和恢复行为
  • 首次游玩的玩家会收到一本游戏内指南书

雇佣方式 雇佣一名整理员:

  1. 手持一本书与笔
  2. 物品栏中拥有配置的雇佣物品
  3. 右键点击村民

默认情况下,雇佣费用为 20 个 minecraft:emerald。

雇佣时: 村民会被转换为整理员 它会获得一个唯一名称,如 Organizer 1 你的书与笔会变成该整理员的绑定署名书 那本书很重要,因为之后会用它来分配整理员的源容器。

如何分配源容器 分配源容器:

  1. 副手手持绑定好的整理员书
  2. 主手手持一根羽毛
  3. 右键点击源容器

支持的源容器包括:

  • 箱子
  • 大箱子
  • 木桶
  • 潜影盒
  • 漏斗
  • 许多暴露普通物品栏的模组容器

分配完成后,整理员会将那个容器作为它的取货点。

目的地分类机制:整理员会在源容器附近搜索容器,并根据标签决定物品应该前往何处。

共有 3 种目的地规则类型:

  1. 通过物品展示框进行精确物品匹配
  • 将物品展示框放在目的地容器上
  • 将物品放入展示框中
  • 该容器将只接受该精确物品 示例:带有小麦物品展示框的箱子只接受小麦
  1. 通过告示牌进行基于标签的分类
  • 将告示牌直接放在目的地容器旁边
  • 第一行必须是 [tag]
  • 第二行必须是有效的物品标签 ID 示例: [tag] minecraft:logs 该容器将接受 minecraft:logs 标签中的所有物品,即所有原木。
  1. 后备容器
  • 将告示牌直接放在容器旁边
  • 第一行必须是 [fallback] 示例: [fallback] 该容器用于存放不匹配任何精确物品展示框或 [tag] 规则的物品。

目的地优先级 整理员按以下顺序使用目的地:

  1. 精确物品展示框匹配
  2. [tag] 匹配
  3. [fallback]

*如果同一物品存在多个有效目的地,整理员会优先选择最满的匹配容器。

示例设置 示例存储室:

  • 源木桶装有混合物品
  • 带有小麦物品展示框的箱子用于存放小麦
  • 带有告示牌的的木桶: [tag] minecraft:logs 用于存放所有原木
  • 带有告示牌的箱子: [fallback] 用于存放任何不匹配的物品

结果: 小麦前往小麦箱子 橡木原木、白桦原木、云杉原木等前往原木木桶 其他所有物品前往后备箱子

整理员控制:

  • 右键点击整理员:显示其当前状态
  • 潜行右键点击整理员:切换跟随模式
  • 再次潜行右键点击:停止跟随模式,并在已分配源容器的情况下将其送回源容器
  • /organizer info :显示所有者、源容器、目标、状态、跟随模式、携带物品和扫描半径

寻路与移动 整理员被设计为可在真实基地中运作,而不仅仅是在平坦的测试世界中。 它们可以:

  • 在源容器和目的地容器之间行走(甚至能寻路到楼梯)
  • 打开普通门
  • 空闲时返回其源区域
  • 在区块未加载时安全暂停
  • 在路径反复失败时避免破坏其行为
  • 如果不存在有效目的地,它们会显示 Destination full(目的地已满),而不是无休止地游荡。

多人游戏特性 整理员在设计时考虑了多人游戏使用:

  • 每名整理员都属于某位玩家
  • 其他玩家无法使用或重新分配它,除非获得允许
  • 可在配置中启用可选的基于团队的访问权限
  • 重要的游戏逻辑在服务端执行并具有权威性
  • 同步状态可确保状态、所有者、源容器和跟随模式在多人游戏中可靠

首次加入指南书 玩家首次加入时,会收到一本游戏内成书指南,其中说明:

  • 如何雇佣整理员
  • 如何分配源容器
  • 物品展示框分类如何运作
  • [tag] 告示牌如何运作
  • [fallback] 如何运作
  • 如何控制整理员

配置 所有主要游戏设置均为服务端配置,位于: world/serverconfig/organizer-server.toml

当前配置选项: frameScanRadius 默认值:10 整理员从源容器搜索带标签目的地的距离

carryAmount 默认值:64 整理员每趟携带的最大物品数量

hiringCost 默认值:20 雇佣一名整理员所需的货币物品数量

hiringCurrencyItem 默认值:"minecraft:emerald" 用作雇佣货币的精确物品 ID 示例: hiringCurrencyItem = "minecraft:diamond" hiringCost = 5

maxWorkDistanceFromSource 默认值:32 整理员允许用于目的地的距源容器的最大距离

pathFailLimit 默认值:5 在整理员变为受阻之前允许的重复寻路失败次数

allowTeleportRecovery 默认值:true 如果为 false,则禁用基于传送的恢复

teleportToSourceOnPathFailure 默认值:false 如果为 true,整理员可能在反复寻路失败后传送回源容器

allowTeamAccess 默认值:false 如果为 true,所有者所在团队的玩家可以控制整理员

你可以通过以下方式支持我 - https://ko-fi.com/knightmare61825