T7 GHOST AI - v0.5.1 PUBLIC TECH DEMO  (by t7ghostauthor)
========================================================

A proof of concept: Tekken 7's Practice-mode CPU replaced by an AI that learned from real players'
replays. It copies how they actually played - their movement, habits, strings, punishes and combos -
with sharp execution, and it adapts to YOUR habits while you play against it.

This demo ships two AI opponents:  KATARINA  and  GANRYU.

Requires: Tekken 7 on Steam, latest (final) version, Windows. Offline Practice mode only - the AI is
never active online or in any other mode.

INSTALL
  1. Steam > Tekken 7 > right-click > Manage > Browse local files.
  2. Open  TekkenGame\Binaries\Win64  (the folder with TekkenGame-Win64-Shipping.exe).
  3. If a version.dll is already there (another mod), move it somewhere safe first.
  4. Copy the CONTENTS of this package's Win64 folder into that folder:
       version.dll   and the   t7ghost   folder.
  When the game starts, a small note in the top-left corner confirms the mod is loaded.

PLAY AGAINST THE AI
  1. Practice mode. Pick any character for yourself; pick KATARINA or GANRYU as the opponent (2P).
  2. Practice settings: set the dummy / opponent action to "CPU" and the CPU level to "ULTRA HARD".
  3. Fight. The AI takes over the opponent. (Any other opponent character, or any other CPU level,
     plays as the game's normal CPU.)

IN-GAME SETTINGS PANEL  (press F1)
  F1 opens and closes the settings panel at any time, also mid-fight. Use the mouse:
  - Reaction time       how fast it reacts to you (14 frames = strong human; lower = faster)
  - Input read (cheat)  chance per move that it knows your move the instant you press it
  - Guard skill, Decision skill, Adapt to you, Throw breaks, Punish, Combos
  - Who it imitates     Ganryu has two recorded players: merged (default, both as one), hybrid,
                        or one of them only
  - Reset to defaults / Forget my habits
  Changes take effect immediately and are saved to Win64\t7ghost\t7ghost.ini, so they are kept for
  next time. The panel shows whether the AI is active and which recorded player it is playing as.
  While the panel is open, the mouse and keyboard go to the panel.

THE INI FILE  (Win64\t7ghost\t7ghost.ini - each option is explained right under it)
  Everything in the panel can also be set here. [ui] menu_key changes the panel key (e.g. Insert,
  Ctrl+F1). After editing the file while the game runs, press Ctrl+F9 in the game to reload it.

WHAT THE AI REMEMBERS
  While you play, the AI learns. It writes into the t7ghost folder:
  - learned_framedata.txt   how many frames it really had after blocking your moves
  - opponent_<number>.txt   your habits per character you play (how often you attack, lows, getups,
                            what it could punish, sidesteps). "Forget my habits" in the panel (or
                            deleting these files) makes it forget you.
  t7ghost.log is a short log of what loaded. Nothing is sent anywhere.

THE PLAYERS
  The two opponents are built from saved replays of real online matches. Players are pseudonyms
  (P01, P08, P15); no names, IDs or other personal information are included.

UNINSTALL
  Delete version.dll and the t7ghost folder from the Win64 folder (put back any version.dll you moved).

NOTES
  - Made with AI assistance (Anthropic's Claude) under t7ghostauthor's direction.
  - Not affiliated with or endorsed by Bandai Namco. Tekken is a trademark of Bandai Namco
    Entertainment Inc.
  - Uses MinHook (BSD 2-clause) and Dear ImGui (MIT) - see THIRD_PARTY_LICENSES.txt.
  - Updates: see the link at the top of t7ghost.ini (pending).
