================================================================
 A-LIST PRESETS V2.0 -- Mutator for Unreal Tournament 2004
================================================================
 Package : AList  |  Language : UnrealScript v2.5
 Author  : Virgile "VILE"
 Game    : Unreal Tournament 2004 (patch 3369 or newer)

----------------------------------------------------------------
 1. WHAT IS A-LIST?
----------------------------------------------------------------
 A-List is a single mutator that saves and reuses named presets
 ("lists") for four things, from one in-game window:

   * MUTATORS  - Create and save your favorite mutator combinations.
                 Apply them with a single click into your active
                 match mutator list.
   * WEAPONS   - Define weapon replacement rules (e.g., replace the
                 Shock Rifle with a custom weapon). Floor ammo and
                 starting weapons adapt automatically. Select
                 "(no weapon)" to remove a weapon from a slot; the
                 "No weapon (all)" button clears every weapon slot.
   * VEHICLES  - Replace standard Onslaught/Assault/VCTF map vehicles
                 with your favorite ones (vehicle factories updated
                 in real-time). Select "(no vehicle)" to disable a
                 vehicle slot, or click "No vehicle (all)" to disable
                 every vehicle slot at once.
   * BOTS      - Manage custom bot lists (multiplayer characters,
                 single-player, and DUP duplicates).
                 Toggle between the 2D portrait and an interactive
                 3D character preview (mouse rotation, animations,
                 and Red/Blue/Green/Gold team skins).
                 Integrated SKINMIX workshop ("SKINMIX" button):
                 freely mix body (Skins[0]) and head (Skins[1])
                 materials within any skeletal mesh family, preview
                 animations in 3D, and import, rename, or delete
                 custom bots directly in "Available bots".
                 Forced team assignment: Red, Blue, Green, and Gold,
                 with proper squad and AI order initialization.
                 Native compatibility with OLTeamGames 4-team modes
                 (BR4, CTF4, TDM4, VCTF4).
                 Smart handling of duplicate names (same name,
                 different models, or duplicate .upl detection).
                 Scope isolation by game mode: a preset configured
                 for CTF4 will not overwrite your lists in DeathMatch
                 or Team DeathMatch.

 In game, open it with:  Mutators > Configure Mutators > Open
 or from the console:    mutate alist gui

----------------------------------------------------------------
 2. CONTENTS OF THIS ARCHIVE
----------------------------------------------------------------
   System/AList.u    - the mutator and integrated SkinMix
                       workshop (compiled code).
   System/AList.ucl  - menu entry (makes it visible in the
                       mutator list).
   ReadMe.txt        - this file.

 Your presets and imported custom bots are stored in
 System/AList.ini, created automatically on first run (optional
 SkinMix filters/aliases use System/SkinMix.ini). They are NOT
 included here.

----------------------------------------------------------------
 3. REQUIREMENTS
----------------------------------------------------------------
 * A full UT2004 install, patched to 3369 (or OldUnreal 3374+).
 * Nothing else is required. OLTeamGames (CTF4/TDM4) and
   OLTeamVehicleGames (VCTF4) are OPTIONAL: A-List detects them
   automatically and enables the Green/Gold teams when present.

----------------------------------------------------------------
 4. INSTALLATION
----------------------------------------------------------------
 1. Close UT2004.
 2. Extract this ZIP directly into your UT2004 folder
    (the one containing the System/ subfolder). You must get:
      UT2004/System/AList.u
      UT2004/System/AList.ucl
 3. Start UT2004, go to Instant Action (or Host Game) >
    Mutators, move "A-List Presets" to the right column.
    (Enabling "A-List Presets" automatically activates SkinMix;
    there is no separate SkinMix entry to select.)

 Dedicated / network server: copy the files into the server's
 System/ folder and add  ?Mutator=AList.AListMgr  to the
 command line. Add  ServerPackages=AList  under
 [Engine.GameEngine] in UT2004.ini if you use custom mixed-skin
 bots (@Body@Head) so clients receive replicated skin links.

----------------------------------------------------------------
 5. QUICK START
----------------------------------------------------------------
 * In the mutator list: Configure Mutators > Open.
 * Pick a tab (Mutators / Weapons / Vehicles / Bots),
   build a list, Save it, then Apply preset.
 * Bots: "Capture current list" imports the game's Bot
   Roster; "Apply preset" fills the Bot Config AND arms
   the exact roster for the next match. A preset applied
   in one gametype family (DM / 2-team / 4-team) will not
   leak into another.
 * SkinMix (Bots tab > "SKINMIX" button): pick a Race and
   Model, combine any BODY and HEAD material, enter a name in
   "Name:", and click "IMPORT TO A-LIST". The custom bot is
   added to "Available bots" without overwriting your current
   bot list. Use the "In A-List:" dropdown with "RENAME" or
   "DELETE" to manage imported bots.
 * Help ("?" button): click "?" in the A-List window to display
   the quick help, URL options, and console commands in the
   bottom description box.
 * Console:  mutate preset ... | mutate alistweapons ...
             mutate alistbots ...  (try "... list" / "gui")
 * URL: ?MutPreset=Name  ?AListWeapons=Name  ?BotPreset=Name

----------------------------------------------------------------
 6. UNINSTALL
----------------------------------------------------------------
 Delete System/AList.u, AList.ucl, AList.int, and AList.frt
 (and System/AList.ini / SkinMix.ini if you also want to erase
 your presets and custom bots).
 Nothing else in UT2004 is modified.

----------------------------------------------------------------
 7. TROUBLESHOOTING
----------------------------------------------------------------
 * Mutator not listed  -> AList.ucl missing from System/.
 * Details in System/UT2004.log, category "AList".

----------------------------------------------------------------
 8. WHAT'S NEW IN V2.0
----------------------------------------------------------------
 * Integrated the SkinMix avatar & bot workshop directly into
   the AList package (opened from the Bots tab via the "SKINMIX"
   button): mix body (Skins[0]) and head (Skins[1]) materials
   within any skeletal mesh family, with live 3D animation
   preview (mouse drag rotation, Spin toggle at bottom-left,
   -/+ zoom at bottom-right) and mesh alias sharing
   (MeshAliases).

----------------------------------------------------------------
 9. WHAT'S NEW IN V1.6
----------------------------------------------------------------
 * Added a "3D View" / "Portrait" toggle on the Bots tab to
   preview characters in 3D (drag to rotate, click to cycle
   animations, real-time Red/Blue/Green/Gold team skin preview).
 * Fixed a team-game bug where bots assigned or moved to the
   Red team lost their Squad/TeamAI orders and stayed crouched
   in a corner.
 * Added exact duplicate .upl entry detection in the bot info
   bar.

================================================================
 Crafted with passion by Virgile "VILE" for UT2004.
================================================================
