Verge

# 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 ` | 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 create` | Create a new permission group. | verge.admin | | `/verge group delete` | Delete an existing permission group. | verge.admin | | `/verge 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.admin | | `/verge group parent add|remove ` | Manage group inheritance parents. | verge.admin | | `/verge group meta setprefix|setsuffix|setweight ` | Manage group metadata (prefix, suffix, weight). | verge.admin | | `/verge user info` | Display player permission info and group memberships. | verge.admin | | `/verge user permission set|unset [val]` | Manage per-user permission overrides. | verge.admin | | `/verge user parent add|remove ` | Manage user group memberships. | verge.admin | | `/verge user setprimary ` | Set a player's primary permission group. | verge.admin | | `/verge user meta setprefix|setsuffix ` | Manage per-user prefix and suffix overrides. | verge.admin | ## 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: ```yaml # 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: ```yaml # 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](https://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