🧩 PermNodes

A modular permission management mod for NeoForge 1.21.8+
Author: cptgummiball • License: MIT

---

📖 Overview

PermNodes is a lightweight, server-side permission control mod for NeoForge 21.8.46+.
It integrates with LuckPerms (optional) to allow granular control over player actions such as block placement, breaking, crafting, interactions, PvP, animals, crops, and more.

💡 Ideal for modded servers, roleplay setups, or controlled community environments.

---

⚙️ Features

• 🔒 LuckPerms Integration (optional – graceful fallback if not present)
• 🧱 Blocks: fine-grained place / break permissions with tag support
• 🧰 Recipes: restrict crafting outputs
• 🎒 Items: use.* permissions for item usage
• 🚪 Interactions: interact.* for chests, doors, buttons, levers, anvils, etc.
• 🔥 Ignition: ignite.* for TNT and fire
• 🌀 Portals: portal.* for dimension access
• ⚔️ PvP: pvp.attack_players and global toggles
• 🐄 Animals: breed, milk, shear, lead, name_tag, attack
• 🏠 Villagers: ineract (trade), attack
• 🌾 Crops: harvest, trample, seed
• 🌊 Fluids: pickup and place control
• 👾 Monsters: restrict attacking hostile mobs
• 🧩 Mod-wide bypass: mod.allow.<modid>

---

🔧 Installation

1. Requirements

   • Minecraft 1.21.8+
   • NeoForge 21.8.46+
   • (optional) LuckPerms mod

2. Install

   • Download the file permnodes-x.x.x.jar
   • Place it in your server’s mods/ directory

3. Run

   • Start the server and verify the log:

     [PermNodes] Mod loaded successfully.
     

---

🔑 Permission Nodes

Category	Examples
Blocks	blocks.place.minecraft.dirt, blocks.break.tag.minecraft.logs
Items	use.minecraft.bucket, use.*
Interactions	interact.minecraft.chest, interact.*
Recipes	recipes.craft.minecraft.torch, recipes.craft.*
Portals	portal.minecraft.the_nether
PvP	pvp.attack_players
Animals	animals.breed, animals.milk
Crops	crops.harvest, crops.trample
Fluids	fluids.place, fluids.pickup
Monsters	monsters.attack.minecraft.creeper
Mods (global)	mod.allow.minecraft, mod.allow.create

Permission reference

🟢 LuckPerms handles wildcards automatically.
🟡 Without LuckPerms, .allow_default nodes act as fallbacks.

---

⚙️ LuckPerms Integration Notice

LuckPerms does not currently display or auto-discover permissions from NeoForge mods.
All permission checks in PermNodes use plain string-based nodes (e.g., blocks.place.minecraft.dirt, use.minecraft.bucket).
These nodes are fully compatible with LuckPerms — they can be assigned, inherited, and checked normally — but they will only appear in the LuckPerms web editor after they have been explicitly created or used (for example, once a permission is checked in-game or manually added to a group).

If you want a predefined list of all available PermNodes permissions to appear in LuckPerms, you can create a template group containing the desired nodes.
This feature may be automated in a future update.

---

❤️ Credits

• cptgummiball – Development, design & documentation
• Lucko & Contributors – LuckPerms API
• NeoForge Team – Modding framework