ArenaLite

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

Setup Commands (arenalite.admin)

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!