BanHammer

插件

· 作者 raylix2

生存禁止与解除禁止锤、员工管理工具、自定义合成以及可选武器效果。可配置的消息、安全机制和可选资源包。

0 本站下载 0 关注 更新于 3 周前

最新 1.3.0+1.21.3.bukkit · 1.21.3 · Bukkit / Paper

一键开服(送7天)

BanHammer ?

让每一场战斗都至关重要——给你的管理团队一把真正有分量的锤子。

使用 Ban Hammer(封禁锤) 击败对手即可将其封禁。要解除封禁,请使用 Pardon Hammer(赦免锤) 击败其攻击者,然后选择一名或所有符合条件的玩家进行赦免。你可以围绕这些物品构建生存挑战,或者启用独立的管理员模式用于日常Moderation。

下载适合你服务器的版本 · Wiki

生存模式的锤子,由你定规

  • 支持临时或永久封禁,可配置的冷却时间以及自定义封禁理由。
  • Ban(封禁)和 Pardon(赦免)的游戏玩法开关相互独立,支持世界排除、可选的操作员/绕过保护、仅限生存的规则以及击杀归属设置。
  • 可选择在成功操作后保留或消耗 Ban Hammer。
  • 自定义材质、名称、lore(描述)、原版附魔、属性、发光效果、不可破坏性、模型数据、音效和粒子效果。
  • 在游戏中创建你的合成配方:输入 /bh craft 可直接打开合成编辑器。放置材料和工作台结果,保存并启用该配方;已保存的配方在服务器重启后依然保留。材料匹配使用的是原版材质标识,而非物品名称或 lore。
  • /bh 打开管理菜单;/bh doctor 检查安装状态和配方状态。

在 Minecraft 尚未推出 mace(重锤)之前,默认物品回退为 netherite axe(下界合金斧)。可选的资源包可为其赋予锤子的外观;但这并不会向较旧版本的服务器添加新版原版的“砸击”机制。

管理员 Moderation ?️

管理员模式需在锤子上显式启用,从而将普通生存物品与之区分开来。右键点击玩家可使用选定的封禁预设;左键点击执行踢出或监禁操作。潜行点击可循环切换独立的预设,或使用 /bh preset 进行选择。短距离左键瞄准会检测实体方块遮挡,且有效范围上限为五个方块。

  • 封禁与 IP 封禁: 支持理由、临时/永久时长、自动过期及手动释放。
  • 清除封禁屏幕: 可配置彩色分隔线,显示玩家、理由、管理员、剩余时间、过期日期及服务端占位符。
  • 静音: 可配置屏蔽聊天、命令、告示牌编辑和书本编辑。
  • 监禁: 支持保存位置、移动边界、命令/传送限制、伤害保护以及返回原位功能。/bh setjail 设置内置监禁位置。
  • 警告: 支持过期时间、可配置的阈值以及自动临时封禁策略;被消耗的警告防止同一阈值被无限次重复触发。
  • 申诉: 已连接的玩家可提交申诉;管理员可查看、批准或拒绝。批准后将解除特定的关联处罚。被封禁的玩家无法加入游戏输入命令,因此需要依赖外部的申诉流程。
  • 记录: 持久化历史记录、活跃处罚列表、管理员统计信息、排行榜以及受保护的管理仪表盘。
  • 预设: 包括持续时间、理由、IP 封禁模式、音效、视觉闪电效果、粒子效果和限定的击退效果。可选的管理员锤子方块保护功能有助于避免意外破坏。

默认情况下,行政封禁受到保护,不受普通生存模式下 Pardon 游戏玩法的影响。通过单个权限、自我目标保护、可选的操作员/绕过保护以及动作冷却来控制访问权限。

可选武器效果

更倾向于使用普通的剑或斧?可通过配置或 /bh enchant on 启用服务端管理的 Ban/Pardon 附魔效果。该功能默认关闭。

可配置允许的武器、效果名称、最大等级、经验等级成本、命令应用以及每级的封禁时长倍率。/bh enchant ban 2 将封禁效果应用于手中符合条件的武器;/bh enchant pardon 1 应用赦免效果;/bh enchant remove 移除该效果。禁用此功能会暂停现有效果,直到重新启用。

这是一个持久的插件效果,并非注册在原版附魔台中的附魔。它不会生成附魔书、无法通过铁砧转移,也不会新增客户端内容。赦免等级会被存储和显示,但不会增加赦免的数量。

可选资源包

你可以通过 moderation.yml 提供自己的兼容资源包,指定 HTTPS URL 和 SHA-1 哈希值,并自定义提示信息和可选的加入时推送。输入 /bh pack 即可推送该资源包;拒绝永远不会导致玩家断开连接。/bh pack apply 会为现有的真实锤子更新模型数据。

模型值默认为 Ban 使用 710001,Pardon 使用 710002。单独的原始 BanHammer Visuals alpha 版本包含 MACE/NETHERITE_AXE 模型,并提供精确版本的 ZIP 包。其归档/JSON 检查已通过;图形化的 Minecraft 渲染效果尚未经过验证。其他材质需要匹配的模型。如有必要,请将物品定义与现有的服务器资源包合并;可选的 ViaVersion 协议变体可配置,但未单独认证混合客户端集成。

语言与配置 ?

提供了英文和法文的生存消息文件。Moderation 消息预设包括英文、法文和德文。你可以将可编辑的 UTF-8 消息值翻译为你服务器的语言,选择 lang 并重新加载。缺失的生存语言文件会接收一个可编辑的英文模板;Moderation 消息键值则回退到英文。部分命令反馈和 GUI 标签仍保持固定语言,因此这是本地化的一部分,而非自动翻译成所有语言。

首次启动时会自动在 plugins/BanHammer/ 目录下生成配置文件。带有注释的文件将游戏玩法、Moderation、可选统计信息和自动更新分开存放。你可以自定义物品外观、配方、保护措施、权限、持续时间、经验成本、预设、消息、存储、历史记录保留时间和资源包分发。现有游戏玩法设置在更新过程中得以保留。

性能、持久性与安全措施

  • 事件驱动的游戏玩法与缓存的活跃制裁;无需每刻扫描世界/物品栏。
  • 后台数据库工作;新的管理制裁在执行前即持久化。SQLite 使用 WAL(预写式日志);MySQL 兼容后端已在 MariaDB 上测试通过。
  • 定期可配置的过期/同步检查,限制化的 Webhook 工作与操作冷却时间。
  • 预编译 SQL 语句、可配置的 IP 显示隐私以及用于 IP 制裁的带密钥 HMAC 匹配。HMAC 是一种伪匿名化手段;服务器/代理日志中仍可能包含 IP 地址。
  • 受保护的物品栏菜单,并经过测试以防止在封禁/死亡/赦免/重新加入后保留重复的受害者锤子。
  • 可取消的前惩罚 API 事件、应用/释放事件,以及可选的 Discord 通知。Discord 消息传递和 Essentials 监狱查询功能已实现,但未获得外部运行时认证。
  • 可选的 bStats 统计和可配置的匹配版本更新下载,将在下次服务器重启时生效。两者均非游戏必需;更新不会强制重启服务器。

请使用专用数据库服务于每个服务器。1.3 版不支持完整的代理/共享网络解封协调;远程数据库发布可能导致另一台服务器的永久原生封禁状态残留。不保证通用兼容性、零延迟或玩家容量上限。

命令与快速安装

将精确版本的 Bukkit JAR 放入 plugins/ 目录并重启服务器。无需客户端模组。配方默认禁用,直到保存/启用后才可用。

/bh give YourName ban 1
/bh craft [ban|pardon]
/bh staff
/bh staff give YourName
/bh preset <ban|utility> <name>
/bh modgui
/bh ban|ipban|mute|jail <player> <duration> [reason]
/bh kick|warn <player> [reason]
/bh unban|unmute|unjail <player>
/bh history|warnings <player>
/bh stats [player]
/bh top
/bh active [type]
/bh setjail
/bh appeal <message>
/bh appeals
/bh approve|deny <appeal-id> [note]
/bh enchant <on|off|ban|pardon|remove>
/bh pack [apply]
/bh cooldown|reset|reload|info|help
/bh doctor

时长参数可使用如 30m、2h、7d、ISO-8601 格式时长或 permanent(永久)。自我惩罚及权限不足将被拒绝。管理功能默认面向操作员,支持独立权限节点及过滤补全。/bh 别名包括 /banhammer、/banhamer、/banhler 和 /masse。当其他插件占用了裸别名时,请优先使用 /bh mute 等完整命令。

版本、精确版本测试及可选统计

上述功能描述适用于 Bukkit 1.3.0,兼容对应的 Spigot/Paper 及其衍生分支。独立的 Fabric、Forge、NeoForge、Quilt、Folia 和 Sponge Alpha 版保留了其之前的核心 Ban/Pardon 游戏玩法。它们不包含新的 Bukkit 管理套件、菜单、合成编辑器、可选武器效果或新的包分配功能。Fabric 需要对应版本的 Fabric API;Quilt 需要对应版本的 QFAPI。请勿将模组 JAR 作为 Bukkit 插件安装,也不要期望通过切换版本来实现数据库迁移。

针对其精确 API 编译了 29 个 Bukkit 变体:24 个通过了客户端合成/配置/权限/重启回归测试;5 个 26.x 版本仅通过了启动/控制台测试。全新的管理场景已在 Paper 1.19 和 1.21.1 上全部通过;MariaDB 持久化功能已在 Paper 1.21.1 上测试通过。生存战斗与防复制功能在 Paper 1.21.11 上使用普通物品及可选武器效果测试通过。每个文件的更新日志均说明了其实际范围;其他兼容性构建仍处于 Beta 阶段。

32 项动作测试衡量的是队列制裁和持久化能力,而非实时服务器的 TPS 容量。原生 Alpha 版保留其已公布的局限性,包括 Sponge 1.21.9 的赦免问题和 Forge 1.21.9 的关闭问题。请在安装前检查您选择的文件。

bStats 统计参与服务器数量和在线玩家数,而非唯一下载量。请配置 metrics.yml 或 bStats 的全局退出选项。更新下载使用 updates.yml。

Raylix2 的其他作品:KarmaCore · SmartLoot。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源