Nerfstick

Nerfstick is a modern Paper plugin that gives server owners fine-grained control over the vanilla Debug Stick.

It allows debug sticks to be safely used in survival environments while preventing abuse in protected regions such as WorldGuard regions or GriefPrevention claims.

Unlike vanilla behavior, Nerfstick lets you define exactly which block properties can be modified, and under what conditions, making it ideal for survival servers, admin tools, and controlled building environments.

---

✨ Key Features

• 🧪 Safe Debug Stick usage in Survival mode
• 🔐 Permission-based control over block state editing
• 🧱 Fine-grained whitelist for block properties
• 🌍 Protection-aware (WorldGuard / claim systems compatible via hooks)
• ⚙️ Fully configurable per-block and per-property rules
• 🚀 Updated for modern Paper (1.21+)

---

🧠 How it works

Nerfstick intercepts Debug Stick interactions and applies server-defined rules at runtime.

It evaluates every interaction before any block state mutation occurs.

This includes:

• Preventing usage in protected regions
• Restricting which blocks can be modified
• Restricting which block properties (e.g. facing, powered, waterlogged) can be changed
• Allowing safe, controlled cycling of block states in survival mode

---

🔐 Permissions system (LuckPerms recommended)

Nerfstick supports hierarchical and regex-based permission nodes for advanced control.

To allow Debug Stick usage outside of creative mode, grant:

minecraft.debugstick.always

Core structure

nerfstick.use.minecraft.*
nerfstick.use.minecraft.lever.*
nerfstick.use.minecraft.furnace.facing

---

🧱 Recommended whitelist (blocks)

nerfstick.use.minecraft.barrel.*
nerfstick.use.minecraft.bell.*
nerfstick.use.minecraft.furnace.*
nerfstick.use.minecraft.ladder.*
nerfstick.use.minecraft.lectern.*
nerfstick.use.minecraft.lever.*
nerfstick.use.minecraft.lightning_rod.*
nerfstick.use.minecraft.note_block.*
nerfstick.use.minecraft.observer.*
nerfstick.use.minecraft.rail.*
nerfstick.use.minecraft.redstone_comparator.*
nerfstick.use.minecraft.tripwire_hook.*
nerfstick.use.minecraft.redstone_lamp.*
nerfstick.use.minecraft.ender_chest.*
nerfstick.use.minecraft.dispenser.facing
nerfstick.use.minecraft.dropper.facing
nerfstick.use.minecraft.dried_ghast.facing
nerfstick.use.minecraft.leaf_litter.facing
nerfstick.use.minecraft.wildflowers.facing

---

🌿 Block families (regex-based permissions)

r=nerfstick.use.minecraft.*_chest.*
r=nerfstick.use.minecraft.*_fence.*
r=nerfstick.use.minecraft.*_gate.*
r=nerfstick.use.minecraft.*_glazed_terracotta.*
r=nerfstick.use.minecraft.*_lantern.*
r=nerfstick.use.minecraft.*_leaves.*
r=nerfstick.use.minecraft.*_log.*
r=nerfstick.use.minecraft.*_rail.*
r=nerfstick.use.minecraft.*_repeater.*
r=nerfstick.use.minecraft.*_sign.*
r=nerfstick.use.minecraft.*_stairs.*
r=nerfstick.use.minecraft.*_slab.*
r=nerfstick.use.minecraft.*_trapdoor.*
r=nerfstick.use.minecraft.*_wall.*
r=nerfstick.use.minecraft.*_door.hinge

---

🔄 Fork information

This project is a maintained fork of the original Nerfstick plugin, updated for modern Minecraft versions.

Key improvements:

• Paper 1.21+ compatibility
• Removal of deprecated NMS usage
• Improved permission resolution system
• Safer and more predictable block state validation logic
• Enhanced integration hooks for protection plugins

---

🙏 Credits

Nerfstick was originally created by akdukaan and Reimnop.

• Original GitHub Repository
• Modrinth Project Page

This fork continues development with modern updates and compatibility improvements for Paper 1.21+.