物品封禁管理器(Banitems)
Github |
相关wiki |
源站链接
支持: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6,
一款面向服务器管理员的 Minecraft Forge 模组，支持按物品和 NBT 进行软封禁与硬封禁，提供图形化界面与命令管理，并将封禁规则以 JSON 持久保存，便于维护服务器平衡与玩法规则。
BanItems 简介
BanItems 是一款基于 Minecraft Forge 的模组，旨在让服务器管理员灵活管理与限制游戏内物品。它支持两种封禁模式（软封禁与硬封禁）、识别 NBT 的细粒度限制、内置物品管理 GUI 与一组便捷命令，并将规则以 JSON 保存以保持持久性。
仓库与文档（示例）： 链接
核心功能
双重封禁模式：
软封禁（Soft Ban）：限制物品的功能（例如禁止放置方块或使用工具），但允许玩家保留物品在背包中。
硬封禁（Hard Ban）：完全阻止玩家获得、持有或使用该物品（检测到后会自动移除）。
按 NBT 限制：不仅按物品 ID，还能根据 NBT 数据区分特定变体（如附魔武器、自定义名称的药水等）。
直观的 GUI 管理：
游戏内的背包样式界面用于添加/移除封禁物品，无需手动编辑配置文件。
列表中显示被封禁物品的预览与详细信息（例如封禁类型、NBT 标签）。
完整的命令集合：通过游戏内命令快速管理封禁、查看列表与重载配置。
持久化配置：封禁列表保存在 JSON 文件中，重启服务器后规则依然生效。
命令
所有命令均需权限节点 banitems.admin（默认授予服务器管理员）。在游戏中使用 /banitem help 查看快速帮助。
命令
说明
/banitem soft
打开 GUI，将物品添加到软封禁列表
/banitem hard
打开 GUI，将物品添加到硬封禁列表
/banitem list soft
查看所有软封禁物品（支持分页，例如 /banitem list soft 2）
/banitem list hard
查看所有硬封禁物品（支持分页）
/banitem reload
重新加载配置文件（无需重启服务器即可应用更改）
/banitem help
显示所有可用命令与用法说明
安装
BanItems 为 Forge 模组，请确保服务器/客户端使用与模组兼容的 Forge 版本（可在 Releases 页面查看对应版本）：
安装 Forge：下载并安装目标 Minecraft 版本对应的 Forge（例如 1.20.1-forge-47.1.0）。
下载模组：从 GitHub Releases 或你常用的模组平台获取最新版 BanItems JAR 包。
放入 mods 目录：
服务器：将 JAR 放入服务器的 mods/ 目录。
客户端（单人或用于访问服务器）：将 JAR 放入本地 .minecraft/mods/ 目录。
启动：启动服务器或客户端，BanItems 会自动初始化并生成默认配置文件。
配置
BanItems 使用可读的 JSON 配置文件来存储封禁规则，便于手动编辑（但建议优先使用游戏内 GUI 或命令管理）。
配置路径
服务器/客户端：config/banitems/banitems.json
配置结构（示例）
{
"softBannedItems": [], // 功能受限的物品（例如：["minecraft:ender_pearl"]）
"hardBannedItems": [], // 完全封禁的物品（例如：["minecraft:creative_only_item"]）
"excluded": [] // 在被封禁物品箱中不被替换的物品 ID（例如：["minecraft:wooden_chest"]）
}Copy已复制！
编辑提示：优先通过游戏内 GUI 或命令进行管理以降低错误风险。手动编辑后需执行 /banitem reload 使更改生效。
开发与本地构建
BanItems 遵循 Minecraft Forge 的最佳实践，代码结构参考社区约定，并借鉴了如 itembarriers 的实现思路。
本地构建步骤：
克隆仓库：
git clone 链接
cd BanItems
使用 Gradle 构建：
Windows：gradlew.bat build
Linux/macOS：./gradlew build
构建生成的模组 JAR 位于 build/libs/ 目录下，选择不带 -sources 或 -dev 后缀的文件作为成品。
贡献指南：
Fork 仓库并创建功能分支（例如 feature/add-whitelist）。
遵循现有代码风格（与 Forge 开发约定保持一致）。
本地测试通过后再提交 Pull Request。
许可
BanItems 采用 MIT 许可证，详见仓库中的 LICENSE 文件。你可以：
在公/私服上使用模组。
修改代码以供个人使用。
在保留署名的前提下分发修改版本。
致谢与支持
框架：基于 Minecraft Forge。
灵感来源：参考了社区项目与实现（例如 itembarriers）。
维护者：YuWan-030（请查看 GitHub 仓库获取最新更新）。
如需报告问题或提出功能请求，请在项目的 GitHub 仓库中打开 issue。
截图：
版本&下载所有游戏版本1.201.20.11.20.21.20.31.20.41.20.51.20.6所有类型forge一键安装到游戏中Banitems MOD 1.0.3下载1.0.3 · Release版本: 1.0.3支持游戏: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6类型: ForgeRelease下载次数: 10,652全部版本
文章类型：收录