=== Poker Online ===
Contributors: ZTZ
Tags: poker, texas holdem, multiplayer, php, html5, game, tournament, strategic bots, bot personalities
Requires at least: PHP 7.4
Tested up to: PHP 8.3
Stable tag: 1.0.0
License: Regular or Extended
License URI: https://codecanyon.net/licenses/standard

== Description ==
A complete multiplayer Texas Hold'em platform. No MySQL required (JSON
file storage). Includes strategic bots with Monte Carlo equity simulation, GTO-informed preflop
ranges, hand history with replay, player profiles, in-game chat with
moderation, and a theme system.

Cash tables plus a full tournament mode: the seated players vote the rules,
everybody pays the same buy-in from his account, the blinds climb on a
PokerStars-style ladder, and the tournament can have scheduled breaks (every N
minutes of play or at a fixed minute of every hour), late registration, limited
rebuys with a 30-second decision and a payout split (winner takes all, by
percentage or fixed amounts). The table returns to its cash blinds when the
tournament is over.

== Installation ==

   1. Open Documentation/index.html in a browser for the full guide.
   2. Upload the CONTENTS of the Source/ folder to your web host
      (i.e. index.php, api.php, assets/, etc. go directly into the
      web root - NOT into a "Source" sub-folder).
      Do NOT upload Documentation/, README.txt or LICENSE.txt.
   3. Open https://your-site.com/setup.php in a browser.
   4. Follow the 2-step setup (install, then cleanup).
   5. Click "Delete setup.php now" (the setup page offers it).
      The panel also has an "Uninstall everything" button (removes all
      data and config.php) if you ever need to start over.
   6. Open index.php and register.

Requirements: PHP 7.4+ with the session and json extensions.
The data/ folder must be writable by PHP (chmod 755 on Linux).

== Frequently Asked Questions ==

= Do I need MySQL? =
No. Everything is stored in JSON files in the data/ folder.

= Can I run tournaments, or only cash games? =
Both. Any table can become a tournament: the seated players vote the buy-in, the
length of a blind level, the payout split, the late-registration window, the
rebuys and the break schedule. Then the buy-in is taken from every account and
the blinds start climbing. Breaks pause the blind clock, a late player can still
join while the window is open, a busted player gets a 30-second rebuy offer (no
answer = out) and the winner is paid automatically. See
Documentation/tournament.html.

= Can I add more bots? =
Yes. Set POKER_BOTS_ALLOWED = true in config.php. Players get the "Add bot"
button when POKER_BOTS_ADD_BY_PLAYERS = true (the admin observer can always add
bots).

= Do the bots play differently from each other? =
Yes. Each bot draws one of four archetypes when it sits down: TAG (40%), Rock
(25%), LAG (25%) and Station (10%). Same GTO + Monte Carlo engine, but a
different preflop range position, open size, price it is willing to call,
c-bet / barrel / bluff frequency and check-raise trap rate, plus a thinking
time that depends on the style and on how close the decision is (never above
4.5 s). Nobody chooses a style and it never changes while the bot plays.

= How do I make all bots play the same? =
Set POKER_BOT_STYLES_ENABLED = false in config.php (or use the Bots tab of
admin.php?cfg=1). Every bot then plays the identical baseline engine with the
fixed 1.5-2.8 s wait. See Documentation/user-guide.html#bot-personalities.

= Can I disable chat? =
Yes. Set POKER_CHAT_ENABLED = false in config.php.

= How do I change the default room name? =
Set POKER_DEFAULT_ROOM in config.php (alphanumeric, max 20 chars).

= How do I add my own banned words? =
Add them to POKER_BANNED_EXTRA in config.php.

= How do I change the blinds and starting stack? =
Set POKER_SB, POKER_BB and POKER_START_CHIPS in config.php. They apply to
new tables.

= How do I enable HTTPS-only cookies? =
Set POKER_HTTPS_ONLY = true in config.php (requires an SSL certificate).

= Do the themes need an internet connection? =
No. Most bundled themes load a display font from Google Fonts, but that is
optional — remove the @import line at the top of a theme's theme.css to make
it fully offline. See Documentation/configuration.html.

== Changelog ==

= 1.0.0 =
   * Initial release.
   * Tournament mode: player vote, rising blinds, scheduled breaks, late
     registration, limited rebuys, payout splits and a tournament clock on the
     felt. See Documentation/tournament.html.

== Credits ==
Bot decision engine based on publicly available GTO charts.
Card animations and design are original work.