ItemBan 2.2.0

ItemBan 2.2.0

全平台新增游戏内图形管理界面。封禁清理仍可只装服务端；普通玩家客户端不必安装。

打开管理界面

需要同时满足：

• 拥有权限节点 itemban.ban
• 客户端安装了与本服密钥匹配的管理模组
• 游戏内执行 /itemban gui

管理模组

首次开服会生成本服专用密钥和管理模组：

• 密钥文件：config/ItemBan/admin-key.json（之后重启沿用同一把密钥）
• 管理模组：config/ItemBan/admin-mods/ItemBan-Admin-*.jar（复制到管理员客户端 mods 即可）
• 客户端可同时放多个服的管理模组，进哪台服就用哪把密钥
• 运行中执行 /itemban adminmod 可按当前密钥再生成
• 运行中执行 /itemban adminmod regen 会更换密钥，旧模组立即失效

网页管理

默认只监听本机 127.0.0.1:25580。若要从其它电脑访问，在 config/ItemBan/config.json 中设置：

"webBind": "0.0.0.0"

首次会生成一次性密码（看服务端日志，或执行 /itemban web）。登录后必须设置正式密码，也可用 /itemban web password 直接设置。网页 user 账号不能修改自动踢出，也不能管理账号。

其它

• 管理校验改为恒定时间比较
• 玩家断线后立即清除游戏内管理会话
• NBT 与物品 ID 设有长度上限

请下载对应游戏版本的 jar，放入服务端 mods 文件夹后重启。

ItemBan 2.1.0

ItemBan 2.1.0

网页可视化管理（全平台）：

• 默认 http://<服务器IP>:25580，可管理物品/方块黑名单、审计排除、功能开关、中文图鉴与日志
• /itemban web 显示访问地址；首次为一次性密码，正式密码以 PBKDF2 哈希存储
• 网页账号：admin / owner 可注册或删除账号
• 管理权限改为节点 itemban.ban（默认 OP 等级 2；控制台始终可用）
• 创造模式或拥有 itemban.ban 的玩家豁免扫描清理

请下载对应游戏版本的 jar，放入服务端 mods 文件夹后重启。

ItemBan 2.0.0

ItemBan 2.0.0

扫描与匹配优化（全平台）：

• 方块黑名单为空时跳过世界体素扫描，只保留展示框检测
• 只扫描已列入方块黑名单的方块；空 chunk section 直接跳过
• NBT 规则在加载时预解析，匹配时不再反复 parseTag
• 所有周期扫描间隔不超过 12 ticks：背包 10、环境 12、掉落物 5
• 同一玩家同时只运行一种周期扫描；匹配在后台线程，删除仍在主线程

请下载对应游戏版本的 jar，放入服务端 mods 文件夹后重启。

ItemBan 1.0.8

ItemBan 1.0.8

Added

• 真正从服务端配方表移除产出为黑名单物品的配方（合成/熔炼/切石/锻造等）
• /itemban add、remove、reload 以及 /reload 都会重建配方表
• 取消封禁后从 datapack 快照恢复对应配方，并同步给在线玩家

Fixed

• 修复 1.21.11 / 26.1.2（Forge 与 NeoForge）在原版 /reload 时无法写回配方表

支持版本：1.16.5 / 1.18.2 / 1.19.2 / 1.20.1 / 1.21.1 / 1.21.11 / 26.1.2（Forge 与 NeoForge）。

ItemBan 1.0.7

ItemBan 1.0.7

多版本构建：Minecraft 1.16.5 / 1.18.2 / 1.19.2 / 1.20.1 / 1.21.1 / 1.21.11 / 26.1.2，Forge 与 NeoForge。

请下载与服务器游戏版本、加载器一致的 jar，放入 mods 后重启。纯服务端模组，客户端不用装。