ReMorphed Permission System
Kill mobs to transform into them!
ReMorphed supports permission plugins like LuckPerms and PermissionsEx for both Fabric and NeoForge platforms. This document outlines all available permission nodes and their functionality.
Platform Support
- NeoForge: Uses built-in PermissionAPI (works automatically)
- Fabric: Uses Fabric Permissions API (requires separate mod installation)
⚠️ IMPORTANT FOR FABRIC SERVERS
Fabric servers MUST install the Fabric Permissions API mod separately!
- Download from: https://modrinth.com/mod/fabric-permissions-api
- Place
fabric-permissions-api.jarin your server’smods/folder - Without this mod, permissions will not work on Fabric servers
- NeoForge servers do not need this - permissions work automatically
Implementation Status
✅ Fully Working
- Unlock/Morph Permissions: Players can only unlock and morph into entities they have permission for
- Command Permissions: Granular
.selfvs.otherscommand permissions work correctly
Quick Start
Enable Permission System
IMPORTANT: Permissions are disabled by default. To enable the permission system:
- For Fabric servers: Install Fabric Permissions API mod first!
- Set
usePermissions = truein your ReMorphed config file - Restart your server
- Configure permissions using your permission plugin (LuckPerms, etc.)
For NeoForge Servers
Permissions work automatically once enabled.
For Fabric Servers
REQUIRED: Install Fabric Permissions API mod first!
After installing the API mod and enabling permissions, permissions will be automatically discovered by LuckPerms when first used. No manual registration needed!
How Permissions Work
When usePermissions = true (Permission System Enabled):
- Unlocking: Players can only unlock entities they have permission for
- Morphing: Players can only morph into entities they have permission for
- Command Access:
/remorphedcommands (addShape, clearShapes, etc.) require.selfand.otherspermissions
When usePermissions = false (Default Behavior):
- Uses original server config behavior
- No permission checks are performed
- All players follow the same rules based on server config
Important: Selector Permission + Granular Control
Commands use EntityArgument.players() which requires the minecraft.selector.* permission for player name targeting. This provides proper autocomplete functionality.
Complete Solution: Grant both selector permission AND specific command permissions:
# REQUIRED: Grant selector permission (required for player name targeting and autocomplete)
/lp user <player> permission set minecraft.selector.* true
# Grant specific command permissions (controls what they can actually do)
/lp user <player> permission set remorphed.command.clearShapes.self true # Only on themselves
# OR
/lp user <player> permission set remorphed.command.clearShapes.others true # Only on others
# OR
/lp user <player> permission set remorphed.command.clearShapes true # On anyone (fallback)
How it works:
minecraft.selector.*- Allows using player names in commands (required by Minecraft for autocomplete)remorphed.command.clearShapes.self- Allows clearing shapes only on themselvesremorphed.command.clearShapes.others- Allows clearing shapes only on other playersremorphed.command.clearShapes- Allows clearing shapes on anyone (fallback)
Autocomplete: With minecraft.selector.* permission, players get proper autocomplete for player names when typing commands.
Permission Nodes
Core Access
| Permission | Description | Default |
|---|---|---|
remorphed.morph | Basic morphing functionality | Operator (level 2+) |
remorphed.bypass.lock | Bypass transform lock when enabled | Operator (level 2+) |
Commands
All /remorphed commands support granular permission control with .self and .others variants:
| Permission | Command | Description |
|---|---|---|
remorphed.command.addShape | /remorphed addShape | Basic permission (works on anyone) |
remorphed.command.addShape.self | /remorphed addShape | Can only add shapes to themselves |
remorphed.command.addShape.others | /remorphed addShape | Can add shapes to other players |
remorphed.command.removeShape | /remorphed removeShape | Basic permission (works on anyone) |
remorphed.command.removeShape.self | /remorphed removeShape | Can only remove their own shapes |
remorphed.command.removeShape.others | /remorphed removeShape | Can remove shapes from other players |
remorphed.command.clearShapes | /remorphed clearShapes | Basic permission (works on anyone) |
remorphed.command.clearShapes.self | /remorphed clearShapes | Can only clear their own shapes |
remorphed.command.clearShapes.others | /remorphed clearShapes | Can clear shapes from other players |
remorphed.command.hasShape | /remorphed hasShape | Basic permission (works on anyone) |
remorphed.command.hasShape.self | /remorphed hasShape | Can only check their own shapes |
remorphed.command.hasShape.others | /remorphed hasShape | Can check shapes of other players |
remorphed.command.addSkin | /remorphed addSkin | Basic permission (requires SkinShifter) |
remorphed.command.addSkin.self | /remorphed addSkin | Can only add skins to themselves |
remorphed.command.addSkin.others | /remorphed addSkin | Can add skins to other players |
remorphed.command.removeSkin | /remorphed removeSkin | Basic permission (requires SkinShifter) |
remorphed.command.removeSkin.self | /remorphed removeSkin | Can only remove their own skins |
remorphed.command.removeSkin.others | /remorphed removeSkin | Can remove skins from other players |
remorphed.command.clearSkins | /remorphed clearSkins | Basic permission (requires SkinShifter) |
remorphed.command.clearSkins.self | /remorphed clearSkins | Can only clear their own skins |
remorphed.command.clearSkins.others | /remorphed clearSkins | Can clear skins from other players |
remorphed.command.hasSkin | /remorphed hasSkin | Basic permission (requires SkinShifter) |
remorphed.command.hasSkin.self | /remorphed hasSkin | Can only check their own skins |
remorphed.command.hasSkin.others | /remorphed hasSkin | Can check skins of other players |
Entity Types
Control access to specific mob types for both unlocking and morphing:
| Permission | Description | Example |
|---|---|---|
remorphed.type.<entity_id> | Unlock and morph into specific entity | remorphed.type.minecraft:zombie |
Common Entity Permissions:
remorphed.type.minecraft:zombie- Zombiesremorphed.type.minecraft:skeleton- Skeletonsremorphed.type.minecraft:creeper- Creepersremorphed.type.minecraft:enderman- Endermenremorphed.type.minecraft:ender_dragon- Ender Dragon
Commands
/remorphed list-permissions
Lists all available permissions with copy-paste LuckPerms commands.
Note: Only server operators (OP level 2+) can run this command.
Configuration Examples
LuckPerms Setup Examples
Example 1: Regular Player (Self-Only)
# Basic permissions
/lp user <player> permission set remorphed.morph true
/lp user <player> permission set remorphed.type.minecraft:zombie true
# REQUIRED: Grant selector permission
/lp user <player> permission set minecraft.selector.* true
# Self-only command permissions (can only use commands on themselves)
/lp user <player> permission set remorphed.command.clearShapes.self true
/lp user <player> permission set remorphed.command.removeShape.self true
Example 2: Helper (Others-Only)
# Basic permissions
/lp user <helper> permission set remorphed.morph true
/lp user <helper> permission set remorphed.type.* true
# REQUIRED: Grant selector permission
/lp user <helper> permission set minecraft.selector true
# Others-only command permissions (can only use commands on other players)
/lp user <helper> permission set remorphed.command.addShape.others true
/lp user <helper> permission set remorphed.command.clearShapes.others true
Example 3: Moderator (Both Self and Others)
# Basic permissions
/lp user <mod> permission set remorphed.morph true
/lp user <mod> permission set remorphed.type.* true
# REQUIRED: Grant selector permission
/lp user <mod> permission set minecraft.selector true
# Both self and others permissions
/lp user <mod> permission set remorphed.command.*.self true
/lp user <mod> permission set remorphed.command.*.others true
Example 4: Admin (Full Access)
# Admin full access
/lp group admin permission set remorphed.* true
# REQUIRED: Grant selector permission
/lp user <player> permission set minecraft.selector.* true
Wildcard Permissions
| Permission | Description |
|---|---|
remorphed.* | All ReMorphed permissions |
remorphed.type.* | All entity type permissions |
remorphed.command.* | All command permissions (basic) |
remorphed.command.*.self | All self-only command permissions |
remorphed.command.*.others | All others command permissions |
Troubleshooting
Common Issues
- Permissions not working on Fabric: * *Install Fabric Permissions API mod first!**
- Can’t morph: Check
remorphed.morphpermission - Can’t unlock specific mob: Check
remorphed.type.<entity_id>permission - Can’t morph into specific mob: Check
remorphed.type.<entity_id>permission - Commands not working: Check
remorphed.command.<command>permission - Can’t use command on self: Check
remorphed.command.<command>.selfpermission - Can’t use command on others: Check
remorphed.command.<command>.otherspermission - “Selector not allowed” error: Grant
minecraft.selector.*permission (works with Vanilla Permissions mod) - Permissions not showing in LuckPerms GUI: Permissions are automatically discovered when first used. If they don’t appear, ensure Fabric Permissions API is installed and restart the server.
- Can’t transform despite permissions: Check if you have the required entity type permissions
Debug Commands
/remorphed list-permissions- Lists all permissions with copy-paste commands
Platform Differences
- NeoForge: Permissions work automatically with built-in PermissionAPI
- Fabric: Permissions are automatically discovered when first used (requires Fabric Permissions API mod)
Default Behavior
If no permission plugin is installed, ReMorphed falls back to operator permissions (level 2+). All permission checks return true for operators and false for regular players.
