Troubleshooting

# Check if HyperPerms is loaded correctly
/hp info

# View a player's permission state
/hp user info <player>

# Enable verbose mode to see permission checks in real-time
/hp verbose

# Check a specific permission
/hp check <player> <permission>

# View the inheritance tree
/hp debug tree <group>

# See active contexts for a player
/hp debug contexts <player>

# Debug permission resolution
/hp debug resolve <player> <permission>

# This shows exactly how the permission is resolved,
# including which group or user setting provides the value

# Compare user info between working and non-working players
/hp user info <working_player>
/hp user info <broken_player>

# Check if they're in the same groups
# Look for differences in primary group or group list

# If you have "plugin.*" but "plugin.specific" doesn't work:

# Check if it's explicitly denied
/hp check <player> plugin.specific

# The specific permission might be set to false somewhere
# which overrides the wildcard

# Check user's primary group and prefix settings
/hp user info <player>

# Set a specific group as primary to force its prefix
/hp user setprimarygroup <player> <group>

# Or set a custom prefix for the user
/hp user setprefix <player> "&c[Custom] "

# Check config.json
{
  "chat": {
    "enabled": true,  // Must be true
    "format": "%prefix%%player%%suffix%: %message%"
  }
}

# Check the group has a prefix
/hp group info <group>

# Use & not § for color codes
Correct: &c[Admin]
Wrong:   §c[Admin]

# For player chat colors, they need permission:
/hp user setperm <player> hyperperms.chat.color true

# View the inheritance tree
/hp debug tree <group>

# Check parent relationships
/hp group info <group>

# Verify parent group exists and has permissions
/hp group info <parent_group>

# This will fail:
/hp group parent add admin mod
/hp group parent add mod admin  # Error: circular inheritance

# Fix by reviewing your hierarchy structure
/hp debug tree admin

# Force save all data
/hp save

# Check console for error messages

# Verify file permissions on the data directory
# The server needs read/write access to plugins/HyperPerms/data/

# Common MySQL errors and solutions:

# "Connection refused"
- Check MySQL server is running
- Verify host and port in config.json
- Check firewall rules

# "Access denied"
- Verify username and password
- Check user has permissions on the database

# "Unknown database"
- Create the database first: CREATE DATABASE hyperperms;
- Grant permissions: GRANT ALL ON hyperperms.* TO 'user'@'host';

# Force sync from database
/hp sync

# Ensure all servers use the same:
# - Database host/name
# - Table prefix (if configured)

# Check each server's config.json has identical storage settings

# Clear and rebuild cache
/hp reload

# Or for a specific player, have them relog

# Reduce cache expiry time if needed
"cache": {
  "expirySeconds": 60  // Shorter cache time
}

# Generate a new session
/hp editor

# Sessions expire after 24 hours
# You may need to create a new one

# Check the webEditor URL in config
{
  "webEditor": {
    "url": "https://www.hyperperms.com"
  }
}

# Make sure to copy and run the apply command from the editor
/hp apply <session_code>

# The apply command must be run from the server console or in-game
# It cannot be done from the web editor itself