ItemFixer
在需要更新时,将旧物品替换为新物品。专为 FFA 设计,当你需要更新物品但不想使用卡顿的修复村民 NPC 时非常有用。
? 物品替换
- 配对新旧物品 - 每个修复规则包含一个旧物品及其对应的新物品。
- 保留堆叠数量 - 12 个物品的堆叠仍保持为 12 个。仅改变物品类型。
- 精确匹配 - 名称、附魔和物品数据保持不变,使其纯粹变成你想要的物品。
- 聊天通知 - 拥有
itemfixer.notify 权限的玩家会收到自己物品变更的通知。
? 规则菜单
/itemfixer 打开规则菜单。
- 每个规则一个图标 - 除了绿宝石外的每个物品代表一个规则,你可以点击并编辑它。
- 添加 - 一个附魔绿宝石位于最后一个规则之后。点击它可以创建新规则。
点击规则进行编辑。点击绿宝石以添加新规则。
✏️ 编辑器
一个 4 行的菜单。
- 左侧槽位 - 旧物品。
- 右侧槽位 - 变成的新物品。
- 点击或 Shift+点击 - 从槽位中取出物品。
- 保存 - 当两个槽位都填满时,绿宝石会发光。
- 删除 - 右下角,仅在编辑现有规则时可用。
? 扫描范围
检查玩家身上的:
- 背包
- 护甲栏
- 副手
- 光标(手持)
- 末影箱,仅当配置中的
scan.ender-chest 为 true 时(默认关闭)
不检查:
- 箱子、 barrel 和其他物理世界存储容器
- 潜影盒或物品袋内的嵌套物品。我可能会在未来添加对此的支持。
? 世界与绕过
- 绕过 - 任何具有
bypass-permissions 下列出的权限的玩家不会被处理。默认为 itemfixer.bypass(默认 false)。
- 黑名单 - 跳过列表中列出的世界。
- 白名单 - 仅修复列表中列出的世界。
- 世界名称忽略大小写。
离线玩家无法检查绕过权限。如果在 /itemfixer fixall 执行期间绕过玩家处于离线状态,他们仍会被修复。
⏱️ 运行频率
修复操作在主线程上运行,每次处理少量玩家,以避免 mspt 飙升和服务器卡顿。
cycle-seconds - 在线玩家再次被检查的频率。默认 20。
players-per-tick - 每 tick 修复多少玩家的物品。默认 1。
- 加入游戏、拾取物品和关闭箱子也会标记该玩家进行检查。
- 站在被跳过世界的玩家,或拥有绕过权限的玩家,不会被检查。
/itemfixer reload 应用 config.yml、rules.yml 和 messages.yml 而无需重启。损坏的配置会保留之前的设置。
? 修复所有人
/itemfixer fixall 修复在线玩家和离线玩家。
? 消息
所有文本位于 plugins/ItemFixer/messages.yml。支持 Minimessage(基本上是人权!)。
gui:
save: "<green>Save Rule"
delete: "<red>Delete Rule"
命令
| 命令 |
权限 |
描述 |
/itemfixer |
itemfixer.admin |
打开规则列表。仅限玩家。 |
/itemfixer reload |
itemfixer.admin |
重载配置、规则和消息。 |
/itemfixer fixall |
itemfixer.admin |
修复在线玩家,然后修复离线玩家文件。 |
控制台可以运行 reload 和 fixall。打开菜单需要玩家身份。
权限
| 权限 |
默认值 |
描述 |
itemfixer.admin |
OP |
打开菜单、重载和运行 fixall |
itemfixer.notify |
true |
当你的物品被更新时收到通知 |
itemfixer.bypass |
false |
保留旧物品。也是 bypass-permissions 中的默认条目 |
配置
主配置文件:plugins/ItemFixer/config.yml
| 键 |
默认值 |
作用 |
bypass-permissions |
itemfixer.bypass |
跳过修复的权限 |
worlds.mode |
blacklist |
blacklist 跳过列表中的世界,whitelist 仅修复列表中的世界 |
worlds.list |
空 |
世界名称,忽略大小写 |
scan.ender-chest |
false |
也检查末影箱 |
optimisations.skip-armor-without-equipable |
true |
如果没有可穿戴的旧物品,则跳过护甲槽 |
cycle-seconds |
20 |
完整在线检查之间的秒数 |
players-per-tick |
1 |
每 tick 修复的玩家数量 |
规则存储在 plugins/ItemFixer/rules.yml 中。离线修复的溢出数据存储在 plugins/ItemFixer/pending.yml 中。
要求
- Minecraft: Paper 1.21 至 26.3
- Java: 21 或更高版本
- 构建: Maven,
mvn package, 输出 target/itemfixer.jar
不支持 Folia。(抱歉 jules)
ItemFixer
Replaces old items with the new ones in case updates are needed. Built for FFA where you need to update items but you dont want to use a clanky fix villager NPC.
🔄 Item Replacement
- Pair old and new - Each fix is one old item and the item it becomes.
- Keeps the stack - A stack of 12 stays a stack of 12. Only the item changes.
- Exact match - Name, enchants, and item data stay so it purely becomes the item you want it to.
- Chat notice - Players with
itemfixer.notify get notified when something of theirs changed.
📖 Rule Menu
/itemfixer opens the rule menu.
- One icon per rule - Each item except the emerald represents a rule which you can click on and eidt.
- Add - A enchanted emerald sits right after the last rule. If you click it, you can create a new rule.
Click a rule to edit it. Click the emerald to add one.
✏️ Editor
A 4-row menu.
- Left slot - The old item.
- Right slot - What it becomes.
- Click or shift-click - Takes an item back out of a slot.
- Save - The emerald glows once both slots are filled.
- Delete - Bottom right, only while editing an existing rule.
🎒 What Gets Scanned
Checked on the player:
- Inventory
- Armor
- Offhand
- Cursor
- Ender chest, only when
scan.ender-chest in the config is true (off by default)
Not checked:
- Chests, barrels, and other physical world storage
- Items nested inside shulkers or bundles. I lowkey might add support for this in the future.
🌍 Worlds And Bypass
- Bypass - Anyone with a permission listed under
bypass-permissions is left alone. Default is itemfixer.bypass (default false).
- Blacklist - Skip the worlds in the list.
- Whitelist - Repair only the worlds in the list.
- World names ignore case.
Offline players cannot be checked for bypass. A bypass player who is offline during /itemfixer fixall is still repaired.
⏱️ How Often It Runs
Repairs stay on the main thread, a few players at a time, as to not spike mspt and lag the server.
cycle-seconds - How often online players are checked again. Default 20.
players-per-tick - How many players items are repaired on one tick. Default 1.
- Join, pickup, and closing a chest also mark that player to be checked.
- Players standing in a skipped world, or with bypass, are not checked.
/itemfixer reload applies config.yml, rules.yml, and messages.yml without a restart. A broken config keeps the previous settings.
👥 Fix Everyone
/itemfixer fixall repairs people who are online and people who are offline.
💬 Messages
All text lives in plugins/ItemFixer/messages.yml. Minimessage support (basically a human right)!
gui:
save: "<green>Save Rule"
delete: "<red>Delete Rule"
Commands
| Command |
Permission |
Description |
/itemfixer |
itemfixer.admin |
Opens the rule list. Players only. |
/itemfixer reload |
itemfixer.admin |
Reloads config, rules, and messages. |
/itemfixer fixall |
itemfixer.admin |
Repairs online players, then offline player files. |
Console can run reload and fixall. Opening the menu requires a player.
Permissions
| Permission |
Default |
Description |
itemfixer.admin |
OP |
Open the menu, reload, and run fixall |
itemfixer.notify |
true |
Hear when your items are updated |
itemfixer.bypass |
false |
Keep old items. Also the default entry in bypass-permissions |
Configuration
Main config: plugins/ItemFixer/config.yml
| Key |
Default |
What it does |
bypass-permissions |
itemfixer.bypass |
Permissions that skip the repair |
worlds.mode |
blacklist |
blacklist skips the list, whitelist repairs only the list |
worlds.list |
empty |
World names, case ignored |
scan.ender-chest |
false |
Also check ender chests |
optimisations.skip-armor-without-equipable |
true |
Skip armor slots when no old item is wearable armor |
cycle-seconds |
20 |
Seconds between full online checks |
players-per-tick |
1 |
Players repaired on each tick |
Rules are stored in plugins/ItemFixer/rules.yml. Overflow from offline repairs is stored in plugins/ItemFixer/pending.yml.
Requirements
- Minecraft: Paper 1.21 through 26.3
- Java: 21 or newer
- Build: Maven,
mvn package, output target/itemfixer.jar
Folia is not supported. (sorry jules)
评论 0
登录后参与评分
还没有评论,来抢沙发吧