NovaFFA | Free For All Plugin 2.12.0

🏟 One Arena Mode

Everyone fights in the same place, whatever kit they picked, so a sword player stands next to an axe player. Turn on one_arena at the bottom of config.yml, name the arena, and run /ffa reload. No restart.

• It is a switch, not an extra way in. While it is on, every join goes to that arena and the kit links are ignored. Turn it off and every link works again, nothing is deleted
• one_arena.kits limits which kits are offered, and an empty list offers them all
• The mode reads its menus from menus/one_arena/, a full second set worded for it, so each mode keeps its own layout and both folders stay there to edit
• /ffa join <arena> sends a player in with the kit they picked last, or opens the menu if they have not picked one
• The console warns on start and on reload if the mode names an arena or a kit that does not exist

Find out more about how this works here: greenarrowlol.github.io/NovaFFA/docs/one-arena-mode

💰 Kits Sold Through Vault

Any kit can carry a price, paid in whatever currency your economy plugin runs. If it calls its money coins, so does NovaFFA.

• /ffa kit edit <kit> price <amount> locks a kit until a player buys it. In the normal mode, a locked kit locks its arena too
• A locked kit shows its price and the player's balance in the fight menu. Clicking it opens a confirm screen, nothing is taken until they confirm, and then they go straight into the fight
• /ffa buy <kit> opens the same confirm screen from chat
• /ffa kit grant and /ffa kit revoke handle store deliveries and admin gifts, from the console and for offline players
• novaffa.kit.<kit> unlocks a kit for a rank, and operators do not get every kit for free
• Without Vault and an economy plugin nothing changes, every kit stays free

Read more here: greenarrowlol.github.io/NovaFFA/docs/kit-prices-and-rewards

⚔️ Rewards for Kills

• economy.kill_reward pays money for every kill through Vault
• on_kill.rewards runs commands for the killer, for the victim, and on exact streaks, with {killer}, {victim}, {arena}, {kit}, {streak} and PlaceholderAPI placeholders. Lines run as the console unless they start with player:
• same_victim_cooldown, same_ip and on_combat_log stop rewards being farmed with a friend or an alt. None of them stop the kill counting

🔧 Fixes

• A kit could come out empty. A kit made with /ffa kit create or updated with inventory import kept a live link to the admin's inventory, so later saves wrote whatever that admin happened to be holding. The items are copied now. A kit that already emptied needs one /ffa kit edit <kit> inventory import
• Arena corners name whole blocks. They were compared as the exact spots an admin was standing in, so the bottom layer of an arena could fall outside its own region, and two corners set at the same height protected nothing at all. An arena is now every block from one corner to the other, like any region plugin. Nothing to change in your files
• Build protection hardened. The axe, shovel, hoe, flint and steel and armour stand checks no longer step aside for an interaction another plugin has touched, and they read whichever hand the tool is in
• The refill after a kill, the kit handed back after a regeneration and %ffa_kit_name% all follow the kit the player actually picked

🔗 Placeholders and API

New placeholders: %ffa_owns_<kit>%, %ffa_price_<kit>%, %ffa_kits_owned% and %ffa_one_arena%.

For developers, FFAKillRewardEvent fires before a kill pays out, with editable command lists and money.

Read more here: greenarrowlol.github.io/NovaFFA/docs/developer-api

📦 Upgrading

Stop the server, swap in NovaFFA-2.12.0.jar, start it again. config.yml moves to version 5, menus/fight.yml to 4 and the language files to 9, with your own values kept and the new keys added on first start. menus/kit_buy.yml and the menus/one_arena/ folder are created for you.

Add Vault and an economy plugin if you want to sell kits or pay money for kills. Everything else works without them.

If you turned build off on an arena and it never seemed to do anything, check its corners with /ffa arena info <arena>. They are meant to be opposite corners of a box, one at the floor and one above the highest point you want covered.

📋 Version Breakdown