NovaFFA | Free For All Plugin 2.12.0

🧑 Player Heads Anywhere

Any item in any menu file can be a player head. Set material: player_head, add a skull line, and it works in fight.yml, kit_list.yml and kit_editor.yml as well as the statistics menu, which was the only place a head worked before.

• skull: viewer is the face of whoever is looking at the menu, so a toolbar button can be the player's own head
• Heads from minecraft-heads.com and every other head site are read in whichever format the site hands them out: texture: for the long Base64 value, url: for the Minecraft URL, and hash: for the trailing part of that address on its own
• The prefix can be left off entirely. A uuid, a url, a Base64 value or a bare hash is recognised from its own shape, so a value pasted straight off a head site works exactly as it was copied, the line breaks it was wrapped in included
• player:SomeName and uuid:<uuid> work as they always did, and a uuid can now be written with or without its dashes
• Nothing is fetched. The texture address is written onto the item and the client loads it like any other skin, so a menu full of custom heads costs no network call
• A head that does not resolve is drawn plain rather than failing the item, so one mistyped line never empties a menu
• New {viewer} and {viewer_uuid} placeholders, the name and uuid of the player the menu is being drawn for, usable in the name and lore of every item in every menu

Every way to write a head, written up in full: greenarrowlol.github.io/NovaFFA/docs/borders-and-fillers#player-heads

🖼 Statistics Menu Borders

• statistics.yml gains an items.border section, written exactly like the ones in fight.yml, kit_list.yml and kit_editor.yml
• It was the one menu that read no border at all, so a border added to that file by hand was kept by the updater and then drawn by nothing, which looked like a broken key rather than a missing feature
• On by default, a black pane frame around the head and the five statistics. enabled: false turns it off
• Decoration is drawn before the statistics, so a pane sharing a square with a number gives that square up rather than covering it. This is how the kit editor already behaved

🚪 The Lobby Button

Clicking the lobby button in the fight menu now closes the menu as it sends the player, so they land in the lobby looking at the world instead of at a menu they have to close.

• New items.lobby_button_toolbar.close_menu in fight.yml, on by default. Set it to false for the old behaviour
• The other toolbar buttons were never affected, since each one opens another menu, which replaces the one on screen

📖 Borders, Fillers and Heads

A new documentation page covers the three separate ways to decorate a menu, items.border for the shipped frame, custom_items for anything you add yourself, and filler for the leftover squares on a part full page, plus every way to write a player head.

• A table of which menu takes which, how the squares are numbered, every key an item: section reads, and what happens when decoration and real content claim the same square
• It says plainly that items.border is read by name, so an invented second entry inside items: is kept by the file and drawn by nothing. Extra decoration belongs in custom_items, which every menu reads

📦 Upgrading

Stop the server, drop NovaFFA-2.8.0.jar in place of your old jar, and start it again. The border section and the close_menu key are added to your menu files on their own, taking every menu file to menus-version: 2, and everything you had already set in them is kept.

Compiled clean against Paper 1.21.1 and Paper 26.2.