Web Editor Overview

The HyperPerms web editor is a visual interface for managing your server's permissions. Edit groups, users, and tracks from your browser without memorizing commands.

What is the Web Editor?

The web editor is a browser-based tool that provides a graphical interface for managing your HyperPerms configuration. It connects to your server through secure sessions, allowing you to:

  • View and modify all your groups and their permissions
  • Manage user-specific permissions and group memberships
  • Create and organize promotion tracks
  • Preview changes before applying them
  • See the inheritance structure visually

Key Features

Group Management

Create, edit, and delete groups with a visual interface

User Management

Manage player permissions and group assignments

Inheritance Visualization

See how groups inherit from each other

Change Preview

Review all changes before applying

Safe Editing

Changes aren't applied until you confirm

Self-Hostable

Run your own instance for full control

When to Use the Web Editor

Web Editor is Best For:

  • Initial setup - Creating your first groups and permissions
  • Bulk changes - Adding many permissions at once
  • Restructuring - Reorganizing your group hierarchy
  • Visual review - Understanding your current configuration
  • Complex edits - Changes involving multiple groups

Commands are Best For:

  • Quick changes - Single permission changes
  • Player management - Promoting/demoting players
  • Scripting - Automated permission management
  • In-game adjustments - Changes while playing

How It Works

1. Create a Session

Run the editor command in-game or from console:

text
/hp editor

[HyperPerms] Web editor session created!
[HyperPerms] Click to open: https://hyperperms.dev/editor/abc123xyz
[HyperPerms] Session expires in 24 hours.

2. Open the Editor

Click the link or copy it to your browser. Your current permission data is loaded automatically.

3. Make Changes

Use the visual interface to edit groups, permissions, users, and tracks. All changes are tracked but not applied yet.

4. Review and Apply

Preview your changes, then copy the apply command from the editor and run it on your server:

text
/hp apply abc123xyz789

[HyperPerms] Changes applied successfully!

Browser Requirements

The web editor works in all modern browsers:

  • Chrome / Chromium (recommended)
  • Firefox
  • Safari
  • Edge
JavaScript must be enabled. The editor is a client-side React application that requires JavaScript to function.

Security

The web editor is designed with security in mind:

  • Session-based access - Each session has a unique, random ID
  • Time-limited - Sessions expire after 24 hours
  • No credentials stored - Session data is deleted after expiration
  • HTTPS encryption - All data is encrypted in transit
  • Self-hostable - Run your own instance for maximum control
For maximum security, self-host the web editor on your own infrastructure. See the self-hosting guide.

Interface Overview

Sidebar Navigation

The left sidebar provides navigation between groups, users, and tracks. Use it to switch between different management views.

Main Editor Area

The central area shows details for the selected item. Here you can edit permissions, properties, and relationships.

Changes Panel

The right panel (or bottom on mobile) shows pending changes. This lets you review what will be modified when you apply.

Limitations

The web editor has some limitations to be aware of:

  • No real-time sync - Changes made via commands while editor is open won't appear
  • Session timeout - Sessions expire after 24 hours
  • Single session - Only one person should edit at a time
  • Network required - Requires internet connection (or network to self-hosted instance)

Getting Started

Ready to use the web editor? Check out these guides: