How to Play Mods - jonaeru/perfect_dark GitHub Wiki

Modding

https://github.com/fgsfdsfgs/perfect_dark/wiki/Modding

Mod List

Artifacts link changes with each update and I would delete the old version.
Download expires in 90 days by GitHub. If it has expired, you will need to build it yourself.

All in One Mod (PD Plus, All Solos in Multi, GEX Multi, etc) (WIP)

Last Updated: December 1, 2024

Step-by-Step Instruction

  1. Download the latest release files
    https://github.com/jonaeru/perfect_dark/releases image

  2. Put Perfect Dark ROM in the "data" folder (ROM must be in .z64 format)
    US: Perfect Dark (U) (V1.1) [!].z64
    EU: Perfect Dark (E) (M5) [!].z64
    JP: Perfect Dark (J) [!].z64

  3. Rename the Perfect Dark ROM
    US: pd.ntsc-final.z64
    EU: pd.pal-final.z64
    JP: pd.jpn-final.z64
    image

  4. Download the mod folders
    Please download all_in_one_mods zip file.
    https://drive.google.com/drive/folders/1eo_SBUDaGa4LNByWj8fbiWrr8ny471Hf

    Or you can also use the mod folders created by Atari-Dude.
    Atari-Dude mods are updated frequently, so it is recommended to check back periodically.
    https://drive.google.com/file/d/1wNugFKl-ITXsz7wyjVzbVJgQwDub1Nb_/view?usp=sharing

  5. Unzip the zip file and place the "mods" folder as is
    mods\mod_dark_noon
    mods\mod_gex
    mods\mod_kakariko
    mods\mod_pd+_solos_gex

  6. Run the bat file
    Note: The 64-bit version has just been created, and the 32-bit version is relatively more stable.
    image

  7. No problem if the following are output to pd.log

     mod dir: ./mods/mod_pd+_solos_gex
 gex mod dir: ./mods/mod_gex
 kakariko mod dir: ./mods/mod_kakariko
 darknoon mod dir: ./mods/mod_dark_noon

MP Weapon Random Choice

I added the mod feature that allows you to choice a combat simulator random weapon. (WIP)
I really wish I could have created a settings screen on the game, but it was difficult for me and I wasn't sure if the settings could be saved, so I decided to use modconfig for now.
For example, X-Ray Scanner or Shield can be excluded from random weapons.

Add the following to mod_pd+_solos_gex/modconfig.txt
MP weapon number list is here.

# MP Weapon Random Choice
mpweaponrandomchoice {
  0x00 # WEAPON_NONE
  0x01 # WEAPON_FALCON2
  0x02 # WEAPON_FALCON2_SILENCER
  0x03 # WEAPON_FALCON2_SCOPE
  0x04 # WEAPON_MAGSEC4
  0x05 # WEAPON_MAULER
  0x06 # WEAPON_PHOENIX
  0x07 # WEAPON_DY357MAGNUM
  0x08 # WEAPON_DY357LX
  0x09 # WEAPON_CMP150
  0x0a # WEAPON_CYCLONE
  0x0b # WEAPON_CALLISTO
  0x0c # WEAPON_RCP120
  0x0d # WEAPON_LAPTOPGUN
  0x0e # WEAPON_DRAGON
  0x0f # WEAPON_K7AVENGER
  0x10 # WEAPON_AR34
  0x11 # WEAPON_SUPERDRAGON
  0x12 # WEAPON_SHOTGUN
  0x13 # WEAPON_REAPER
  0x14 # WEAPON_SNIPERRIFLE
  0x15 # WEAPON_FARSIGHT
  0x16 # WEAPON_DEVASTATOR
  0x17 # WEAPON_ROCKETLAUNCHER
  0x18 # WEAPON_SLAYER
  0x19 # WEAPON_COMBATKNIFE
  0x1a # WEAPON_CROSSBOW
  0x1b # WEAPON_TRANQUILIZER
  0x1c # WEAPON_GRENADE
  0x1d # WEAPON_NBOMB
  0x1e # WEAPON_TIMEDMINE
  0x1f # WEAPON_PROXIMITYMINE
  0x20 # WEAPON_REMOTEMINE
  0x21 # WEAPON_LASER
  0x22 # WEAPON_XRAYSCANNER
  0x23 # WEAPON_CLOAKINGDEVICE
  0x24 # WEAPON_COMBATBOOST
  0x25 # WEAPON_PP9I
  0x26 # WEAPON_CC13
  0x27 # WEAPON_KL01313
  0x28 # WEAPON_KF7SPECIAL
  0x29 # WEAPON_ZZT
  0x2a # WEAPON_DMC
  0x2b # WEAPON_AR53
  0x2c # WEAPON_RCP45
  0x2d # WEAPON_MPSHIELD
  0x2e # WEAPON_DISABLED
}

All in One Mod (PD Plus, All Solos in Multi, GEX Multi, etc) (WIP) (OLD)

Last Updated: November 24, 2024

Differences From the Original Mod

  • Perfect Dark Plus by Wreck
    • Fixed Skedar left arm, Dr. Carroll left arm hitbox. (Thank you so much, Wreck)
    • Fixed Skedar and Dr. Carroll blood color, added injury sounds
    • Presidents Clone body can be selected
  • All Solos in Multi by 00dark
    • Original arena can be selected
    • Added "Random Multi" and "Random Solo"
    • Fixed for multiplayer do not affect solo
    • Fixed the collision in Carrington Villa Multi (can climb roof). (Thank you so much, Atari-Dude)
  • GoldenEye X by Wreck
    • Combat Simulator Arena only (Partially broken)
      • Caverns (broken water texture)
      • Fac Backzone (broken texture white wall)
      • Train (broken texture white floor)
  • Kakariko Village by Sogun
    • Only Stormy
  • Dark Noon by MRKane

Step-by-Step Instruction

  1. Download either the Windows or Linux artifact (Github login required)
    https://github.com/jonaeru/perfect_dark/actions/runs/11988633998
    URL changes with each update. (Expires in 90 days by GitHub)

    image

    I would delete the old version. If it has been deleted, please click on the latest link below.
    https://github.com/jonaeru/perfect_dark/actions/

    image

  2. Add your pd.ntsc-final ROM to the data folder

  3. The following mod folders are required (Version may have been updated)
    https://drive.google.com/drive/folders/1QHI5xADrdZCuufF28v4FelX9O65KHCEv

    • mod_pdplus_solomulti_v7.zip
    • mod_gex_mp_v4.zip
    • mod_pdplus_kakariko_v1.zip
    • mod_dark_noon_v1.zip

  4. Place folders (once unzipped, called mod_pdplus_solomulti_v7 and mod_gex_mp_v4 and mod_pdplus_kakariko_v1 and mod_dark_noon_v1) into the same folder as pd.x86_64.exe
    image

  5. Create a bat file

    pd.x86_64.exe ^
--moddir mod_pdplus_solomulti_v7 ^
--gexmoddir mod_gex_mp_v4 ^
--kakarikomoddir mod_pdplus_kakariko_v1 ^
--darknoonmoddir mod_dark_noon_v1`

    Copy the text above and hit Save As, then select All Files, type PD.bat
    When you save, the file extension needs to be .bat
    You can use this to launch the game.

  6. Output pd.log (Optional)
    Add --log option

    pd.x86_64.exe ^
--moddir mod_pdplus_solomulti_v7 ^
--gexmoddir mod_gex_mp_v4 ^
--kakarikomoddir mod_pdplus_kakariko_v1 ^
--darknoonmoddir mod_dark_noon_v1` ^
--log

    No problem if the following are output to pd.log.

     mod dir: ./mod_pdplus_solomulti_v7
 gex mod dir: ./mod_gex_mp_v4
 kakariko mod dir: ./mod_pdplus_kakariko_v1
 darknoon mod dir: ./mod_dark_noon_v1

Perfect Dark Plus + All Solos in Multi + GoldenEye X 5e Multi Mod (OLD)

Last Updated: September 29, 2024

Differences From the Original Mod

  • Perfect Dark Plus by Wreck
    • Fixed Skedar left arm, Dr. Carroll left arm hitbox. (Thank you so much, Wreck)
    • Fixed Skedar and Dr. Carroll blood color, added injury sounds
    • Presidents Clone body can be selected
  • All Solos in Multi by 00dark
    • Original arena can be selected
    • Added "Random Multi" and "Random Solo"
    • Fixes for multiplayer do not affect solo
    • Fixed the collision in Carrington Villa Multi (can climb roof). (Thank you so much, Atari-Dude)
  • GoldenEye X by Wreck
    • Combat Simulator Arena only (Partially broken)
      • Caverns (broken water texture)
      • Fac Backzone (broken texture white wall)
      • Train (broken texture white floor)

Step-by-Step Instruction

  1. Download either the Windows or Linux artifact (Github login required)
    https://github.com/jonaeru/perfect_dark/actions/runs/10765552543
    URL changes with each update. (Expires in 90 days by GitHub)

    image

    I would delete the old version. If it has been deleted, please click on the latest link below.
    https://github.com/jonaeru/perfect_dark/actions/

    image

  2. Add your pd.ntsc-final ROM to the data folder

  3. The following mod folders are required (Version may have been updated)
    https://drive.google.com/drive/folders/1QHI5xADrdZCuufF28v4FelX9O65KHCEv

    • mod_pdplus_solomulti_v4.zip
    • mod_gex_mp_v3.zip

  4. Place folders (once unzipped, called mod_pdplus_solomulti_v4 and mod_gex_mp_v3) into the same folder as pd.exe
    image

  5. Create a bat file
    pd.exe --moddir mod_pdplus_solomulti_v4 --gexmoddir mod_gex_mp_v3

    Copy the text above and hit Save As, then select All Files, type PD.bat
    When you save, the file extension needs to be .bat
    You can use this to launch the game.

  6. Output pd.log (Optional)
    Add --log option
    pd.exe --moddir mod_pdplus_solomulti_v4 --gexmoddir mod_gex_mp_v3 --log

    No problem if the following are output. If not loaded, mod dir:, gex mod dir: will not be output.
    b6d0575 is the latest version.

    version: port-custom b6d0575 (i686-windows)

 mod dir: ./mod_pdplus_solomulti_v4
 gex mod dir: ./mod_gex_mp_v3

MP Weapon Random Choice (modconfig)

mpweaponrandomchoice {
  0x01 # Falcon 2
  0x02 # Falcon 2 (silencer)
  0x03 # Falcon 2 (scope)
}
Index Weapon
0x00 WEAPON_NONE
0x01 WEAPON_FALCON2
0x02 WEAPON_FALCON2_SILENCER
0x03 WEAPON_FALCON2_SCOPE
0x04 WEAPON_MAGSEC4
0x05 WEAPON_MAULER
0x06 WEAPON_PHOENIX
0x07 WEAPON_DY357MAGNUM
0x08 WEAPON_DY357LX
0x09 WEAPON_CMP150
0x0a WEAPON_CYCLONE
0x0b WEAPON_CALLISTO
0x0c WEAPON_RCP120
0x0d WEAPON_LAPTOPGUN
0x0e WEAPON_DRAGON
0x0f WEAPON_K7AVENGER
0x10 WEAPON_AR34
0x11 WEAPON_SUPERDRAGON
0x12 WEAPON_SHOTGUN
0x13 WEAPON_REAPER
0x14 WEAPON_SNIPERRIFLE
0x15 WEAPON_FARSIGHT
0x16 WEAPON_DEVASTATOR
0x17 WEAPON_ROCKETLAUNCHER
0x18 WEAPON_SLAYER
0x19 WEAPON_COMBATKNIFE
0x1a WEAPON_CROSSBOW
0x1b WEAPON_TRANQUILIZER
0x1c WEAPON_GRENADE
0x1d WEAPON_NBOMB
0x1e WEAPON_TIMEDMINE
0x1f WEAPON_PROXIMITYMINE
0x20 WEAPON_REMOTEMINE
0x21 WEAPON_LASER
0x22 WEAPON_XRAYSCANNER
0x23 WEAPON_CLOAKINGDEVICE
0x24 WEAPON_COMBATBOOST
0x25 WEAPON_PP9I
0x26 WEAPON_CC13
0x27 WEAPON_KL01313
0x28 WEAPON_KF7SPECIAL
0x29 WEAPON_ZZT
0x2a WEAPON_DMC
0x2b WEAPON_AR53
0x2c WEAPON_RCP45
0x2d WEAPON_MPSHIELD
0x2e WEAPON_DISABLED