INTERACTV 1.0.0-BETA
====================

INSTALLATION
------------

Requirements:
  - GTA V for PC
  - Script Hook V
  - Script Hook V .NET Enhanced
  - .NET Framework 4.8
  - Microsoft Visual C++ Redistributable x64

Copy the package into the GTA V root folder and merge its scripts/ folder. The startup
notification says whether the installed build is Basic or Full. There is no key, license
screen, activation or online validation.


EDITIONS
--------

Basic is the focused gang edition:
  - Gang affiliation remains available.
  - You can recruit faction members and use the simple squad orders.
  - The only autonomous scenes are Gang War, Gang Meet and Gang Street Sale.
  - Territory, faction economy, conquest, lieutenant phone operations and ride-along are absent.
  - Robbery, homeless, police and other Full scene catalogues are absent.
  - The required gameplay XML is encrypted inside InteractV.dll. Each authored content folder
    contains only a README.md, so there is no loose gameplay XML to edit.

Full contains every active system and exposes its authored XML under scripts/InteractV/:
  - Territory ownership, rivalry and conquest
  - Faction economy and lieutenant phone operations
  - Ride-along and advanced faction operations
  - Gang commerce, supply, robbery, reinforcement and arrest-rescue events
  - Homeless encounters and arson
  - Police responses, arrest flows, corpse investigation and air support

Both editions use the same core DLL and player controls. Full is the customizable edition;
Basic is intentionally smaller and cannot be turned into Full by editing a setting.


ACTIVE SCENE CATALOGUE
----------------------

Basic embeds:
  scenes/gang_meet.xml
  scenes/gang_street_sale.xml
  scenes/gang_war.xml
  scenes/modules/gang/gang_confrontation.xml

Full ships the four files above plus:
  scenes/bum_arson.xml
  scenes/bum_street_encounter.xml
  scenes/gang_allied_meet.xml
  scenes/gang_deal_betrayal.xml
  scenes/gang_robbery.xml
  scenes/gang_supply_handoff.xml
  scenes/police_arrest.xml
  scenes/police_investigate_corpse.xml
  scenes/modules/police/police_arrest_common.xml
  scenes/modules/police/police_arrest_foot.xml
  scenes/modules/police/police_group_control.xml
  scenes/modules/police/police_pursuit_vehicle.xml

Only one behavior profile is active: behaviors/gang_vs_gang.xml.


CONTENT LAYOUT
--------------

scripts/InteractV/
  config/          Player-facing settings in both editions; territory.ini is Full-only.
  data/            Runtime state created by the mod. Never shipped; keep it when updating.
  audios/          Speech banks and voice configuration.
  behaviors/       The active AUTO_REACT behavior profile.
  definitions/     Locations, activities and internal system tuning.
  events/          World-event triggers and responder definitions.
  groups/          Gang, law and civilian actor definitions.
  interactions/    Rules deciding which actors may start an encounter.
  scenes/          The step graphs that choreograph an encounter.
  skins/           Action-wheel artwork used by the game.
  plugins/         Optional custom-action DLLs and their README.
  docs/            This guide and the player-facing changelog.

In Full, the seven authored XML families are loose and editable. In Basic, no authored XML is
loose. config/interactv.ini and config/faction_profile.xml remain editable in both editions.


CONTROLS
--------

  F5                         Open the InteractV menu.
  D-pad Down                 Enable or disable the action wheel by default.
  Hold INPUT_SELECT_WEAPON   Open the action wheel; release to confirm.

The two action-wheel controls can be changed in config/interactv.ini. They use GTA INPUT_* names
and work with keyboard or controller. Selecting Weapons transfers control to GTA's native weapon
wheel; InteractV does not maintain a second weapon catalogue.

Walk close to a valid character to open their contextual actions. The wheel only shows actions
that are currently available. When dialogue is playing, the menu hides until the subtitle is done.


FIRST SETUP
-----------

1. Open F5 and choose your language under General.
2. Choose your player faction. The selection is remembered per character.
3. Enable the action wheel if you want contextual actions and squad orders.
4. Full only: configure territory display and the advanced systems you want to use.

Do not copy old XML files over a 1.0.0-beta installation. File names, folders and the active
catalogue were cleaned for this release. Keep only the data/ folder if you want to preserve state.


CUSTOMIZING FULL
----------------

Back up a file before changing it. Keep file names and referenced scene paths in lowercase
snake_case. A rule in interactions/ starts an encounter; the scene it points to lives in scenes/.
Changing an unrecognized action name makes that actor fall back to IDLE, so use the built-in action
list in plugins/README.txt or install a plugin that registers the new action.

Reload the scripts after editing XML. If a scene does not start, enable logs temporarily in
config/interactv.ini and inspect scripts/InteractV/interactv-YYYY-MM-DD.log.


UPDATING
--------

Before installing 1.0.0-beta:
  - Remove the old scripts/InteractV authored folders instead of merging obsolete XML into them.
  - Install the selected edition cleanly.
  - Restore data/ only if you want to keep your runtime state.
  - Reapply Full XML customizations one file at a time against the new catalogue.

Basic users should not copy Full XML into their authored folders: the Basic runtime deliberately
ignores loose gameplay XML.
