🧩 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_playersand 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
- Download the file
Run
- Start the server and verify the log:
[PermNodes] Mod loaded successfully.
- Start the server and verify the log:
🔑 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_defaultnodes 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
The PermNodes Team
