RegionPerms

Description

RegionPerms is a lightweight yet powerful permission management plugin for Hytale servers 🧩
It allows server administrators to control what players can do based on who they are and where they are—globally, per world, or inside specific regions.

Permissions are applied at three different levels:

• Groups (server-wide defaults) 🌍

• World-specific overrides 🌐

• Region-specific overrides 📦

The system follows a simple and predictable rule:

Region > World > Group

This means the closest scope always wins, letting you keep clean global defaults while customizing behavior in specific worlds or areas like spawns, shops, event zones, or protected regions.

🖥️ In-Game GUI

RegionPerms includes a dedicated in-game GUI that allows admins to manage everything without editing files or restarting the server.

The GUI is divided into 4 main tabs, each with a specific role:

👥 Groups Tab

Manage groups and their members.

• View all existing groups

• Create or delete groups

• Add or remove players from a group

🌍 Server Tab (Global Permissions)

Manage permissions that apply everywhere.

• Select a target group

• Add or remove global permission nodes for that group

🌐 Worlds Tab

Define permission overrides for a group in a specific world.

• Select a world and a group

• Add or remove world-specific permissions

• Propagate global permissions to the world as overrides

📦 Regions Tab

Create and manage region-based permissions.

• View all regions (RegionName (WorldName))

• Define region boundaries using two positions

• Assign group-specific permissions that apply only inside the region

Propagate global permissions to the region

📍 Regions & Selection

To define a region, you first set two positions (current block or explicit coordinates):

Then manage regions with:

Add or remove region-specific permissions:

🌐 World Overrides

Manage permissions that apply only within a specific world:

👥 Groups Management

Create groups and manage their permissions:

👤 User Management

Assign users to groups or inspect their setup:

🔐 Permission Nodes

These are the permission nodes enforced by RegionPerms:

• block.break – Allows breaking blocks

• block.place – Allows placing blocks

• interact.use – Allows interacting with blocks

• chat.use – Allows chatting

• command.use – Allows running commands

• perm.admin – Full access to RegionPerms commands and GUI

Notes:

• * grants all permissions

• Users with perm.admin can always access /perm commands

⚙️ Configuration Files

All data is stored in simple YAML files inside the plugin data folder:

• groups.yml – Group definitions and global permissions

• users.yml – Player-to-group assignments

• regions.yml – World regions, boundaries, and overrides

🧠 Permission Resolution Logic

When a permission check occurs, RegionPerms evaluates permissions in this order:

1. Region permissions (if the player is inside a region)

2. World permissions (if defined for that world)

3. Group permissions (server-wide defaults)

This guarantees consistent and predictable behavior across your server.

🚀 Designed for Server Owners

RegionPerms is built to be:

• Easy to use for beginners

• Powerful enough for advanced setups

• Maintainable over time

• Perfect for multi-world and region-heavy servers

Whether you need simple group permissions or advanced region-based control, RegionPerms has you covered 💙