一款轻量、高效的违禁物品自动清除插件,OP 免疫,支持热重载,检测到违禁物品后玩家会收到醒目的成就弹窗提醒。
---
你是否遇到过玩家用红石、侦测器制作高频卡服装置?或者某个模组物品你不希望玩家使用,但禁用又太麻烦?
DisableItems 插件可以帮你自动扫描并清除玩家背包中的违禁物品。插件会定时扫描所有在线玩家的背包,一旦发现禁用物品,立即通过 BDS 原生命令将其清除,并对玩家发出醒目的 Toast 成就弹窗 提醒。
---
特性 说明
---
1. 下载 DisableItems.js 文件
2. 将文件放入服务器的 plugins/ 文件夹
3. 重启服务器,或执行 ll reload DisableItems.js
4. 插件会自动生成配置文件 ./plugins/DisableItems/config.json
---
配置文件位置:./plugins/DisableItems/config.json
```json
{
"disabledItems": [
"minecraft:redstone",
"minecraft:observer"
],
"scanInterval": 20,
"sendMessage": true,
"message": "§c已禁用物品: {items}"
}
```
字段 类型 说明
disabledItems 数组 要禁用的物品列表,使用命名空间 ID(如 minecraft:redstone)
scanInterval 数字 扫描间隔,单位:刻(20 刻 = 1 秒)
sendMessage 布尔值 是否向玩家发送清除提示
message 字符串 提示内容,{items} 会被替换为实际清除的物品列表
如何添加更多禁用物品?
在 disabledItems 数组中添加物品的命名空间 ID 即可:
```json
"disabledItems": [
"minecraft:redstone",
"minecraft:observer",
"minecraft:piston",
"minecraft:sticky_piston",
"minecraft:repeater",
"minecraft:comparator"
]
```
---
命令 权限 说明
/disableitems OP 重载配置文件,立即生效
---
当普通玩家的背包中出现禁用物品时:
1. 物品自动消失 —— 从背包中消失,不会掉落
2. 成就弹窗提醒 —— 屏幕中央出现醒目的 Toast 通知
3. 聊天栏消息 —— 同时收到文字提示
OP 玩家不受任何影响,可以正常使用所有物品。
---
示例 1:禁用红石和侦测器(默认配置)
```json
"disabledItems": [
"minecraft:redstone",
"minecraft:observer"
]
```
效果:玩家背包中的红石和侦测器会在一秒内自动消失,并收到提示:
§c已禁用物品: minecraft:redstone, minecraft:observer
示例 2:禁用活塞和粘性活塞
```json
"disabledItems": [
"minecraft:piston",
"minecraft:sticky_piston"
]
```
示例 3:禁用下界合金锭
```json
"disabledItems": [
"minecraft:netherite_ingot"
]
```
---
· 清除方式:使用 BDS 原生命令 clear,兼容性极佳
· 扫描逻辑:定时扫描,不影响服务器性能
· 权限控制:player.isOP() 检测,OP 完全免疫
· 存储方式:JSON 配置文件,支持热重载
---
1. 插件不会阻止玩家合成或获得禁用物品,只会在获得后自动清除
2. 如需禁止玩家合成,请配合其他插件使用
3. 清除的物品不会掉落,直接消失,请玩家注意
4. OP 玩家不受任何限制,请合理分配 OP 权限
---
v1.0.0 (2026-06-27)
·
·
·
·
·
·
---
如果你遇到任何问题,或有功能建议,欢迎通过以下方式反馈:
· MineBBS:在本帖回复
· QQ:1798252811
---
本项目采用 AGPL-3.0 许可证开源。
---
如果觉得这个插件对你有帮助,欢迎评价支持!
部分代码由 AI 辅助生成,经本人测试适配