Donkey Kong Country 2

A Donkey Kong Country 2 randomizer for Archipelago.

Latest release: v1.2.3

Index

Back to main page

Setup

DKC2 AP requires a similar setup found in other SNES games in Archipelago, you can follow one of those guides or keep reading this one.


Required Software

  • Archipelago 0.6.7 or newer
  • Software or hardware capable of loading and playing SNES ROM files:
    • snes9x-nwa (Recommended!)
    • snes9x-rr
    • Bizhawk
    • BSNES-plus (Do not reset within the emulator, it'll lead to RAM corruption)
    • FxPak
    • Any emulator or method not listed here is NOT endorsed by the developer, you may have varied results in those.

  • Your Donkey Kong Country 2 v1.1 (US) ROM file from the original cartridge. Archipelago or I can't provide these.
      MD5: d323e6bb4ccc85fd7b416f58350bc1a2

How to play

  1. Place the .apworld in your Archipelago/custom_worlds folder, or double-click the .apworld to do so automatically.
  2. Use ArchipelagoLauncher.exe to open the Launcher, and click on Generate Template Options to create template yamls for your custom .apworld files.
  3. Place the desired player yamls in the Players folder, and customize them as you see fit.
  4. Use ArchipelagoGenerate.exe to generate the game.
  5. Upload the generated game (in the output folder) on the website at https://archipelago.gg/uploads and create a new room.
  6. Download the patch file from the session page
  7. Open the .apdkc2 file with ArchipelagoLauncher.exe, it should create a ROM file and open SNI Client.

snes9x-nwa

  1. Click on the Network Menu and check Enable Emu Network Control. This step is only required once.
  2. Load your ROM file if it hasn't already been loaded.
  3. The emulator should automatically connect while SNI is running.

Bizhawk

  1. Ensure the BSNES core is loaded.
  2. Load your ROM file if it hasn't already been loaded. If you changed your core preference after loading the ROM, don't forget to reload it (default hotkey: Ctrl+R).
  3. Drag+drop the Connector.lua file that you downloaded above onto the main EmuHawk window.
    • Look in the Archipelago folder for /SNI/lua/.
    • You could instead open the Lua Console manually, click Script 〉 Open Script, and navigate to Connector.lua with the file picker.
  4. NOTE: If the BSNES core doesn't work, try using the Snes9x core or another emulator.


FxPak

  1. Open the patch file at least once with SNIClient (or the Launcher) to generate the ROM file.
  2. Ensure SNI is running on the background. It's open for you when launching a SNIClient game.
  3. Transfer the ROM file to your FxPak. Using manage_files.exe inside of the SNI folder in your Archipelago install is recommended.
  4. Boot the game.
  5. Connect with SNIClient to the server. SNIClient should connect to the FxPak automatically as long SNI is running on the background.

NOTE: If you want to reset or swap games, ensure you're disconnected from the Server first! Otherwise SNI will tell SNIClient some dirty lies about the state of the game and may clear locations for you, or worse, goal the game.


snes9x-rr

  1. Load your ROM file if it hasn't already been loaded.
  2. Click on the File menu and hover on Lua Scripting
  3. Click on New Lua Script Window...
  4. In the new window, click Browse...
  5. Select the connector lua file included with your client
      Look in the Archipelago folder for /SNI/lua/
  6. If you see an error while loading the script that states socket.dll missing or similar, navigate to the folder of the lua you are using in your file explorer and copy the socket.dll to the base folder of your snes9x install.

bsnes-plus

  1. Load your ROM file if it hasn't already been loaded.
  2. The emulator should automatically connect while SNI is running.

WARNING: Never, never, NEVER restart the game with one of the emulator buttons, it's better to close off the emulator and rerun it.

Manager

This APWorld comes with a manager that allows you to edit some features from an already generated game or some other global features. Players can find this software in ArchipelagoLauncher.exe under the Adjuster menu.


Linked Options

This section allows you to toggle Death Link, Damage Link, Trap Link and Energy Link. Requires a .apdkc2 patch file to be loaded first.


Global Options

This section allows you to toggle some global options. These do not require loading a patch first and will apply to any future session.

  • Guaranteed DK Coins and G letters in goals: Goals have RNG rewards and some goals have these valuable items. This makes them not RNG and be guaranteed.
  • Random rewards in goals: Makes the goal roulette have different rewards. Does not affect goals with guaranteed rewards and valuable items (DK Coins & G Letters) are not randomized.

Trivia Options

This section allows you to customize Swanky's Trivia. It allows you to toggle the current question count per Swanky game (there are 3 games per Swanky level).

Each game/trivia topic allows you to select if these questions will appear in the game or not

  • Session: Will be added as a valid topic if the game is being played in the current session.
  • Forced: All of its questions will be added to the pool of questions regardless if the game is being played.
  • Excluded: None of its questions will appear.

If a .apdkc2 patch is provided, games detected will change their Session status to Included to tell players which of these will be added to the current and future sessions.

Trackers


Universal Tracker

Universal Tracker is a custom APWorld that allows players to generate a list of in-logic locations for the current slot, very useful when trying to figure out why is something suddenly appearing as reachable.

Feature Supported?
Logic tracking ✔️
YAML-less tracking ✔️
/explain ✔️
/glp ✔️
Glitched Logic ✔️
Deferred Entrances
Map Tracker Tab
Player location in Map Tracker
  • /explain "location name": It outputs the logic rules for a specific location, showing which item combinations will make it appear in logic.
  • /glp "location name": Shows a list that explains how to reach to a certain location in the game.

Optional Software


Color selector

Page

This web tool allows players to create custom palettes for Donkey and Diddy.


DKC Atlas

Page

Handy page that shows every level in the game in a web browser.