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