NovaFFAFight Menu
The menu every kit is listed in, and joining an arena directly
Opening it
/novaffaAliased /ffa. Every kit that has been created is listed, clicking one sends the player into the arena that kit is linked to, holding that kit's contents. Requires novaffa.openFFAMenu, granted to everyone by default.
Joining directly
/novaffa <kit>Skips the menu and joins that kit's arena straight away. If the kit is linked to a premium arena, the player also needs novaffa.arena.<arena>.
A kit literally named kit, arena, help, leave, lobby, stats or editkits cannot be joined this way, the command literal wins over the kit name argument. It still works from the menu. See Kits.
Leaving
/leaveffaAliased /leave, /ffaleave, /exit, /exitffa and /ffaexit, plus /novaffa leave. Blocked while combat tagged if combat_tag.block.leave is on.
The lobby
/lobbyAliased /ffalobby and /spawn, plus /novaffa lobby. Teleports to the FFA lobby. /spawn ships as an alias because it is the word most players reach for, it is also the alias most likely to collide with Essentials or a hub plugin, whichever registers first wins the bare command and the other is reachable as novaffa:spawn. Drop it from commands.aliases.lobby in config.yml if your server already owns /spawn.
Admins also get /lobby set, /lobby corner1 and /lobby corner2, see Installation.
The menu's own lobby button does the same thing, and closes the menu behind the player as it sends them. Set items.lobby_button_toolbar.close_menu: false in menus/fight.yml to leave it open instead.
Where kits sit
Kits fill the squares between kit_button.start and kit_button.end in menus/fight.yml, in the order they were made, skipping any square the border, the toolbar or one of your own items already owns. Make a new kit and everything after it shifts along one square.
To stop that, pin a kit to a square of its own:
/ffa kit edit <kit> slot <square>
/ffa kit edit <kit> slot autoOr arrange them all by hand:
/ffa kit slotsThat opens the fight menu as an editor: the same size, the same border, the same toolbar. Click a kit to pick it up, click a square to put it there, right click a kit to unpin it. Dropping one kit onto another swaps the pair. Every change is written to the kit file as you make it.
A pinned kit sits on its square on every page, so it is where players expect it however many kits come after it. Unpinned kits flow into whatever is left. See Kits.
Showing how many are playing
Set kit_button.use_item_amount_to_display_playing: true in menus/fight.yml and each kit button's stack size becomes the number of players fighting on that kit right now: two axes, five crystals, at a glance. It works on any icon, one that does not stack in game included, and counts up to 99.
The same number is available as {playing} in the button's name and lore, which is where the default file uses it.
Locked kits
A kit with a price that the player has not bought yet is drawn from locked_kit_button instead of kit_button, so it can show {price}, {balance}, {missing} and {currency}. Clicking it opens the confirm screen in menus/kit_buy.yml. A menu file written before 2.12.0 has no such section until the update adds it, and draws the ordinary button until then.
Two sets of menus
The menu files live in two folders:
menus/is what the plugin reads normallymenus/one_arena/is read instead while one arena mode is on
Each folder holds the full set, the fight menu, the kit buy screen, statistics, the kit list and the kit editor, so each mode can be worded and laid out for what it is. Both are written out on every start, so the folder you are not using is always there to edit before switching, and /ffa reload swaps between them.
Menu layout
The fight menu, statistics menu and kit list are all read from yml files under plugins/NovaFFA/menus/, see Configuration for how those files work.
For the panes around the edge, your own decorative items, the filler on a part full page and player heads on any of them, see Borders, Fillers and Heads. Any item here can be a head, including the player's own face with skull: viewer.