Files
Grinch-AP/worlds/sa2b/docs/setup_en.md
PoryGone 449973687b SA2B: v2.0 Content Update (#1294)
Changelog:

Features:
- Completely reworked mission progression system
  - Control of which mission types can be active per-gameplay-style
  - Control of how many missions are active per-gameplay-style
  - Mission order shuffle
- Two new Chaos Emerald Hunt goals
  - `Chaos Emerald Hunt` involves finding the seven Chaos Emeralds and beating Green Hill
  - `FinalHazard Chaos Emerald Hunt` is the same, but with the FinalHazard fight at the end of Green Hill
- New optional Location Checks
  - Keysanity (Chao Containers)
  - Whistlesanity (Animal Pipes and hidden whistle spots)
  - Beetlesanity (Destroying Gold Beetles)
- Option to require clearing all active Cannon's Core Missions for access to the Biolizard fight in `Biolizard` goal
- Hard Logic option
- More Music Options
  - Option to use SADX music
  - New `Singularity` music shuffle option
- Option to choose the Narrator theme 
- New Traps
  - Tiny Trap is now permanent within a level
  - Gravity Trap
  - Exposition Trap
  
Quality of Life:
- Significant revamp to Stage Select screen information conveyance
  - Icons are displayed for:
    - Relevant character's upgrades
    - Which location checks are active/checked
    - Chaos Emeralds found (if relevant)
    - Gate and Cannon's Core emblem costs
  - The above stage-specific info can also be viewed when paused in-level
    - The current mission is also displayed when paused
- Emblem Symbol on Mission Select subscreen now only displays if a high enough rank has been gotten on that mission to send the location check
- Hints including SA2B locations will now specify which Gate that level is located in
- Save file now stores slot name to help prevent false location checks in the case of one player having multiple SA2B slots in the same seed
- Chao Intermediate and Expert race sets are now swapped, per player feedback
  - Intermediate now includes Beginner + Challenge + Hero + Dark
  - Expert now includes Beginner + Challenge + Hero + Dark + Jewel
- New mod config option for the color of the Message Queue text

Bug Fixes:
- Fixed bug where game stops properly tracking items after 127 have been received.
- Several logic fixes
- Game now refers to `Knuckles - Shovel Claws` correctly
- Minor AP World code cleanup
2022-12-07 06:20:02 +01:00

6.8 KiB

Sonic Adventure 2: Battle Randomizer Setup Guide

Required Software

Optional Software

Installation Procedures

  1. Install Sonic Adventure 2: Battle from Steam.

  2. Launch the game at least once without mods.

  3. Install Sonic Adventure 2 Mod Loader as per its instructions.

  4. The folder you installed the Sonic Adventure 2 Mod Loader into will now have a /mods directory.

  5. Unpack the Archipelago Mod into this folder, so that /mods/SA2B_Archipelago is a valid path.

  6. In the SA2B_Archipelago folder, run the CopyAPCppDLL.bat script (a window will very quickly pop up and go away).

  7. Launch the SA2ModManager.exe and make sure the SA2B_Archipelago mod is listed and enabled.

Joining a MultiWorld Game

  1. Before launching the game, run the SA2ModManager.exe, select the SA2B_Archipelago mod, and hit the Configure... button.

  2. For the Server IP field under AP Settings, enter the address of the server, such as archipelago.gg:38281, your server host should be able to tell you this.

  3. For the PlayerName field under AP Settings, enter your "name" field from the yaml, or website config.

  4. For the Password field under AP Settings, enter the server password if one exists, otherwise leave blank.

  5. Click The Save button then hit Save & Play to launch the game.

  6. Create a new save to connect to the MultiWorld game. A "Connected to Archipelago" message will appear if you sucessfully connect. If you close the game during play, you can reconnect to the MultiWorld game by selecting the same save file slot.

Additional Options

Some additional settings related to the Archipelago messages in game can be adjusted in the SA2ModManager if you select Configure... on the SA2B_Archipelago mod. This settings will be under a General Settings tab.

  • Message Display Count: This is the maximum number of Archipelago messages that can be displayed on screen at any given time.
  • Message Display Duration: This dictates how long Archipelago messages are displayed on screen (in seconds).
  • Message Font Size: The is the size of the font used to display the messages from Archipelago.

If you wish to use the SADX Music option of the Randomizer, you must own a copy of Sonic Adventure DX on Steam, and follow these steps:

  1. Find the folder on your PC where Sonic Adventure DX is installed.

  2. Enter the SoundData folder in the Sonic Adventure DX installation folder, and copy the bgm folder.

  3. Paste the bgm folder into the ADX folder which exists within the gd_PC folder in your SA2B_Archipelago mod folder.

Troubleshooting

  • "The following mods didn't load correctly: SA2B_Archipelago: DLL error - The specified module could not be found."

    • Make sure the APCpp.dll is in the same folder as the sonic2app.exe. (See Installation Procedures step 6)
  • "sonic2app.exe - Entry Point Not Found"

    • Make sure the APCpp.dll is up to date. Follow Installation Procedures step 6 to update the dll.
  • Game is running too fast (Like Sonic).

    • Limit framerate using the mod manager:
      1. Launch SA2ModManager.exe.
      2. Select the Graphics tab.
      3. Check the Lock framerate box under the Visuals section.
      4. Press the Save button.
    • If using an NVidia graphics card:
      1. Open the NVIDIA Control Panel.
      2. Select Manage 3D Settings under 3D settings on the left.
      3. Select the Program Settings tab in the main window.
      4. Click the Add button and select sonic2app.exe (or browse to the exe location), then click Add Selected Program.
      5. Under Specify the settings for this program:, find the Max Frame Rate feature and click the Setting column for that feature.
      6. Choose the On radial option and in the input box next to the slide enter a value of 60 (or 59 if 60 causes the game to crash).
  • Controller input is not working.

    1. Run the Launcher.exe which should be in the same folder as the SA2ModManager.
    2. Select the Player tab and reselect the controller for the player 1 input method.
    3. Click the Save settings and launch SONIC ADVENTURE 2 button. (Any mod manager settings will apply even if the game is launched this way rather than through the mod manager)
  • Game crashes after display logos.

  • No resolution options in the Launcher.exe.

    • In the Graphics device dropdown, select the device and display you plan to run the game on. The Resolution dropdown should populate once a graphics device is selected.
  • No music is playing in the game.

    • If you enabled an SADX Music option, then most likely the music data was not copied properly into the mod folder (See Additional Options for instructions).
  • Mission 1 is missing a texture in the stage select UI.

    • Most likely another mod is conflicting and overwriting the texture pack. It is recommeded to have the SA2B Archipelago mod load last in the mod loader.

Save File Safeguard (Advanced Option)

The mod contains a save file safeguard which associates a savefile to a specific Archipelago seed. By default, save files can only connect to Archipelago servers that match their seed. The safeguard can be disabled in the mod config.ini by setting IgnoreFileSafety to true. This is NOT recommended for the standard user as it will allow any save file to connect and send items to the Archipelago server.