Donkey Kong Country

A Donkey Kong Country randomizer for Archipelago.

Latest release: v1.2.3

Index

Back to main page

Setup

DKC 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 v1.0 (US) ROM file from the original cartridge. Archipelago or I can't provide these.
      MD5: 30c5f292ff4cbbfcc00fd8fa96c2de3b

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 .apdkc 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.

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.

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.

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.

Optional Software

Manager

Bundled with dkc.apworld

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

Do note that any change requires loading a .apdkc patch first.

Universal Tracker

Download

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.

DKC supports two Universal Tracker exclusive commands that allow players to know what's the logic behind a certain location

  • /explain "location name": It outputs the logic rules for a specific location, showing which item combinations will make it appear in logic.
  • /get_logical_path "location name": Shows a list that explains how to reach to a certain location in the game.

This APWorld does not require a YAML to process the current slot.

Poptracker

Download, made by MasakariPLZ

The poptracker pack features full location tracking with per-level tabs. It also auto switches tabs when a new level is loaded.

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.