---

Warden

A server-side Fabric mod that gives admins granular control over explosions, weapons, items, enchantments, and status effects, all managed in-game via commands, with no need to manually edit config files.

---

Features

Explosion Limits

Cap or completely disable explosions by source type. Supports:

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

Each source can have its max power set independently, or be fully disabled.

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

---

Weapon Limits

Cap combat stats per weapon or weapon group. Supports both melee and ranged weapons.

Melee stats (sword, axe, mace, trident, spear):

• damage — max attack damage
• attackSpeed — max attack speed
• reach — max melee reach

Ranged stats (bow, crossbow, trident):

• projectileDamage — max projectile damage on hit
• rechargeTime — minimum ticks required between uses

Attack cooldown (all melee):

• disableCooldown <ticks> — forces an item cooldown after every attack, effectively limiting attack rate using Minecraft's built-in item cooldown system (separate from attack speed)

Targets can be individual items (minecraft:netherite_sword) or groups (sword, axe, all).

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

---

Item Limits

Cap how many of a given item a player can hold. Overflow items are either dropped or deleted depending on your config.

• maxCount <n> — max items of this type a player can carry (checked periodically)
• deleteOverflowItem — if true, items exceeding the limit are deleted instead of dropped
• checkIntervalTicks — how often the inventory is checked (default: every 20 ticks / 1 second)
• dropPickupDelay — ticks before a dropped overflow item can be picked up again

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

---

Enchantment Limits

Cap the maximum level of any enchantment globally, with optional per-item-type overrides.

• Global cap: applies to all items with that enchantment
• Item override: a different cap for a specific item type (e.g. cap Sharpness to 3 globally but allow 5 on swords)

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

---

Status Effect Limits

Cap the max level and/or max duration of any status effect applied to players.

• maxLevel — clamp effect amplifier
• maxDuration — clamp effect duration in ticks

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

---

Exempt System

Players on the exempt list (or in Creative mode) bypass all limits entirely.

• exemptCreative — toggle automatic exemption for Creative mode players (default: true)
• Named player exemptions persist across sessions

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

---

Action Bar HUD

Players receive real-time action bar notices when a limit is actively affecting them. Each category (item, weapon, enchantment, effect) can be toggled globally by admins, and individual players can opt out of specific categories themselves.

/warden actionbar item false (player opts out of item notices) /warden config itemActionBarEnabled false (admin disables globally)

---

Global Config Toggles

Each limit category can be enabled or disabled independently without removing your configured rules.

/warden config weaponLimitsEnabled false /warden config explosionLimitsEnabled true

---

Utility Commands

Command	Description
/warden status	Overview of all active limits
/warden reload	Reload config from disk
/warden reset	Reset all limits to defaults
/warden reset <category>	Reset a single category (explosion, item, weapon, enchant, effect, actionbar, exempt)
/warden help	In-game command reference

---

Configuration

Config is saved automatically to config/warden.json on your server. All changes made via commands are written to disk instantly — no restart needed. The config also syncs to connected clients in real time.

---

Requirements

• Minecraft 1.21.11
• Fabric Loader ≥ 0.16.0
• Fabric API

---

Permissions

All /warden admin commands require operator level 2 (gamemaster). The /warden actionbar command is available to all players to manage their own HUD preferences.