Skip to main content

​
Commands

​
Player Commands

All players can use these without any special permissions.

​
/lvl gui

Opens the stats management GUI where you can:
  • View your current level and experience
  • See available stat points
  • Allocate stat points to different stats
  • View your current stat allocations
Usage: /lvl gui

​
/lvl info

Displays comprehensive information about:
  • All available stats
  • Current stat point value per allocation
  • All available commands (player and admin)
  • Admin commands (if you have OP permission)
Usage: /lvl info

​
Admin Commands

These commands require OP (Operator) permission.

​
/lvl setlevel <player> <level>

Sets a player’s level directly. This will:
  • Set the player to the specified level
  • Reset XP to 0
  • Set available stat points to (level − 1) × StatPointsPerLevel (correct total for that level)
  • Clear all allocated stats
  • Remove claimed reward levels above the new level (so the player can reclaim those rewards when they reach the level again)
  • Remove all stat modifiers
  • Update the HUD display
Usage: /lvl setlevel PlayerName 50
ParameterDescription
<player>Username of the target player (online or offline)
<level>Level to set (1–MaxLevel)
Works for online and offline players. Offline players are updated in universe/players/; success message shows (offline).

​
/lvl setreset <player> <amount>

Sets a player’s reset points (used for the RESET ALL button in the Stats GUI). Reset points can also be earned from level rewards in LevelRewardsConfig.json. Usage: /lvl setreset PlayerName 5
ParameterDescription
<player>Username of the target player (online or offline)
<amount>Number of reset points to set (0 or more)
Works for online and offline players. Offline players are updated in universe/players/; success message shows (offline).

​
/lvl setpoints <player> <points>

Sets a specific player’s available stat points directly. Usage: /lvl setpoints PlayerName 100
ParameterDescription
<player>Username of the target player (online or offline)
<points>Number of available stat points to set
Works for online and offline players. Offline players are updated in universe/players/; success message shows (offline).

​
/lvl setclasstier <player> <class> <tier>

Sets a player’s class tier (0–4) for a specific class. Useful for testing or granting tier progress without kills. Argument order matches other admin commands (player first). Usage: /lvl setclasstier Zuxaw archery 4
ParameterDescription
<player>Username of the target player (online or offline)
<class>Class id, case-insensitive (e.g. archery, Arcane, Heavy)
<tier>Tier to set (0–4)
Works for online and offline players. Offline players are updated in universe/players/; success message shows (offline). Requires the class system to be enabled.

​
/lvl addxp <player> <xp>

Adds experience points to a specific player. This will:
  • Add the specified XP amount
  • Automatically handle level ups if enough XP is gained
  • Award stat points on level up
  • Update the HUD display
  • Send level up notifications
Usage: /lvl addxp PlayerName 500.5
ParameterDescription
<player>Username of the target player (must be online)
<xp>Amount of XP to add (must be > 0)
Add XP only works for online players (in-memory store).

​
/lvl reload

Reloads all config files from disk so that changes take effect without restarting the server. Reloads:
  • ZoneLevelConfig.json — zone levels and entity overrides
  • InstanceLevelConfig.json — instance levels and entity overrides
  • LevelRewardsConfig.json — level rewards (items and reset points)
  • MessagesLanguageMapping.json — messages and translations
  • RPGLevelingConfig.json — main plugin config (max level, XP, HUD, etc.)
  • StatsLevelConfig.json — stats (points per level, stat caps, etc.)
  • DatabaseConfig.json — database sync settings (in-memory only; DB connection changes require restart)
Usage: /lvl reload

​
/lvl resetstats <player>

Resets a player’s allocated stats. This will:
  • Clear all allocated stat points
  • Return all allocated points to the available stat points pool
  • Remove all stat modifiers
  • Allow the player to reallocate their points
Usage: /lvl resetstats PlayerName
ParameterDescription
<player>Username of the target player (online or offline)
Works for online and offline players. Offline players are updated in universe/players/; success message shows (offline).

​
/lvl resetstatsall

Resets only allocated stats for all players, both online and offline. Level and XP are not changed. For each player:
  • All allocated stat points are cleared
  • Available stat points are set to (level − 1) × StatPointsPerLevel (from StatsLevelConfig.json)
  • Stat modifiers are removed; Health/Stamina etc. are clamped to base
Use this when you want everyone to reallocate their stats (e.g. after a stat rebalance) without resetting levels or XP. Usage: /lvl resetstatsall — no arguments. Reports how many online and offline players were updated.

​
/lvl resetall

Resets level and stats for all players, both online and offline. Each affected player is set to:
  • Level 1, 0 XP
  • 0 available stat points, all allocated stats cleared
  • Claimed reward levels cleared
  • Reset points set to 0
  • Online players: Updated in-memory (Store/Holder); Hytale persists on save.
  • Offline players: Updated by modifying their JSON files in universe/players/, same as the leaderboard.
Usage: /lvl resetall — no arguments. Reports how many online and offline players were reset.