NovaFFA | Free For All Plugin 2.4.0

⚠️ Read Before You Update

Nothing carries over from the old folder. NovaFFA generates a fresh plugins/NovaFFA/ on first start and leaves your old ContinuumFFA folder completely alone, so nothing is deleted. Arenas, kits and player stats need setting up again.

The old permission nodes stop working. Update your permission plugin before you restart:

/ffakit and /ffaarena no longer exist. If you have command blocks, macros or permission entries pointing at them, point those at /ffa kit and /ffa arena instead.

📋 What Changed For You

🧱 Runs on Modern Minecraft Again

The plugin had not been updated in about a year. It now targets Paper 1.21.1 up to 1.21.11 and uses the current API throughout, so it keeps working as 1.21 moves on. Both ends of that range were started on a clean server with FastAsyncWorldEdit and PlaceholderAPI installed.

⌨️ One Command Instead of Three

Everything an admin does now lives under /ffa:

/ffa                      opens the fight menu
/ffa <kit>                joins that kit's arena
/ffa help                 the home help screen
/ffa kit ...              everything to do with kits
/ffa arena ...            everything to do with arenas

Every command is a proper Brigadier command now, so you get argument types, live suggestions for kit and arena names, and the client greys out anything invalid before you press enter.

📖 Help That Does Not Flood Your Chat

Help is paginated. /ffa help shows the home screen and points you at /ffa kit and /ffa arena. The Back and Next arrows are clickable, and clicking any command line drops it straight into your chat box ready to fill in. Jump to a page directly with /ffa arena help 2.

🎒 Your Kits Keep Their Custom Items

Kits and player layouts are stored using Paper's own item format now. Custom items, data components and anything a plugin like ItemsAdder or Nexo put on a stack all survive a restart intact. The old storage flattened them.

🌍 Five Languages

en_US, fr_FR, es_ES, zh_CN and hi_IN all ship with the plugin and are kept up to date automatically. Pick one with language: in config.yml, or drop your own file into the lang/ folder and name it there.

🖥 Menus You Can Actually Configure

• Every key has a plain comment above it explaining what it does
• Kit buttons honour the whole item spec, so glow, flags, amount, custom_model_data and enchantments all work. Add a material line to override the kit's own icon
• Any item can play a sound when it is clicked, with volume and pitch
• A filler item fills the leftover squares on a part full page
• A no_kits item shows instead of an empty menu on a fresh install
• Anything you add under custom_items survives every future update

🎨 Colour Syntax

Colours are written differently now, so any messages you had edited will need their tags updating:

# Plain colours and formatting
'&aGreen text, &land bold'

# Any hex colour
'&#00ccffA custom blue'

# Gradients and rainbows
'<GRADIENT:00ccff>fades across</GRADIENT:7fe5ff>'
'<RAINBOW1>rainbow text</RAINBOW>'

Placeholders the plugin fills in use curly brackets, so {kit}, {arena}, {display_name} and so on. Angle brackets inside the help text are command usage, not placeholders.

🛠 Fixed

All of these were broken in ContinuumFFA 1.1.81:

• Admin actions now confirm themselves. Deleting an arena, teleporting to one, toggling its permission, regenerating it, and starting or stopping the timer all sent nothing back before
• /ffa kit info and /ffa arena info print their output
• Title messages appear instead of never showing at all
• Joining a fight can no longer corrupt an inventory. Health, hunger and inventory were being touched from a background thread
• The layout editor saves slots in order, so a saved kit no longer comes back scrambled
• Kill to death rate reads properly for a player with no deaths, instead of showing Infinity
• A kit icon written in lower case loads instead of failing
• The public API runs registered listeners as it always claimed to
• The premium option on arenas is in the help text
• A broken FastAsyncWorldEdit install is reported clearly. It was previously only checked for being installed, not for having actually started, so a failed copy left the plugin half working with no explanation

📜 Commands

/ffa leave, /ffa lobby, /ffa stats and /ffa editkits do the same as their standalone versions.

🔐 Permissions

🔗 Placeholders

The identifier is still ffa, so anything you already reference keeps working.

%ffa_statistics_kills%      %ffa_statistics_deaths%
%ffa_statistics_kdr%        %ffa_statistics_current_streak%
%ffa_statistics_highest_streak%
%ffa_arena_name%            %ffa_kit_name%
%ffa_kit_display%           %ffa_is_playing%
%ffa_players_<arena>%

📦 Upgrading

1. Stop your server
2. Delete the old ContinuumFFA.jar. Leave the ContinuumFFA folder alone if you want to keep it for reference, NovaFFA will not touch it
3. Drop in NovaFFA-2.0.0.jar
4. Update your permission plugin to the novaffa. nodes
5. Start the server, then rebuild your arenas and kits

FastAsyncWorldEdit is required, it is what rebuilds arenas. PlaceholderAPI is optional. If FastAsyncWorldEdit is missing or fails to start, NovaFFA now tells you clearly in the console instead of half working.