SnFourInLine changelog

Changes

• Closing the /fourinline preview board now cancels the game. The close guard reopened the board of every live seat - the rule that keeps a real game alive when one of its two players closes their window - so a preview session outlived the window it was played in. The next /fourinline preview was then refused with "you are already in a game" until the turn countdown surrendered the admin against themselves.
• A preview seat's own close of the board ends it with no result: no statistics, no broadcast, no cue, no stake to settle. Every other close (a reload, a teleport, another plugin's window, death) still hands the board back exactly like any other seat, so opening /fourinline top over a preview and closing it again returns to the game.
• Watchers of a cancelled preview are told the game ended and their board is closed.

Language file

Two new keys are merged into lang/messages_en.yml on boot, values preserved:

• messages.preview.cancelled
• status.result-cancelled

messages.preview.started now says the board can be closed to end a preview; an existing server keeps its current text (the merge never overwrites a value you have).

Changes

New: /fourinline preview (admin)

Starts a real game with you in both seats, so you can look at the menus - and play a whole game through them - on a server with nobody else online. Made for editing guis/board.yml: drop animation, turn countdown and its warning, surrender button, winning-line highlight and end-of-game delay all behave exactly as in a normal game. Because both seats are yours, it is your turn every time.

• Nothing leaves the board: no statistics are recorded, no win is broadcast, and a preview can never carry a bet.
• It ends like any game: win it, draw it, press Surrender, or let the turn timer run out.
• While it runs it counts as a normal game, so it shows in the lobby's running list, other players can spectate it, and you cannot be invited until it is over.
• New permission snfourinline.admin.preview (op), child of snfourinline.admin.
• New language keys messages.preview.started, messages.preview.ended and messages.preview.ended-draw, merged into your lang/messages_en.yml on boot.

Fixes that came with it

The paths that walked "the two seats" assumed two different people. They now run once when both seats are one player, which is what stopped a preview from opening the board twice in a tick, playing the landing cue twice per move and the falling cue twice per animation frame.

Changes

• Fixed the leaderboard showing the viewer's own head on every ranked row: skull-owner in guis/leaderboard.yml used %player_uuid%, a PlaceholderAPI token that resolves to the viewer, so the per-entry placeholder never ran. It now uses the {player_uuid} local form, which PlaceholderAPI cannot touch.
• Hardened board.yml and lobby.yml head bindings to the same {curly} convention.

Upgrading an existing server

The gui files are value-preserving on update, so a server that already generated plugins/SnFourInLine/guis/leaderboard.yml keeps the old line. Either edit both skull-owner entries to "{player_uuid}" or delete the file to reseed it.

Connect Four played inside chest GUIs: invite a friend or list a public game in the lobby, bet in any server currency, let others spectate, and climb the leaderboard.

Features

• Chest-GUI board with a falling-piece animation, turn indicators and a per-move turn timer
• Friendly games by invite (/fourinline invite, accept, reject) or public listings anyone can join from the lobby
• Betting in any owner-configured currency: balances read through PlaceholderAPI, money moved by your economy's own console commands, every transfer verified by a balance read-back
• Stakes held in escrow and settled exactly once on every way a game can end: win, draw, surrender, turn timeout, disconnect and server shutdown all pay or refund correctly
• Spectator mode (/fourinline spectate <player>)
• Persistent stats (wins, losses, surrenders, games played, win rate, streaks) on SQLite or MySQL, a leaderboard GUI and a PlaceholderAPI expansion (%snfourinline_wins% and friends)
• Everything player-facing is configurable: menus (guis/*.yml), messages (lang/messages_en.yml), sounds, broadcasts, world restrictions, currencies and timers
• Live /fourinline reload, runtime debug toggle and automatic update notifications