Verge
by Minedream Team
Verge is a lightweight, high-performance permission management plugin for Spigot/Paper servers. It includes a powerful web-based editor for rapid administrative changes, a permission inheritance system for building complex group hierarchies, and a built-in chat formatter that resolves prefixes, suffixes, and group memberships.
Key Features
- Live Web Editor — Generate a secure link (
https://verge.mine-dream.org) to edit your server's permissions, groups, and prefixes in an interactive web UI. Changes sync back to the server in real-time. - Permission Inheritance — Nest groups and build complex parent-child permission hierarchies with automatic resolution.
- Built-in Chat Formatter — Includes a high-performance chat formatter that resolves prefixes, suffixes, and group memberships for your server's chat messages.
- Comprehensive Permission System — Supports wildcard permissions (
*), negative permissions, and per-group or per-user overrides. - Interactive Tutorial — Built-in tutorial system (
/verge tutorial) to guide administrators through setting up permissions. - Lightweight & Efficient — Designed to have minimal impact on server performance, even with large permission sets.
Commands
| Command | Description | Permission |
|---|---|---|
/verge |
Display help and command list. | verge.use |
/verge reload |
Reload config and groups data from disk. | verge.admin |
/verge editor |
Open a web editor session and receive a secure link. | verge.admin |
/verge applyeditor <key> |
Apply pending web editor changes manually. | verge.admin |
/verge tutorial |
Start the interactive permission setup tutorial. | verge.admin |
/verge group list |
List all registered permission groups. | verge.admin |
/verge group <group> create |
Create a new permission group. | verge.admin |
/verge group <group> delete |
Delete an existing permission group. | verge.admin |
/verge group <group> info |
Display group details, parents, and permissions. | verge.admin |
| `/verge group permission set | unset [val]` | Set or unset a permission node on a group. |
| `/verge group parent add | remove ` | Manage group inheritance parents. |
| `/verge group meta setprefix | setsuffix | setweight ` |
/verge user <user> info |
Display player permission info and group memberships. | verge.admin |
| `/verge user permission set | unset [val]` | Manage per-user permission overrides. |
| `/verge user parent add | remove ` | Manage user group memberships. |
/verge user <user> setprimary <group> |
Set a player's primary permission group. | verge.admin |
| `/verge user meta setprefix | setsuffix ` | Manage per-user prefix and suffix overrides. |
Permissions
| Permission Node | Description | Default |
|---|---|---|
verge.use |
Allow viewing Verge status and help. | All players |
verge.admin |
Full administrative access to Verge permissions, groups, and commands. | OP |
Configuration
config.yml
Configure the built-in chat formatter, default group assignment, and debugging options:
# Verge Configuration
# Enable or disable Verge's built-in chat formatter
formatter-enabled: true
# Chat format (supports prefixes, suffixes, usernames, and color codes)
chat-format: "{prefix}{player}{suffix}&7: &f{message}"
# The name of the default group assigned to new users
default-group: "default"
# Enables debug logging in the console
debug: false
groups.yml
Define permission groups with weights, prefixes, inheritance parents, and permission nodes:
# Verge Group Data
default:
weight: 1
prefix: "&7[Member] &7"
suffix: ""
parents: []
permissions:
verge.use: true
admin:
weight: 100
prefix: "&c[Admin] &f"
suffix: ""
parents:
- default
permissions:
"*": true
Web Editor
Verge includes a fully-featured web-based permission editor available at verge.mine-dream.org. Run /verge editor in-game to generate a secure session link. The web editor allows you to:
- View and manage all permission groups and their members
- Add, remove, and toggle permission nodes
- Configure group inheritance hierarchies with drag-and-drop parents
- Edit group and user metadata (prefixes, suffixes, weights)
- Manage per-user permission overrides
- Changes sync back to your server in real-time
