典狱长

典狱长

一个Fabric服务器模组,允许管理员通过命令限制武器、爆炸、物品、附魔和效果的数量。

游戏机制

Warden

一个服务端 Fabric 模组,让管理员能够精细控制爆炸、武器、物品、附魔和状态效果,全部通过游戏内命令管理,无需手动编辑配置文件。


功能

爆炸限制

按来源类型限制或完全禁用爆炸。支持:

  • tnt、tnt_minecart
  • creeper
  • bed、respawn_anchor
  • end_crystal
  • ghast
  • wither、wither_skull

每个来源都可以独立设置最大威力,或完全禁用。

/warden explosion set tnt maxPower 1.0 /warden explosion disable creeper


武器限制

按武器或武器组限制战斗属性。同时支持近战和远程武器。

近战属性(sword、axe、mace、trident、spear):

  • damage — 最大攻击伤害
  • attackSpeed — 最大攻击速度
  • reach — 最大近战攻击距离

远程属性(bow、crossbow、trident):

  • projectileDamage — 命中时最大弹射物伤害
  • rechargeTime — 两次使用之间所需的最小刻数

攻击冷却(所有近战武器):

  • disableCooldown <ticks> — 每次攻击后强制物品冷却,利用 Minecraft 内置的物品冷却系统有效限制攻击频率(与攻击速度独立)

目标可以是单个物品(minecraft:netherite_sword)或组(sword、axe、all)。

/warden weapon set sword damage 6.0 /warden weapon set bow projectileDamage 8.0 /warden weapon set all disableCooldown 10


物品限制

限制玩家可持有的特定物品数量。溢出物品会根据你的配置被丢弃或删除。

  • maxCount <n> — 玩家可携带该类型物品的最大数量(定期检查)
  • deleteOverflowItem — 若为 true,超过限制的物品将被删除而不是丢弃
  • checkIntervalTicks — 检查物品栏的频率(默认:每 20 刻 / 1 秒)
  • dropPickupDelay — 被丢弃的溢出物品可再次被拾取前的刻数

/warden item set minecraft:diamond maxCount 64 /warden config deleteOverflowItem true


附魔限制

全局限制任何附魔的最高等级,并可为特定物品类型提供可选覆盖。

  • 全局上限:应用于所有带有该附魔的物品
  • 物品覆盖:为特定物品类型设置不同的上限(例如全局将 Sharpness 限制为 3,但允许剑上达到 5)

/warden enchant set minecraft:sharpness maxLevel 3 /warden enchant set minecraft:sharpness maxLevel 5 for sword /warden enchant disable minecraft:mending


状态效果限制

限制施加于玩家的任何状态效果的最高等级和/或最长持续时间。

  • maxLevel — 限制效果等级
  • maxDuration — 限制效果持续时间(刻)

/warden effect set minecraft:speed maxLevel 1 /warden effect set minecraft:strength maxDuration 200 /warden effect disable minecraft:invisibility


豁免系统

豁免名单上的玩家(或处于创造模式的玩家)完全绕过所有限制。

  • exemptCreative — 切换创造模式玩家的自动豁免(默认:true)
  • 具名玩家豁免在会话之间持久保留

/warden exempt add Steve /warden exempt remove Steve /warden config exemptCreative false


动作栏 HUD

当某项限制正在影响玩家时,玩家会收到实时动作栏提示。每个类别(物品、武器、附魔、效果)可由管理员全局切换,单个玩家也可自行选择退出特定类别。

/warden actionbar item false (玩家选择退出物品提示) /warden config itemActionBarEnabled false (管理员全局禁用)


全局配置开关

每个限制类别都可以独立启用或禁用,而无需移除已配置的规则。

/warden config weaponLimitsEnabled false /warden config explosionLimitsEnabled true


实用命令

命令 描述
/warden status 所有生效限制的概览
/warden reload 从磁盘重新加载配置
/warden reset 将所有限制重置为默认值
/warden reset <category> 重置单个类别(explosion、item、weapon、enchant、effect、actionbar、exempt)
/warden help 游戏内命令参考

配置

配置会自动保存到服务器上的 config/warden.json。通过命令所做的所有更改都会立即写入磁盘——无需重启。配置还会实时同步到已连接的客户端。


要求

  • Minecraft 1.21.11
  • Fabric Loader ≥ 0.16.0
  • Fabric API

权限

所有 /warden 管理员命令需要操作员等级 2(游戏管理员)。/warden actionbar 命令对所有玩家开放,用于管理自己的 HUD 偏好。