Admin & Settings

admin.php does two jobs: opened plainly it is the observer (the real table with every hole card, plus kick and bans); opened as admin.php?cfg=1 it is the settings page, a tabbed editor for config.php. This page is about the editor and how to use it — what every option means, its type, its default and its allowed range is in Configuration.

Logging in

• admin.php?pass=YOUR-PASSWORD — one request, then the poker_obs_ok cookie keeps you in.
• admin.php?k= — a bookmarkable "remember me" link.
• The password is a bcrypt hash in $ADMIN_HASH at the top of the file; to change it: php -r "echo password_hash('your-password', PASSWORD_BCRYPT);"

The settings page

• Four tabs — General, Table & Rooms, Game, Bots — and the last one you used is remembered in your browser.
• Search looks through all tabs at once, by option name or by its explanation.
• Rows read SETTING | VALUE, with a one-line explanation and default: … (the value a fresh install writes) next to each name.
• Durations (*_MS) are edited in seconds, decimals allowed; the file keeps milliseconds.
• Switches are green when on, red when off; options that depend on a switch are hidden while it is off (the AI card, the key, the chat/history/rabbit limits, the bot names).
• Save (bottom right) is the only write; it reports exactly what changed, e.g. Saved: POKER_SB, POKER_BB. Refused values write nothing and are shown in the page banner — no browser alerts.

A few things worth knowing

• Numbers are checked twice — in the browser and on the server. The big blind must stay bigger than the small blind, and decimals are kept as typed. All ranges are listed with the options in Configuration.
• Players can be limited: POKER_BOTS_ADD_BY_PLAYERS and POKER_BLINDS_BY_PLAYERS (both on by default) take the 🤖 Add bot and ⚙️ Blinds buttons away from players; the admin observer keeps them.
• Bot personalities live in the LOCAL BOTS card: POKER_BOT_STYLES_ENABLED (on by default) gives every bot a Rock / TAG / LAG / Station archetype and a personality-aware thinking time. Turning it off restores the identical baseline engine for all bots. Nobody picks a style — it is drawn from the bot's own id when it sits down.
• Saving is instant on the server. A table that is already open keeps the old button until it is reloaded, but the request behind it is already refused with a message.
• Rooms are edited as chips in the Table & Rooms tab. Only the default room plus those codes are playable, and removing a code closes the room gracefully: current hand finished, stacks settled, then a message. Adding it back reopens it as it was.
• Hand editing still works. The editor rewrites the value inside each define('POKER_NAME', value); line, so keep that formatting; a trailing // comment is shown as the option's help. Options added by a newer version appear on the next load, and a missing one is treated as its default.

Observer, kick and bans

The observer page shows the real table with all hole cards. The Players panel offers Kick (5-minute re-sit block, optional message) and Ban (10 min / 1 h / 24 h / 7 days / custom minutes, 0 = permanent, optional reason, blocks the account and its IP); the Bans list has a live countdown, search and one-click Unban. Details in the User Guide.

If something is refused