promotional bannermobile promotional banner
premium banner

PermNodes

A modular permission management mod for NeoForge

Description

🧩 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