ArenaLite

A configurable kit-based Free-For-All (FFA) plugin for Paper 1.21+ servers. ArenaLite focuses on a smooth admin workflow, reliable kit handling, and battle-ready defaults that you can tailor through configuration.

Wiki page Click Here

Highlights

• Arena Workflow – Create, list, delete, and configure arenas in-game (/ffasetup create/delete/setspawn/build/setregen/list).
• Kit Management – Save slot-accurate kits from your inventory, link them to arenas, and preview them safely.
• Build Toggles – Per-arena build flags with high-priority listeners ensure your FFA rules override other plugins when players join.
• Safety Options – Join protection and anti-cleanup buffs are fully configurable (or disable them entirely).
• Storage Choices – Player stats persist to YAML by default with optional MySQL support.
• Optional Hooks – Integrates with FastAsyncWorldEdit (FAWE), PlaceholderAPI, and Vault when present.
• Safe Regen – During arena regeneration, players inside the arena are teleported to that arena's set spawn and have movement locked until regen finishes.
• Placeholders & Leaderboards – PlaceholderAPI support for player stats and per-kit leaderboards (see Wiki for full list).

Commands

Player Commands

Command	Description
/ffa join <kit>	Join with the specified kit.
/ffa leave	Leave the arena and return to the lobby spawn.
/ffa kit preview <kit>	View a read-only preview (if enabled).
/ffa kit create <kit>	Create a kit from your inventory (requires arenalite.admin).
/ffa setspawn	Set the global FFA lobby spawn (requires arenalite.admin).
/ffa regen <arena>	Manually trigger a regen (requires arenalite.admin).
/ffa reload	Reload configuration and data (requires arenalite.admin).

Setup Commands (arenalite.admin)

Command	Description
/ffasetup wand	Receive the region selection wand.
/ffasetup create <arena>	Create an arena using your current world.
/ffasetup delete <arena>	Remove an arena (kits linked to it are unlinked).
/ffasetup setspawn <arena>	Set the arena spawn point.
`/ffasetup setregen <arena> <true	false>`
`/ffasetup build <arena> <true	false>`
/ffasetup list	Display arena summary (spawn/regen/build state).
/ffasetup kit create <kit>	Save your current inventory as a kit.
/ffasetup kit delete <kit>	Delete an existing kit.
/ffasetup kitlink <kit> <arena>	Link a kit to an arena.

Configuration Overview

config.yml ships with sensible defaults and is fully documented inline. Key sections:

join-protection:
  enabled: true
  duration: 10            # seconds
  clear-effects: true     # remove potion effects/fire when joining/leaving

anti-cleanup:
  enabled: true
  regen:
    enabled: true
    duration: 3           # seconds
  resistance:
    enabled: true
    duration: 5           # seconds
    level: 2

arenas:
  default-build-enabled: true
  default-regen-enabled: false
  default-regen-interval: 300

settings:
  hotbar-enabled: false
  scoreboard-enabled: true
  kit-previews:
    enabled: true
    readonly: true
  instant-respawn-delay: 1   # ticks

ffa:
  spawn: ""                 # set via /ffa setspawn

storage:
  type: YAML                 # YAML or MYSQL
  mysql:
    host: localhost
    port: 3306
    database: arenalite
    username: root
    password: password
    use-ssl: false
    table-prefix: arenalite_

Additional configuration lives in:

• messages.yml – Fully translatable messages.
• arenas.yml / kits.yml – Generated data stores (editing is optional).

Storage Options

• YAML (default) – Zero setup, perfect for small/medium servers.
• MySQL – Enable in config.yml for asynchronous read/write through the Bukkit scheduler.

Optional Integrations

• FastAsyncWorldEdit – Speeds up and enhances regeneration when present. Without FAWE, ArenaLite uses its built-in snapshot-based regen.
• PlaceholderAPI – Registers %arenalite_*% placeholders automatically.
• Vault – Foundation for upcoming economy rewards (hook loads when Vault is present).

Installation

1. Drop the plugin into your plugins/ directory.
2. Start the server once to generate configuration files.
3. Adjust config.yml, messages.yml, and the data files as needed.
4. Use the /ffasetup commands to create arenas and kits.

Permissions

• arenalite.use – Access to player commands (default: everyone).
• arenalite.admin – Access to setup/admin commands (default: OP).
• arenalite.* – Grants both of the above.

Useful Links

• docs/SETUP.md – Step-by-step arena & kit setup.
• docs/REGEN.md – How safe regeneration works and how to configure it.
• docs/API.md – Working with ArenaLite in your own plugins.
• docs/PERFORMANCE.md – Tuning advice for larger servers.
• docs/Wiki.md – Commands, permissions, placeholders, and usage tips.

Building From Source

git clone <repository-url>
cd ArenaLite
mvn clean package

The compiled JAR is produced in target/.

License & Support

ArenaLite is released under the MIT License. If you run into issues:

1. Check the documentation.
2. Search existing GitHub issues.
3. Open a new issue with reproduction steps and server logs.

Enjoy the fights!