铜傀儡职员
现招聘:储物管理员。 必须体型小巧、闪闪发亮,且擅长整理箱子。薪资为一个铜块和一颗南瓜。你的新职员会按照你的意愿进行整理:桦木原木与橡木原木归为一类,镐子与工具归为一类,无论告示牌上写着什么就按什么分类,它们触碰过的每一个箱子都会保持整洁。大约 50 个预置的物品组意味着只要你安装好插件,它们就能立即开始工作。
对于服务器所有者来说,这些职员很有礼貌:命令尊重 GriefPrevention 的领地声明,为领地所有者提供满箱提醒,每个领地可选设限傀儡数量,并且几乎所有功能都可以通过一个配置文件进行调整。它们从不要求加薪,也从不抱怨圆石。
我始终欢迎关于此插件的新想法。请在 GitHub 上提交增强请求:
本插件将在 GitHub 上维护,最新版本将通过 Hangar 提供。请前往查看最新版本。
你的傀儡学会了什么
📦 按种类分类,而不仅仅是精确物品
携带云杉木板的傀儡会使用你的橡木木板箱。炖菜归入食物,剑归入武器,所有颜色的羊毛放在一起。分组是配置文件中简单的列表,因此你可以修改它们或创建自己的分组。
🏷️ 读取告示牌和物品展示框
在箱子的告示牌上写上 [logs]、[ores]、[oak log]、[*_ORE] 或 [#planks],或者在展示框中挂上一个物品,那么该物品就会存入此处。当多个箱子都可以接收某物品时,最具体的规则优先:对于一碗炖菜,[stews] 的优先级高于 [food]。
| 告示牌 | 含义 |
|---|---|
[logs] |
日志组中的任何物品 |
[oak log] |
仅橡木原木 |
[*_ORE] |
所有矿石方块 |
[#planks] |
Minecraft 物品标签中的所有物品 |
[Overflow] |
没有归属地的物品的兜底箱 |
[No Golems] |
傀儡不得进入 |
[Only Logs] |
在铜箱上:傀儡只取出其中的原木 |
♻️ 自动清空的溢出箱
没有归属地的物品会落入你的 [Overflow] 箱中。稍后为其添加一个箱子,空闲的傀儡会自动将它们搬运过去。
🗄️ 更大的储物空间
- 整理有序:合并部分堆叠,同类物品保持在一起。
- 互相避让:在一格宽的过道中侧身让路,而不是卡住。
- 可选功能(通过设置开启):
- 可触及最高 6 层 高的堆叠箱子(原版:2 层);
- 每次行程可携带最多 64 个物品(原版:16 个);
- 使用 桶和潜影盒 以及箱子。
🦺 自我照顾
- 掉进竖井或走远的傀儡会 自行回家;被困住的傀儡会被报告其位置。
- 傀儡 避开活板门 并 远离传送门。
- 每个铜傀儡的死亡原因都会记录到服务器日志中,以便你查看失踪傀儡的情况。
玩家用法
/cgc find diamond: 列出你附近存放钻石的箱子,最近的排在前面(包括潜影盒内的钻石),最近的几个箱子会发光几秒。默认情况下,它只搜索你自己的 GriefPrevention 领地,因此没人能利用它来窥探他人。/cgc check解释一个你可以打开的箱子,/cgc overflow显示溢出箱中堆积的物品,/cgc stats显示你的领地内傀儡已整理的物品统计。- 手持竹子 可在每个傀儡头顶看到标签,显示其当前状态(如“携带 16 根桦木原木”、“获取花岗岩”、“迷路,正在回家”)及其风化程度。
- 用竹子右键点击傀儡 可将该傀儡切换回原版排序模式。
- 在 GriefPrevention 领地中,当其中一个标有标签的箱子装满时,你会收到通知(即使当时你离线),并在你离开期间获得傀儡整理工作的摘要。
管理员用法
/cgc check解释任意箱子:其标签的含义、接收的物品类型,以及阻止傀儡使用的任何因素。/cgc overflow列出溢出箱中的内容,并为每个物品提供归属标签建议。/cgc golems显示傀儡的位置、携带的物品以及是否有傀儡迷路。/cgc stats显示服务器范围内傀儡已整理的物品总量。- 玩家只能查看他们可以自行打开的内容;管理员可以查看每个领地的内容。
- 可选的傀儡限制上限规定了单个领地中可使用此插件的傀儡数量(默认关闭)。
- 该插件不会增加可测量的刻时间:有无该插件时,一个工作的铜傀儡每刻消耗约 0.1 毫秒(在多达 200 个傀儡的情况下测量得出)。
- 几乎所有功能都可以在
config.yml中关闭或调整,并通过/cgc reload应用更改而无需重启。 - 仅影响铜傀儡。铁傀儡、雪傀儡、村民和其他生物不受影响。
入门指南
- 将 jar 文件放入
plugins/目录并重启服务器。 - 放置一个铜箱并填入混合物品。
- 在水平 32 格以内、上下 8 格以内的范围内放置一些箱子。在每个箱子中放入一件物品以指示用途,或添加类似
[logs]的告示牌。 - 在铜箱旁建造一个铜傀儡(铜块上放置一个雕刻南瓜)。
- 留在附近(傀儡仅在加载的区块中工作),观察它们整理所有物品。
要求
- Paper 26.3,构建版本 190 或更高(不支持 Spigot 和 Bukkit:插件使用了 Paper 的傀儡事件)
- Java 25
- 推荐:GriefPrevention。启用后,提醒将发送给领地所有者,玩家的命令仅限于其自身领地,且只有在该处拥有建筑权限的玩家才能控制那里的傀儡。未启用时,提醒将发送给 OP,且玩家在管理员允许之前无法使用
/cgc find查找任何内容。
权限
所有权限均为标准节点,因此可与 LuckPerms 或其他任何权限插件配合使用。
| 权限 | 默认值 | 允许操作 |
|---|---|---|
coppergolemclerk.find, .check, .overflow, .stats |
所有人 | 玩家命令,限制于其自身领地或可访问的范围 |
coppergolemclerk.golems |
所有人 | /cgc golems(仅针对自己的傀儡),如果服务器启用此功能 |
coppergolemclerk.toggle |
所有人 | 将傀儡切换为原版并返回 |
coppergolemclerk.allclaims |
op | 上述命令可查看每个领地的信息 |
coppergolemclerk.alerts |
op | 关于超出任何领地范围的警报,即没有所有者可以通知的情况 |
coppergolemclerk.admin |
op | 所有 /cgc 命令 |
链接
- 完整文档与所有设置:GitHub 上的 README
- 更新日志:CHANGELOG.md
- Bug 报告与建议:GitHub Issues
- 许可证:GPL-3.0,源代码在 GitHub
Copper Golem Clerk
Now hiring: storage clerks. Must be small, shiny and good with chests. Pay is one copper block and a pumpkin. Your new clerks sort the way you would: birch logs in with the oak logs, pickaxes with the tools, whatever your signs say where they say it, and every chest they touch left tidy. About 50 ready-made item groups mean they start work the moment you drop the plugin in.
For server owners, the clerks come with good manners: commands that respect GriefPrevention claims, full-chest alerts for claim owners, optional golem limits per claim, and nearly every feature tunable in one config file. They never ask for a raise and never complain about the cobblestone.
I'm always open to new ideas for this plugin. Open an enhancement request on GitHub:
This plugin will be maintained on GitHub and newest releases will be provided through Hangar. Please check there for latest releases.
What your golems learn
📦 Sort by kind, not just by exact item
A golem carrying spruce planks uses your chest of oak planks. Stews go with the food, swords with the weapons, every colour of wool together. Groups are plain lists in the config, so you can change them or make your own.
🏷️ Read signs and item frames
Write [logs], [ores], [oak log], [*_ORE] or [#planks] on a sign on a chest, or
hang an item in a frame, and that's what goes there. When several chests would take an
item, the most specific one wins: [stews] beats [food] for a bowl of stew.
| Sign | Means |
|---|---|
[logs] |
anything in the logs group |
[oak log] |
just oak logs |
[*_ORE] |
every ore block |
[#planks] |
everything in a Minecraft item tag |
[Overflow] |
a catch-all for things with no home |
[No Golems] |
golems keep out |
[Only Logs] |
on a copper chest: golems take only the logs out |
♻️ An overflow chest that empties itself
Items with no home land in your [Overflow] chest. Add a chest for them later and idle
golems carry them over by themselves.
🗄️ Bigger storage rooms
- Tidy as they go: partial stacks merged, like items kept together.
- Step aside for each other in one-wide aisles instead of getting stuck.
- Optional, with a setting:
- reach chests stacked up to 6 high (vanilla: 2);
- carry up to 64 items a trip (vanilla: 16);
- use barrels and shulker boxes as well as chests.
🦺 Look after themselves
- A golem that falls down a shaft or wanders off walks back home; one that's stuck gets reported, with where it is.
- Golems keep off trapdoors and stay out of portals.
- Every copper golem death is written to the server log with its cause, so you can see what happened to a golem that went missing.
For players
/cgc find diamond: lists the chests near you that hold diamonds, nearest first (including diamonds inside shulker boxes), and the nearest few glow for a few seconds. By default it only looks in your own GriefPrevention claims, so nobody can use it to snoop./cgc checkexplains a chest you can open,/cgc overflowshows what's piling up in your overflow chests, and/cgc statsshows what golems have sorted in your claims.- Hold bamboo to see a label over each golem saying what it's doing ("carrying 16 birch log", "fetching granite", "lost, walking home") and how weathered it is.
- Right-click a golem with bamboo to switch that one golem back to plain vanilla sorting.
- In a GriefPrevention claim you get told when one of your labelled chests is full (even if you were offline at the time), and get a summary of what your golems sorted while you were away.
For admins
/cgc checkexplains any chest: what its labels mean, what it takes, and anything stopping golems from using it./cgc overflowlists what's in overflow chests and what label would give each item a home./cgc golemsshows where the golems are, what they're carrying and whether any are lost./cgc statsshows how much the golems have sorted, server-wide.- Players only see what they could open themselves; admins can see into every claim.
- Optional golem limits cap how many golems in one claim use the plugin (off by default).
- The plugin adds no measurable tick time: a working copper golem costs about 0.1 ms per tick with or without it (measured with up to 200 golems).
- Nearly every feature can be switched off or tuned in
config.yml, and/cgc reloadapplies changes without a restart. - Only copper golems are affected. Iron and snow golems, villagers and other mobs are left alone.
Getting started
- Drop the jar into
plugins/and restart. - Place a copper chest and fill it with mixed items.
- Place some chests within 32 blocks sideways and 8 up or down. Put one item in each to say
what it's for, or add a sign such as
[logs]. - Build a copper golem (a carved pumpkin on a copper block) next to the copper chest.
- Stay nearby (golems only work in loaded chunks) and watch them file everything.
Requirements
- Paper 26.3, build 190 or newer (Spigot and Bukkit aren't supported: the plugin uses Paper's golem events)
- Java 25
- Recommended: GriefPrevention. Alerts then go to the claim's owner, players' commands
stay within their own claims, and only players who may build somewhere can switch golems
there. Without it, alerts go to ops, and players'
/cgc findfinds nothing until an admin allows it.
Permissions
All permissions are standard nodes, so they work with LuckPerms or any other permissions plugin.
| Permission | Default | Allows |
|---|---|---|
coppergolemclerk.find, .check, .overflow, .stats |
everyone | the player commands, limited to their own claims or what they could open |
coppergolemclerk.golems |
everyone | /cgc golems for their own golems, if the server turns it on |
coppergolemclerk.toggle |
everyone | switching a golem to vanilla and back |
coppergolemclerk.allclaims |
op | the commands above see into every claim |
coppergolemclerk.alerts |
op | alerts about things outside any claim, where there's no owner to tell |
coppergolemclerk.admin |
op | all /cgc commands |
Links
- Full documentation and every setting: README on GitHub
- Changelog: CHANGELOG.md
- Bugs and ideas: GitHub issues
- Licence: GPL-3.0, source on GitHub
下载 Copper Golem Clerk
下载 Copper Golem Clerk
更新日志
所有版本均基于 Paper 26.3 (Java 25)。2.6.0 及更高版本需要 Paper 26.3 build 190 或更高版本。2.0 之前的版本名为 SmartCopperGolems。
要升级,请将 plugins/ 目录下的旧版 SmartCopperGolems-*.jar 替换为新版本并重启服务器。你的 config.yml 配置会被保留。从 3.0.0 版本开始,新版本中新增的设置会在启动时自动添加到配置文件中,并附带说明;同时会更新你已存在设置的说明。在 3.0.0 之前,新设置会使用默认值,直到你手动将其添加到配置文件中为止。
tools/ 目录中开发者工具的更改(测试和脚本,不属于插件本身)请参阅 tools/CHANGELOG.md。
3.2.0 (2026-11-10)
新增
- 群组可以拥有其他名称。在
config.yml的group-aliases下添加它们,格式为alias: group(例如mechanisms: redstone)或alias: [group, group]。告示牌、[Only ...]过滤器或/cgc find命令中使用别名即指代该群组。群组自身的名称始终优先,控制台会对无法使用的别名发出警告。默认为空。升级时会添加group-aliases: {}。 /cgc find <item> [radius]和/cgc golems [radius]支持可选的搜索半径。从控制台使用时,请使用/cgc find <item> <x> <y> <z> [world] [radius]和/cgc golems <x> <y> <z> [world] [radius]。/cgc find birch log 50会在你周围 50 格范围内进行搜索。它仅搜索已加载的区块,并提示范围内有多少个区块未加载。/cgc golems 50列出 50 格范围内的傀儡,按距离由近到远排序。与 find 类似,它是沿每个轴向计算的。标题显示“within 50 blocks”(50 格范围内)。- 以数字结尾的物品名称是该名称的一部分。
/cgc find music disc 13指的是唱片。/cgc find music disc 13 50指的是 50 格范围内的该唱片。 - 如果不指定半径,两者行为如前所述。半径最大不能超过 30,000,000。
find-max-radius(默认 64,范围 1 至 128)是玩家请求/cgc find时允许的最大值。如果输入更大数值,会被截断至此最大值,并附有提示。它永远不会低于find-radius。管理员 (coppergolemclerk.allclaims) 和控制台不受此限制。/cgc golems也不受限制。/cgc check和/cgc label现在会告知傀儡会将物品送入更特定的箱子。规则保持不变:覆盖物品种类最少的告示牌标签优先级最高,因此对于铜锭,[ingots and gems]优于[*copper*]。现在命令会告诉你这一点。- 手持物品执行
/cgc check会显示哪个箱子胜出、其位置,以及建议在该箱子的告示牌上添加[copper ingot]以将物品留在此处。如果该箱子恰好标记了该物品,它会建议移除该标签。 /cgc label以及/cgc check末尾的标签建议,会列出进入该箱子但应送往更特定箱子的物品。最多显示 5 行,然后显示 "... and N more"。对于未标记的箱子,它会检查它建议的标签。- “附近”指水平方向在
search-distance内,垂直方向上下 8 格内。锁定、堵塞、已满和漏斗喂给的箱子不计入,这与傀儡选择时的逻辑一致。
- 手持物品执行
更改
- 傀儡会在返回分拣之前先从熔炉中取出成品。以前,傀儡会先分拣所有铜箱子,导致在仍有分拣任务时,熟食等物品停留在熔炉中。现在取出物品成为熔炉维护的一部分,并计入
furnace-jobs-before-sorting,因此繁忙的铜箱子仍会得到分拣。furnace-take-out-at仍然决定何时值得去一趟熔炉。 - 傀儡的家现在是它上次获得工作的地方,而不仅仅是它最后取物的铜箱子。丢失的傀儡救援功能会使用此信息。
- 家是它从中取物的铜箱子、它从中获取物品的
[Overflow]箱子、它从中取物的[Furnace Supply]或[Fuel]容器,或它从中取出成品(或空 lava bucket)的熔炉。仅向其投递物品的箱子永远不会成为家。 - 当没有任何工作场所(铜箱子、熔炉、烟熏炉、高炉、
[Overflow]、[Fuel]或[Furnace Supply]容器)在其范围内,且其家超过 40 格远(上下 12 格)时,傀儡被视为丢失。警报会命名该家(“its furnace”,“its [Overflow] chest”)。铜箱子仍显示“its copper chest”。 - 如果家不再作为工作场所(损坏、告示牌被移除),傀儡会忘记它。
- 没有家的傀儡会将范围内最近的工作场所设为家。如果范围内没有,它会走向 64 格内(上下 12 格)最近的一个。如果 64 格内也没有,则像原版一样被忽略,直到出现一个工作场所。
- 家是它从中取物的铜箱子、它从中获取物品的
- 问候访问仍保持在傀儡的工作区域附近。空闲的铜傀儡只会访问其家(如果在
search-distance范围内)16 格内的铁傀儡或雪傀儡,否则是其最近的铜箱子或熔炉 16 格内的,否则是它站立位置 16 格内的。如果它偏离该位置超过 20 格,它会折返。- 如果它在 20 秒内无法到达可达范围,或者在 8 秒内没有更接近目标,或者另一个傀儡无法再被触及,或者那个傀儡死亡或消失,它就会放弃。如果发现工作,访问会立即结束。
- 没有打招呼就结束的访问会让傀儡走回其铜箱子或熔炉旁边的位置,最多持续 15 秒。如果发现工作,则会停止。
- 启用
debug: true时,每个没有打招呼就结束的访问都会记录原因(“stopped going to say hello: ...”)。
- 现在,每当插件为傀儡移动物品时,傀儡会短暂打开箱子、桶或潜影盒的盖子。这包括:
- 从
[Overflow]箱子取物 - 从
[Fuel]或[Furnace Supply]容器中取物或放入物品 - 将没有家的物品放回其铜箱子
- 为
carry-amount从铜箱子取更多物品,如同原版傀儡所做的那样
- 从
此前,物品在拾取音效中移动,但箱盖保持关闭状态,因此看起来仿佛没有任何东西接触过箱子。关闭箱盖永远不会加载区块。
- 默认分组已整理:
decorations(装饰)拆分为signs(告示牌)、banners(旗帜,含旗帜图案)、pottery(陶器,含碎片和装饰花盆)以及beds(床)。decorations(装饰)保留架子、靠垫、铜傀儡雕像、物品展示框、画作、盔甲架、书架和花盆。- 生物头颅与骷髅头移至
rare-items(稀有物品)。 utility-blocks(实用方块)合并至workstations(工作台/工作站,共 22 个物品)。- 樱桃树叶、开花杜鹃花叶和红树幼苗从
flowers(花朵)移至foliage(植被)。 - 紫颂花从
flowers(花朵)移至end(末地)。 - 命名牌从
tools(工具)移至animal-gear(动物装备)。 stone(石头,共 81 个物品)拆分为stone(47 个)、deepslate(深板岩,20 个)和tuff(凝灰岩,14 个),以便每个都能放入一个双层箱子。[deepslate]告示牌现在指代不含深板岩矿石的深板岩组。此前,它会匹配名称中包含“deepslate”的所有物品。- 创造模式专属物品不再属于任何分组:萌芽紫水晶、受感染的圆石和苔石砖、命令方块矿车、知识之书,以及铜傀儡、铁傀儡和雪傀儡的生成蛋。
- 现有服务器保留其原有分组。升级不会重写
groups:字段,如需新分组,请从默认的config.yml中复制它们。 [utility blocks]在新配置下仍有效(它会找到workstations)。[workstations]在旧配置下有效。
- 基于最新的 Paper API(26.3 build 244)构建。它仍可在 build 190 及更高版本上运行。
修复
- 当漏斗矿车位于熔炉下方时,傀儡会忽略熔炉的输出物,正如它们对漏斗所做的那样。它们在到达熔炉时会再次检查,因此即使是在傀儡前往途中放置的漏斗也会被尊重。
3.1.0 (2026-11-05)
新增
-
傀儡在分拣之前先照料熔炉。此前,只有在没有可分拣物品时,傀儡才会照料熔炉。现在空闲的傀儡按以下顺序选择下一个任务:
- 1. 熔炉维护:处理因输出已满而停止工作的空熔炉,取出空的岩浆桶,添加燃料,并从
[Furnace Supply](熔炉补给)运送待烹饪的物品。 - 2. 分拣铜箱中的物品。
- 3. 从熔炉中取出成品物品。
- 4. 重新分拣
[Overflow](溢出)箱中的物品。
只要铜箱中有物品,
furnace-jobs-before-sorting(默认值 3)就设定傀儡在一次分拣操作之前连续执行多少次熔炉工作。将其设置为 0 可恢复旧的行为顺序。 - 1. 熔炉维护:处理因输出已满而停止工作的空熔炉,取出空的岩浆桶,添加燃料,并从
-
如果单行无法容纳的告示牌标签可以延续到下一行。保持
[打开,并在后续行用]关闭:[Only light/sources]等同于[Only light sources]。- 行之间以空格连接,或在
-或_之后无空格连接。 - 此前,标签必须适应单行长度,因此某些分组名称和大多数
[Only <group>]过滤器无法写入。 /cgc check会指出未闭合的标签。/cgc label和/cgc overflow说明如何编写过宽的标签。
- 行之间以空格连接,或在
-
README 列出了默认分组及其告示牌标签和内容。
-
对箱子执行
/cgc check现在会以告示牌标签建议结尾,与/cgc label相同。- 未标记的箱子:列出其中的物品标签(最具体的优先)以及无法放入的物品。
- 已标记的箱子:列出标签未覆盖的任何内容,以及能覆盖这些内容的标签。
- 空箱子:提供手中物品对应的标签。
[Overflow](溢出)、[Fuel](燃料)、[Furnace Supply](熔炉补给)和铜箱不提供此类建议。- 对已标记的箱子使用
/cgc label现在也会为其标签未覆盖的内容建议一个标签。
-
search-distance(默认 32,即原版范围,最大 128)设定傀儡向各个方向搜索箱子、铜箱、[Overflow]箱和熔炉的距离(以区块为单位)。超过 32 后,插件会将傀儡引导至原版傀儡看不见的箱子并为其搬运物品。它还允许它们的寻路路径达到该距离,并为更长的行走路径提供更多放弃前的时间。 -
claim-blocks-per-extra-golem(默认 0,关闭)为更大的领地分配更多傀儡。对于每达到此数量的领地区块,领地获得的傀儡数量比max-golems-per-claim多一个。例如,当max-golems-per-claim为 5 且此设置值为 2500 时,9×9 的领地获得 5 个傀儡,而 100×100 的领地获得 9 个。
已更改
/cgc check在[Overflow](溢出)箱子上的提示现在指向/cgc overflow。/cgc overflow和/cgc storage的消息和帮助信息中的范围现在遵循search-distance(搜索距离),而不再始终显示为 32 格。- 四个默认组的名称变短,以便其告示牌标签能在一行内显示。
smithing-templates现在改为templates。crafting-materials现在改为materials。saplings-and-leaves现在改为foliage。concrete-and-terracotta拆分为concrete(方块、粉末、台阶和楼梯)和terracotta(普通、染色和烧制陶瓦)。- 旧名称和新名称在告示牌上均可使用,取决于你的
config.yml配置。升级不会更改你的groups:设置,因此[foliage]会匹配旧配置中的saplings-and-leaves,而[concrete and terracotta]会同时匹配这两个新组。 - 当傀儡根据内容物匹配箱子时,混凝土和陶瓦不再被视为一个组。
[Terracotta]告示牌现在也接受烧制陶瓦。此前,它仅接受普通和染色陶瓦。- 当存在较短名称时,
/cgc label和/cgc overflow会在旧配置中建议该短名称。
- 插件派遣傀儡执行的行走任务(前往熔炉、补给点、远距离或高处箱子、溢出箱子)不再受限于固定的约 30 秒时间。
- 如果傀儡在直线路径或既定路径上连续 10 秒没有更接近目标,它将放弃任务。卡住的傀儡会更早离开,而行动缓慢的傀儡(受到缓慢效果影响、走在灵魂沙上、人群拥挤等)仍能到达目的地。
- 对于永远无法到达目的地的行走任务,会根据
search-distance动态增长的时间限制将其终止:32 格时为 81 秒,64 格时为 132 秒,128 格时为 235 秒。
- 傀儡尝试运送物品的持续时间现在由行走任务决定,而非特定设置。
- 每个备用步骤(最佳箱子、任意匹配箱子、
[Overflow]或空箱子)的持续时间等于走到它所尝试的最远箱子的步行时间,且至少为 30 秒。较大的search-distance会自动延长这些步骤。 - 如果没有新的可尝试选项,该步骤将被跳过。如果在范围内没有合适的归属位置,物品将在 30 秒的原生步骤后放回,而不是两分钟后。
matching-chest-timeout-seconds已被移除。升级时它会从config.yml中删除,控制台会说明原因。
- 每个备用步骤(最佳箱子、任意匹配箱子、
- 添加或更改告示牌或物品框标签会清除
search-distance范围内所有箱子的“无归属”标记。傀儡会立即重新尝试那些物品,而不是等待homeless-retry-minutes设定的时间。 max-golems-outside-claims已被移除,未受保护土地上的傀儡不再受限。此前,该设置将所有未受保护的土地共享一个上限,优先处理最老的傀儡。这可能导致一名玩家的傀儡使另一名玩家的傀儡像原版一样进行整理,且没有任何解释。随着玩家的进出,傀儡还会在这两种状态间切换。升级时该设置会从config.yml中删除,控制台会说明原因。max-golems-per-claim保持不变。- 关于更新
config.yml的控制台消息现在链接到 GitHub 上对应版本的config.yml,而不是指向 JAR 包内部。 - 基于最新的 Paper API(26.3 build 238)构建。每个版本还检查插件是否能针对 build 190 的 API 编译,以确保它在从 190 开始的所有版本上都能正常运行。
已修复
- 傀儡寻找熔岩桶的范围与熔炉和箱子一致:横向
search-distance,上下各 8 格。此前,横向始终为 16 格,上下各 4 格。当search-distance为 64 时,傀儡可能会照料 50 格外的熔炉,但绝不会去 20 格外的桶加水。你放置的桶会在 5 秒内被使用。 - 执行熔炉任务的傀儡不再在长距离行走中途将物品放回铜箱。前往远处桶的空桶或前往远处熔炉的燃料没有自己的箱子。在经过 30 秒的寻找步骤后,傀儡会将物品退回并重新开始。
- 执行熔炉任务的傀儡不再通过墙壁或地板使用熔炉、
[Fuel](燃料)、[Furnace Supply](熔炉补给)或桶。此前,一旦傀儡在直线上距离目标 2.5 格以内,即被视为“到达”,从而允许其透过墙壁或地板存取物品。现在,傀儡必须站在旁边且前方有开放空间的位置,如同对待箱子一样。 - 当
deliver-reach(投递范围)大于 3 时,傀儡现在可以喂养第 4 至 6 排的熔炉(并使用[Fuel]和[Furnace Supply]容器)。此前,它们会走到堆叠底部,因无法触及目标方块而放弃。 - 当
furnace-jobs-before-sorting(排序前熔炉任务数)较低(尤其是设为 1)且有一个持续接收物品的铜箱时,傀儡几乎完全停止照料熔炉。一个被释放去整理的傀儡在插件看来处于空闲状态,随即获得熔炉任务,然后在铜箱处拾取负载,这会无声地结束该任务。现在,被释放去整理的傀儡直到拾取负载或经过 15 秒之前,不会获得熔炉任务。 - 超过
max-golems-per-claim限制的傀儡现在会立即失去插件的路径设置(包括针对search-distance的更长路径以及avoid-trapdoors避免陷阱门)。当数量低于限制时,它们会重新获得这些设置。此前,这需要等待下一次重载或傀儡所在区块重新加载。 - 前往
[Overflow](溢出)箱子的傀儡现在会在途中检查物品是否仍有归属。如果该箱子已满、被移除或被重新标记,傀儡将停止行动而不取走任何物品,而不是直接将物品带回。 - 当提高
deliver-reach(投递范围)或take-reach(提取范围)时,紧贴山坡或其他墙壁建造的箱子墙的最顶排物品从未被获取,而是被送往[Overflow](溢出)。墙壁后方与顶层箱子齐平的地面被视为站立位置,使得这些箱子看起来可达。原版傀儡无法从正前方的地面打开这些箱子。现在,只有傀儡能够走到的位置才算有效,并将傀儡引导至该位置。对此类箱子执行/cgc check现在会提示傀儡无法走到与其齐平的位置,并说明该位置比傀儡使用的地面高出多少排。此前,它不会报告任何问题。
3.0.0 (2026-11-02)
“熔炉已苏醒。”傀儡现在会为你运行熔炉:投料、添加燃料并清空成品。升级时,你的 config.yml 也会自动更新所有新设置及其说明。
新增
- 升级会使你的
config.yml保持最新。- 启动时,新版本拥有但当前文件缺失的设置会被添加进来,包含默认值和注释,位置与全新配置文件一致。
- 你已有的每个设置上方的注释会被替换为新的说明。
- 你的数值永远不会被更改,设置行末尾的备注会保留。
- 旧文件会保存为
config-before-<version>.yml。控制台会列出新增的内容以及哪些说明发生了变更。 - 存在 YAML 错误的
config.yml不会被修改。如果无法写入文件,控制台会显示清晰的警告,新设置将使用其默认值。
- 傀儡可运行你的熔炉(
furnace-feeding,默认开启)。像给箱子贴标签一样给熔炉、 smoker(烟熏炉)或高炉贴标签(例如[raw iron]),傀儡便会持续为其供料。- 待烧炼的物品仅来自标记为
[Furnace Supply]的容器。每次装载量会在所有接受该物品的已标记熔炉之间分配。 - 傀儡只取熔炉有空余格子的物品。当熔炉余量不足时(
furnace-refill-below,默认 16),傀儡会进行补满。 - 一次装载最多分给 2 个熔炉,每份至少 8 个物品(
furnace-split-min),优先分配给剩余空间最多的熔炉。 - 傀儡绝不会向另一个傀儡正在处理的熔炉运送装载物或燃料。
- 如果在途中熔炉已满,傀儡会等待空位(
furnace-wait-seconds,默认 20 秒)。未能放入的物品会退回供应容器,而不是被分拣走。 - 燃料仅来自标记为
[Fuel]或[Fuels]的容器(furnace-fuel)。默认顺序为木炭、煤炭,然后是 lava bucket(岩浆桶)。 - 岩浆桶仅在熔炉积压物品达到 100 或以上时使用(
furnace-lava-min-items),且前提是还有其他可用燃料。一个岩浆桶可供燃烧 100 个物品,即使没有待烧炼物品,点燃的熔炉也会将其燃尽。积压数量包括等待中的物品、运输途中的物品以及匹配[Furnace Supply]容器的份额。 - 空桶会在岩浆盆处重新灌满。如果滴落的岩浆使岩浆盆恢复满溢状态,空桶会在
[Fuel]容器中等待直至盆满。随后空闲的傀儡会灌满一个并放回原处。 - 傀儡提供的燃料量足以处理当前积压物品再加上额外 16 个物品(
furnace-fuel-ahead),这样下一批装载物就不需要专门运送燃料了。傀儡无法放入熔炉的燃料会退回[Fuel]容器。 - 当有 8 件成品就绪(
furnace-take-out-at)或熔炉停止工作时,傀儡会取出成品。这包括因输出槽卡住而无法点火的熔炉。除非熔炉下方的漏斗收集了成品,否则傀儡会对取出的物品进行分拣;若范围内没有任何容器能接收这些物品,则不进行分拣。 - 紧急任务优先执行:输出槽已满 > 添加燃料 > 投放待烧炼物品 > 取出成品。
- 若傀儡找不到通往熔炉或容器的路径,会在 10 秒后重试。若行走 30 秒仍未到达,则会等待一分钟。
- 位于通向熔炉的漏斗上的箱子(手工建造的熔炼炉的输出箱)永远不会用于分拣。
- 启用 GriefPrevention 时,傀儡仅使用其铜箱所属领地内的熔炉和容器,或其所有者拥有容器信任权限的区域(
furnace-trusted-claims)。 - 对熔炉执行
/cgc check可查看傀儡将采取的操作及原因。 - 告示牌拼写(不区分大小写):
[Fuel]、[Fuels]、[Furnace Supply]、[Furnace Supplies]、[Furnaces Supply]。单词间可用连字符或下划线连接,如[Furnace-Supply]。
- 待烧炼的物品仅来自标记为
- 由漏斗填充的溢出箱(熔炼炉的输出箱)清空频率降低。傀儡仅在积累到 8 个相同物品时(
overflow-fetch-min)或等待 2 分钟(overflow-fetch-wait-seconds)才会搬运。此前,每产生一个锭就会搬运一次。没有漏斗喂养的溢出箱仍会立即清空。/cgc overflow命令可查看漏斗何时填满该箱子。 config.yml中的每个设置现在都在其上方拥有独立的说明。以前共用同一说明的设置(如find-*和max-golems-*设置)现各自拥有独立说明。通过升级添加的新设置始终附带其注释。/cgc label会根据你所查看箱子内的物品,建议一个告示牌标签。它会建议物品自身的标签、其所属的最具体分组,或是大多数物品归属且少数物品也符合的分组。对于已贴标签的箱子,它会提示是否所有物品都匹配。此功能仅提供建议,告示牌需玩家自行放置。玩家可为其可打开的容器获取建议(权限节点coppergolemclerk.label,默认所有人可用)。/cgc storage按标签(或按内容针对未贴标签的箱子)显示周围存储空间的占用情况,从最满的开始排列。已满和接近满的箱子会被标记。它还会列出[Overflow]箱子、剩余的空箱以及铜箱中等待处理的物品。玩家只能看到其可打开的容器(权限节点coppergolemclerk.storage,默认所有人可用)。
已更改
- 从
[Overflow](溢出)箱子获取物品的傀儡现在可以跨多个堆叠,最多取carry-amount数量的物品。以前它们只取第一个堆叠:例如在一个装有 3 + 5 个锭的箱子中,之前只会取走前 3 个。 config.yml和 README 现在完整解释了debug(记录插件所做的每一个决策;不会改变傀儡的任何行为)和trace-golems(记录频率)。- 构建检查确保每个设置都在
config.yml中有对应的注释、在 README 的设置参考中有说明,并且对于自本更新日志开始以来新增的设置,也在 CHANGELOG 中有记录。README 中的“添加设置”部分列出了具体步骤。 - 文档说明了在告示牌上使用
*、#和@的作用,并附有示例。*表示物品名称中的任意字母:[*sand]、[sand*],以及用于所有物品的[*]。#表示 Minecraft 物品标签:[#logs]。@表示特殊组:[@fuel]。- 在箱子上使用
[*]时,其优先级高于[Overflow]。
- Hangar 页面的文本已从
docs/hangar.md移至docs/FullDescription.md。 - Hangar 页面为每个部分添加了图标,并在标题旁增加了像素艺术风格的铜傀儡图片 (
docs/copper-golem.png)。
已修复
max-golems-per-claim现在按每个领地单独计算,正如文档所述。以前它会将同一所有者名下所有领地的数量累加。管理领地中的傀儡曾被视为无主土地(计入max-golems-outside-claims)。现在管理领地也有自己的独立限制。/cgc golems不再将刚在被卸载区块前杀死的傀儡列为“未加载”状态(例如先执行/kill,然后所有人离开)。以前这类傀儡会在列表中保留 30 天,并存在于golems.yml中。
2.6.2 (2026-10-31)
已更改
/cgc find torch仍然只查找火把。现在它会增加一行“附近还有”,列出名称中包含该词的其他 nearby 物品(如铜火把、灵魂火把……),并建议执行/cgc find *torch*以查找所有相关物品。/cgc help find、README 和 Hangar 页面也作了相应说明。如果搜索已通过名称、模式、标签或组匹配成功,则不会给出提示。- README 和 Hangar 页面:“玩家命令”列表现在为玩家命令的每一条分配单独一行(
find、check、overflow、stats、golems(如允许)、help)。README 新增了类似 Hangar 页面的“管理员命令”列表。两者均提供负载测试结果:每刻每个傀儡约 0.1 ms,与原版一致。
已修复
- “在你离开期间,傀儡整理了 N 件物品”这条消息错误地统计了你在在线期间整理的物品。它使用了你离开的整整一小时的数据。服务器停止或重启时从未正确记录你的离线时间,因为 Paper 会在插件停止后才断开玩家连接,导致你下次登录时计入了自上次真正登出以来的所有内容。现在插件会在你离开或服务器停止时记录运行计数,并仅报告此后整理的物品。最后见于旧版本下的玩家在下次登录时将看不到计数,而不是显示错误的计数。
2.6.1 (2026-10-30)
已修复
- 在早于 190 版本的 Paper 26.3 构建上(即 Paper 尚未添加傀儡整理事件之前),插件现在会记录需要 190 或更高版本,并自行禁用。以前它会保持启用状态但缺少整理功能,导致傀儡像原版一样进行整理,而其他功能仍正常运行。Paper 会记录错误信息:“Failed to register events for class SortListener”。
已更改
- README、Hangar 页面和 CHANGELOG 现在明确说明所需的 Paper 构建版本:26.3 build 190 或更高版本。
2.6.0 (2026-10-30)
新增
/cgc golems查找你的铜傀儡:最近的 10 个,或者使用all列出每一个。每个条目显示其位置(管理员可以点击传送)、距离和方向、携带的物品、铜锈状态及其模式。未加载区块中的傀儡会列出它们上次被看到的位置。- 丢失的傀儡能找到回家的路。一个傀儡会记住它最后一次从中取物的铜箱子。如果它离任何铜箱子都很远(超过 40 格,或上下偏移超过 12 格),它会走回去。
- 无法回家或被困在坑里的傀儡,会通过警报通知其所有者。
- 自动传送到家功能默认关闭(
lost-golem-teleport-home)。此外,领地所有者还需拥有coppergolemclerk.teleport权限。 /cgc golems会显示丢失的傀儡。- 可通过设置
rescue-lost-golems: false关闭此功能。
- 满箱警报。当傀儡发现标记为其物品且已满的箱子,或者
[Overflow](溢出)箱子已满或达到 90% 容量时(overflow-alert-percent),你会收到通知。- 如果是 GriefPrevention 领地的所有者,在他们上线时会收到通知(即使他们之前离线)。
- 在其他地方,拥有
coppergolemclerk.alerts权限的玩家(默认包括 OP)会收到通知。 - 警报会被记录,并在
alert-cooldown-minutes(30 分钟)内不会重复发送。 - 可通过设置
full-chest-alerts: false关闭此功能。
- 傀儡避开传送门(
avoid-portals,默认开启)。铜傀儡永远不会进入下界传送门、末地传送门或末地折跃门,因此误入传送门的傀儡会停留在自己的世界中。牵绳牵引或骑乘的傀儡则照常通过。 - 铜箱子过滤器。铜箱子上的
[Only ...]告示牌(如[Only Logs]、[Only Oak Log]、[Only #planks])会使傀儡仅从中取出指定物品。多个[Only ...]行可以叠加生效。使用/cgc check可查看过滤器状态。 - 状态标签。当你手持竹竿时,附近的铜傀儡会显示它们正在做什么(例如“携带 12 根白桦原木”、“获取花岗岩”、“丢失中,正在回家”、“空闲”...)以及它们的铜锈程度。只有手持竹竿的玩家才能看到这些标签。可通过设置
status-labels: false关闭此功能。 /cgc stats显示傀儡今天、本周以及累计已分类的物品数量。玩家只能查看自己领地的数据。管理员可以看到整个服务器的数据、分类最多的物品以及最繁忙的领地。当玩家上线时,系统会告知他们在离线期间有哪些傀儡在其领地进行了分类,以及有多少个箱子已满(join-summary)。- barrel 和潜影盒。
destination-containers(默认值为[chest, trapped_chest],与原版一致)可以增加barrel和shulker_box。傀儡随后会将它们像箱子一样使用,支持标签、内容匹配和[Overflow]。傀儡会走到容器前,插件会自动将物品放入其中。如果不包含chest,则可以防止傀儡进入普通箱子。 - 更大的负载量。
carry-amount(1 到 64,默认为 16,与原版一致)设置每次行程中傀儡携带的物品数量。从铜箱子取出物品后,傀儡会从该箱子继续取出相同类型的物品,如果数量低于 16 个,还会放回一些。溢出抓取也会按此数量执行。 /cgc find <item>显示你附近哪些容器中含有某物品(或组、模式或标签),按距离由近及远排列。它会统计潜影盒内的物品。最近的 5 个容器会为你高亮显示 10 秒(find-highlight-count,find-highlight-seconds)。- 默认情况下,它只搜索你拥有的 GriefPrevention 领地。设置
find-outside-own-claims可扩大范围至无主容器和你拥有容器信任权的领地。 - 玩家每 2 秒只能搜索一次。
- 其他设置:
find-enabled,find-radius(32)。
- 默认情况下,它只搜索你拥有的 GriefPrevention 领地。设置
- 玩家可以使用
/cgc check、/cgc overflow和/cgc stats(权限分别为coppergolemclerk.check、.overflow和.stats,默认所有人可用)。他们只能访问他们可以打开的容器以及自己的领地。如果开启golems-command-for-players(默认关闭),/cgc golems也可用于查看他们自己的傀儡。拥有coppergolemclerk.allclaims(OP 权限)的玩家可以查看所有领地。 - 傀儡限制。
max-golems-per-claim和max-golems-outside-claims(每个世界)限制了使用该插件的铜傀儡数量。最早的傀儡优先保留配额。超出限制的较新傀儡将像原版一样工作,并通知领地所有者。默认值为 0(关闭)。负载测试表明,最多 200 个傀儡的情况下,每个正常工作的傀儡每刻约消耗 0.1 ms,无论是否安装该插件。README 中的“傀儡限制”部分有具体数值。
更改
- 文档:
- README 现在以插件的功能介绍开头,包括傀儡限制。它提供了功能概览、完整的设置参考(每个设置及其默认值)以及权限表。
docs/hangar.md是 Hangar 页面的文本内容,不包含夸大功能的描述,并邀请用户提出建议。config.yml头部和plugin.yml描述现在描述的是本插件,而非原版傀儡。
修复
- 位于
[Overflow](溢出)箱子上方楼层的傀儡从未从中取物。它们曾被引导至箱子方块本身,寻路算法阻止了它们在上方楼层行动,而不是找到绕楼梯的路径。现在,傀儡会走到箱子旁边一个拥有完整路径的位置,并跳过它们无法到达的溢出箱子。
2.5.1 (2026-10-28)
更改
- 绿色天线光效仅对手持切换物品(竹竿)的玩家可见。其余时间傀儡外观正常。
2.5.0 (2026-10-28)
新增
- 更高的箱子堆叠。
deliver-reach和take-reach(默认值为 2,即原版限制,最高可达 6)设定了傀儡将物品放入或取出的箱子上方行数。对于第 2 行之上的箱子,傀儡会走到堆叠底部,插件负责移动物品。/cgc check命令会显示箱子的高度以及傀儡是否能触及它。 - 使用竹竿右键点击单个傀儡可将其切换回原版行为(
golem-toggle-item)。再次右键点击即可恢复为插件模式。使用本插件的傀儡会在其天线处佩戴一个小绿灯(mode-markers)。这需要权限coppergolemclerk.toggle(默认所有人拥有),且在 GriefPrevention 插件下,需要拥有在傀儡站立位置建造的权限。 - 傀儡会打招呼。一个空闲的黄铜傀儡会走向附近的铁傀儡或雪傀儡,挥手致意,然后回到自己的日常工作中。之后它会等待
greet-cooldown-minutes(默认 5 分钟)才会再次打招呼。可以通过设置greet-other-golems(默认开启)来关闭此功能。
更改
- 插件在执行任何操作前都会检查傀儡是否为黄铜傀儡,因此铁傀儡、雪傀儡和其他生物永远不会受到影响。
2.4.1 (2026-10-28)
新增
- 记录傀儡死亡信息(
log-golem-deaths,默认开启)。当黄铜傀儡死亡时,服务器日志会记录其位置、原因(岩浆、坠落、特定生物及种类、/kill指令等)以及它当时手持的物品。傀儡变成雕像或被其他插件或指令移除的情况也会被记录。
2.4.0 (2026-10-27)
新增
- 更新通知。每周一次,插件会检查 GitHub 上是否有适用于您当前 Minecraft 版本的新发布版本。新版本会被记录到日志中,管理员登录时会收到一条包含链接的通知(每个版本仅通知一次)。不会下载任何内容。可通过设置
update-check: false关闭此功能。 /cgc version显示已安装的版本并立即检查是否有新版本。
2.3.0 (2026-10-27)
新增
- 傀儡避开活板门(
avoid-trapdoors,默认开启)。原版傀儡会将打开的活板门视为地面并走上去,从而掉入下方的洞中。现在它们会绕过活板门,无论打开还是关闭状态。傀儡互相避让时也会避开活板门。
2.2.0 (2026-10-27)
新增
[No Golems]告示牌(不区分大小写)可使傀儡远离某个箱子。傀儡绝不会向其中放入物品,也不会从带有该告示牌的黄铜箱子中取出物品。这对于用作普通存储的黄铜箱子非常有用。/cgc check命令会显示此标识。
更改
- 命名物品的告示牌如果包含所有 16 种染色版本的物品,也会接受染色后的版本。
[Terracotta]、[Shulker Box]、[Candle]和[Bundle]现在接受所有颜色,而不仅仅是纯色物品。[Red Terracotta]仍然只接受红色陶瓦,并且在处理红色陶瓦时优先级高于[Terracotta]。外观相似但不同的物品保持独立:[Sand]不接受红沙,[Ice]不接受蓝冰。
2.1.0 (2026-10-26)
傀儡无法使用的箱子
- 傀儡跳过被水浸没的箱子。原版傀儡会在距离箱子约 4 块的地方停下,并永远持有物品。
/cgc check和/cgc overflow命令现在会提示箱子是否被水浸没。 - 空闲傀儡不再从
[Overflow]箱子中取出被锁定、顶部有方块或猫挡住的物品,因为原版傀儡无法打开这些箱子。物品也永远不会被放回锁定的箱子中。
修复
- 傀儡在为另一只傀儡让路时,不再踏入火、岩浆、水、蛛网、细雪、浆果丛、营火、岩浆块或仙人掌中。它会后退到安全位置。(曾有一只测试傀儡因烧伤而死并丢失了其持有的 16 件物品。)
- 傀儡从
[Overflow]箱子中获取的物品,在傀儡变成雕像时不再丢失。 - 读取为
[#]的告示牌不再导致每次傀儡检查该箱子时报错。 - 远离玩家的傀儡可能永远持有无处安放的物品,因为其搜索每 10 分钟重启一次。现在它能按预期将物品送回黄铜箱子。
- 在永远无法触及的箱子旁等待的傀儡,会在正常返回时间后一分钟归还物品。
2.0.0 (2026-10-25)
重命名:SmartCopperGolems 更名为 Copper Golem Clerk
另一个项目已使用了类似名称。
- jar 文件名现为
CopperGolemClerk-<version>.jar。请删除旧的SmartCopperGolems-*.jar,否则插件会警告两者同时安装。 - 设置文件移至
plugins/CopperGolemClerk/。首次启动时,config.yml会从plugins/SmartCopperGolems/复制至此。 - 命令现改为
/cgc(或/coppergolemclerk),取代原来的/scg。 - 权限现改为
coppergolemclerk.admin,取代原来的smartcoppergolems.admin。
新增
/cgc help列出所有命令。/cgc help <command>解释单个命令。单独输入/cgc或输入错误的子命令时会显示列表。
更改
- 傀儡在打开箱盖期间整理箱子,并在物品掉落进箱子时再次整理,而不是在离开几秒后才进行整理。
1.3.0 (2026-10-25)
新增:查看傀儡将要执行的操作
/scg check注视箱子时可解释其状态。它会显示每个告示牌或物品框标签的含义、哪些物品会被其内容吸引,以及傀儡是否能使用该箱子(被阻挡、锁定、已满,或其下方漏斗正向黄铜箱子输送物品)。它还会说明你手中的物品是否会放入该箱子。/scg overflow报告您附近溢出箱子中的物品及其处理方式。处理方式包括:添加箱子(使用告示牌标签)、修复傀儡无法使用的箱子、清空已满的箱子以腾出空间,或者无需操作,因为空闲傀儡会移动该物品。- 从控制台执行时,两个命令均支持坐标:
/scg check <x> <y> <z> [world]。 - 短命令现改为
/scg(原为/sg)。/smartcoppergolems仍然有效。
新增:disabled-worlds
- 列出傀儡应按原版行为工作的世界,例如
disabled-worlds: [creative]。拼写错误的世界名会在启动时发出警告。
标签
- 悬挂在箱子上方的悬挂式告示牌现在也算作标签。
- 一行告示牌可容纳多个标签:
[ice][snow]。
修复
- 两个傀儡在仅一格的走廊中迎面相遇时,不再卡住。其中一个会后退(最多 16 格),直到找到第一个可以侧身让路的位置。
- 傀儡现在会在地毯和半砖地面上让路。此前这些地形被视作墙壁。
- 同时带有标签和
[Overflow](例如[logs]和[Overflow])的箱子,不再导致空闲的傀儡反复将其日志取出又放回。 - 整理箱子功能现尊重
disabled-worlds设置。 - 命令对错误的坐标或世界名称会给出清晰的错误提示。如果
config.yml中的组名命名为overflow,插件会发出警告,因为告示牌无法使用它:[Overflow]始终表示溢出箱。
1.2.0 (2026-10-25)
新增:傀儡整理其使用的箱子
傀儡将物品放入箱子几秒后,该箱子会被整理:
- 相同物品的不完整堆叠会被合并(20 + 10 橡木原木变为一个包含 30 个的堆叠)。重命名或附魔的同类型物品保持分开。
- 同类物品会按
config.yml中列出的组的顺序,然后按物品种类彼此相邻放置。堆叠从第一个槽位开始填充箱子。
铜制箱子不受影响,玩家正在打开的箱子也不受影响。该箱子会在玩家关闭后进行整理。
默认开启。可通过在 config.yml 中设置 tidy-chests: false 来关闭。
1.1.0 (2026-10-25)
新增:傀儡互相让路
当傀儡因另一只傀儡挡路而被困时,其中一只会向侧面退一步并等待对方通过。
- 手持空手的傀儡会让路给手持物品的傀儡。
- 如果两者都持有物品,或都为空手,则同一对傀儡中的那只总是主动让路,因此它们不会同时闪避。
- 正在处理箱子或只是相互经过的傀儡不会被干扰。
默认开启。可通过在 config.yml 中设置 golems-give-way: false 来关闭。在繁忙的分类室中,让路行为并未降低分类速度。
修复
- 插件现在始终报告正确的版本号。
1.0.0 (2026-10-24)
首次发布。铜傀儡将相似物品分拣到同一个箱子中(例如将白桦原木分拣到存放橡木原木的箱子中),而不仅仅是完全相同的物品。
- 内置 50 种物品组(原木、矿石、食物、燃料、唱片等),可在
config.yml中配置。 - 带有物品展示框或告示牌的箱子标签(
[group]、某物品、某种模式或#tag),以及用于兜底的[Overflow]溢出箱。 - 傀儡前往匹配度最高的箱子。没有合适归属的物品会进入溢出箱或空箱子,或退回其所在的铜傀儡处。
- 空闲的傀儡会在存在合适的归属地后,从溢出箱中取出物品。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧