Getting Started Configuration Commands Troubleshooting

Commands & Permissions

Complete guide to all available commands and permission nodes

📝 Command Overview

Command Permission Description
/server velocitynexus.server Open GUI or connect to server
/velocitynexus velocitynexus.info Show plugin information
/velocitynexus reload velocitynexus.admin Reload configuration
/velocitynexus version velocitynexus.info Show plugin version

🖥️ /server Command

The main command for opening the server selector GUI or connecting directly.

Usage

Commands 
/server                    # Opens the GUI
/server hub                # Connects directly to "hub" server
/server survival           # Connects directly to "survival" server

Behavior

  • No arguments: Opens the server selector GUI
  • With server name: Connects directly to that server (bypasses GUI)
  • Invalid server: Shows error message
  • Same server: Shows "You are already connected to this server"

Permission

Permission Node 
velocitynexus.server

Default: Everyone has access by default

Examples with Screenshots

Opening the GUI

Chat 
Player: /server
[GUI opens with all configured servers]

Direct Connect

Chat 
Player: /server survival
[Connected to survival server]

⚙️ /velocitynexus Command

Administrative commands for managing the plugin.

Subcommands

1. Show Information

Command 
/velocitynexus
/velocitynexus info

Permission: velocitynexus.info (default: everyone)

Description: Shows plugin version, author, and basic information

2. Reload Configuration

Command 
/velocitynexus reload

Permission: velocitynexus.admin (default: operators only)

Description: Hot-reloads the config.toml without restarting the server

Hot Reload Benefits

Update your configuration instantly without any downtime! Perfect for testing changes or adding new servers on the fly.

3. Show Version

Command 
/velocitynexus version

Permission: velocitynexus.info (default: everyone)

Description: Shows the current plugin version number

🔐 Permission System Explained

Permission Nodes

Permission Default Description
velocitynexus.server Everyone Access to /server command
velocitynexus.info Everyone View plugin information and version
velocitynexus.admin Operators Reload configuration and admin commands
velocitynexus.server.<name> None (Optional) Access to specific server (e.g., velocitynexus.server.vip)

Per-Server Permissions (Optional)

You can restrict specific servers to certain players/groups:

Permission Format 
velocitynexus.server.<servername>

# Examples:
velocitynexus.server.vip       # Access to VIP server
velocitynexus.server.staff     # Access to staff server
velocitynexus.server.donator   # Access to donator server
Per-Server Permissions Are Optional

By default, all players with velocitynexus.server can see all servers. Only add per-server permissions if you want to restrict certain servers to specific groups.

🎯 LuckPerms Setup Tutorial

Complete guide to setting up permissions with LuckPerms (the recommended permission plugin).

1. Install LuckPerms

If you don't have LuckPerms yet:

  1. Download from luckperms.net/download
  2. Install on your Velocity proxy (plugins folder)
  3. Restart Velocity

2. Give Everyone Basic Access

Allow all players to use the /server command:

Velocity Console 
/lp group default permission set velocitynexus.server true
Default Permission

This command gives all players permission to open the GUI and connect to servers. This should be your first step!

3. Set Up Admin Permissions

Give operators/admins permission to reload the config:

Velocity Console 
# Create admin group (if not exists)
/lp creategroup admin

# Give admin all Velocity Nexus permissions
/lp group admin permission set velocitynexus.* true

# Add yourself to admin group (replace YourUsername)
/lp user YourUsername parent add admin

4. Create VIP Server Permissions

Example: Restrict a "VIP" server to VIP rank holders:

Velocity Console 
# Create VIP group (if not exists)
/lp creategroup vip

# Give VIP group access to VIP server
/lp group vip permission set velocitynexus.server.vip true

# Add player to VIP group (replace PlayerName)
/lp user PlayerName parent add vip

Now only players with the VIP rank can see and access the VIP server in the GUI!

5. Verify Permissions

Check what permissions a player has:

Commands 
# Check user's permissions
/lp user PlayerName permission info

# Check user's groups
/lp user PlayerName info

# Test a specific permission
/lp user PlayerName permission check velocitynexus.server.vip

📖 Permission Examples

Example 1: Simple Network

Setup: Everyone can access all servers, admins can reload

LuckPerms Commands 
# Give all players access
/lp group default permission set velocitynexus.server true

# Give admins reload permission
/lp group admin permission set velocitynexus.admin true

Example 2: VIP-Only Server

Setup: Regular players see hub/survival, VIPs also see premium server

LuckPerms Commands 
# Everyone can use /server
/lp group default permission set velocitynexus.server true

# VIP group can access premium server
/lp group vip permission set velocitynexus.server.premium true

# Donator group can also access it
/lp group donator permission set velocitynexus.server.premium true

Example 3: Staff-Only Server

Setup: Hidden staff server only visible to staff members

LuckPerms Commands 
# Everyone can use GUI
/lp group default permission set velocitynexus.server true

# Staff group can see staff server
/lp group staff permission set velocitynexus.server.staff true

# Staff also have admin commands
/lp group staff permission set velocitynexus.admin true

Example 4: Multiple Rank Tiers

Setup: Different servers for each rank tier

LuckPerms Commands 
# Everyone: hub, survival, minigames
/lp group default permission set velocitynexus.server true

# VIP: +vip_lobby
/lp group vip permission set velocitynexus.server.vip_lobby true

# MVP: +mvp_lobby, +exclusive_games
/lp group mvp permission set velocitynexus.server.mvp_lobby true
/lp group mvp permission set velocitynexus.server.exclusive_games true

# MVP+ inherits from MVP
/lp group mvpplus parent add mvp

🔧 Troubleshooting Permissions

Problem: Player can't use /server

Error: "You don't have permission to use this command"

Solution: Grant the base permission:

Command 
/lp group default permission set velocitynexus.server true

Problem: Player can't see specific server

Issue: Server is hidden in GUI for certain players

Check if per-server permission is set:

Command 
/lp user PlayerName permission check velocitynexus.server.vip

Grant access if needed:

Command 
/lp user PlayerName permission set velocitynexus.server.vip true

Problem: Admin can't reload config

Error: "You don't have permission to reload"

Solution: Grant admin permission:

Command 
/lp user YourUsername permission set velocitynexus.admin true

✅ Permissions Configured!

Need help with issues? Check the troubleshooting guide

Troubleshooting Guide