Complete Wiki & Documentation

All commands, permissions, placeholders, and usage tips for ArenaLite

Configuration Basics

Global Message Prefix: Configurable in messages.yml under prefix

Hex Colors: Supported using token format &#RRGGBB

Message Colors: Normal messages use aqua/gray. Errors and no-permission use &#FF0000 (red)

Player Commands

/ffa join <kit>

Join the FFA with a specific kit

/ffa leave

Leave the current arena and return to the lobby

/ffa kit preview <kit>

Preview a kit (read-only when enabled)

Setup & Admin Commands

/ffasetup wand

Get the region selection wand

/ffasetup create <arena>

Create a new arena in your current world

/ffasetup delete <arena>

Delete an arena

/ffasetup setspawn <arena>

Set the arena spawn (must be inside region)

/ffasetup setregen <arena> <true|false>

Toggle scheduled regeneration

/ffasetup build <arena> <true|false>

Toggle building in the arena

/ffasetup list

List all arenas with status summary

/ffasetup kit create <kit>

Create a kit from your current inventory

/ffasetup kit delete <kit>

Delete a kit

/ffasetup kitlink <kit> <arena>

Link a kit to an arena

/ffa setspawn

Set the global FFA lobby spawn (admin only)

/ffa regen <arena>

Manually trigger arena regeneration (admin only)

/ffa reload

Reload plugin configuration and data (admin only)

Regeneration Behavior

Safe Regen: Teleports players inside the arena region to that arena's spawn and locks movement until regen finishes

Performance: Works without FAWE via built-in snapshot restore; FAWE improves performance on large regions

Tuning: Tune performance using regen.blocks-per-tick in config.yml

Permissions

PermissionDescriptionDefault
arenalite.useAccess to basic player commandseveryone
arenalite.adminAccess to all setup/admin commandsOP
arenalite.*Grants both permissions aboveOP

PlaceholderAPI Placeholders

Player Statistics

%arenalite_kills%
%arenalite_deaths%
%arenalite_kdr%
%arenalite_streak%
%arenalite_kit%
%arenalite_arena%

Arena Regeneration

Format: %arenaregen_next_<arena>% - Shows time remaining in MM:SS format

Example: %arenaregen_next_desert%

Returns N/A if arena doesn't exist or regen disabled

Leaderboard Rankings

Format: %arenalite_leaderboard_<type>_<kit>_<position>%

Types: kills, deaths, kdr, streak, player

%arenalite_leaderboard_kills_diamond_1% - Top killer for kit

%arenalite_leaderboard_player_diamond_1% - Top player name

%arenalite_leaderboard_kdr_my_pvp_kit_3% - 3rd highest KDR

Returns N/A if no entry exists at that position

Usage Tips & Best Practices

  • Ensure /ffasetup setspawn <arena> is inside the defined region for proper respawn and safe regen teleport
  • Keep arena regions tight for faster snapshot saves/restores
  • Use /ffasetup list to quickly verify arena configuration
  • After editing messages.yml or configs, run /ffa reload