🧩 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

Requirements
- Minecraft 1.21.8+
- NeoForge 21.8.46+
- (optional) LuckPerms mod
Install
- Download the file permnodes-x.x.x.jar
- Place it in your server’s mods/ directory
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