Perfect Dark Dab's Mod

Perfect Dark Dab's Mod is a Windows, Linux, and macOS port of Perfect Dark that adds new movement options, raises the simulant cap, and includes a spectator camera.

README

Dab's Mod

Download — Windows, Linux and macOS. You supply the ROM; see You need a ROM. There is also a rolling dev build of the newest commit, if you want fixes before they reach a release.

A fork of the Perfect Dark PC port, which is itself a port of the Perfect Dark decompilation.

It adds movement the N64 game never had — jump, a combat roll, melee combos, a third person camera — raises the Combat Simulator simulant cap from 8 to 80, keeps bodies lying where they fell, and gives you a free-flying spectator camera, a screenshot key and a video recorder for watching the results.

Everything here is engine-side and lives in the executable. No custom levels or assets are bundled, and none are needed - but mods drop in, see Mods.

You need a ROM

This is an executable, not a game. It reads every texture, model, level and line of dialogue out of a Perfect Dark ROM at startup, and ships with none of that.

You need Perfect Dark (USA) (Rev 1), also called ntsc-final or US V1.1 — md5 e03b088b6ac9e0080440efed07c1e40f, and the one the boot screen calls NTSC version 8.7 final. Dumping it from your own cartridge is on you; don't ask here.

PAL and JPN ROMs are not supported by this fork. The stock port supports them if you need one.

Running it

  1. Unpack the download somewhere.
  2. Put your ROM in the data folder next to the executable, named exactly pd.ntsc-final.z64. (The folder is already there, with a put_your_rom_here.txt in it.)
  3. Run it:
    • Windows — pd.x86_64.exe
    • Linux — ./pd.x86_64
    • macOS — ./pd.x86_64 or ./pd.arm64, whichever matches your machine

If the ROM is missing or is the wrong one, the game says so in a dialog box and names the exact directory it looked in. On Linux and macOS you can put the data folder in ~/.local/share/perfectdark or ~/Library/Application Support/perfectdark instead, and --basedir <path> overrides both.

macOS will refuse to run an unsigned binary downloaded from the internet. Either right-click → Open, or run xattr -dr com.apple.quarantine . in the unpacked folder.

A GPU with OpenGL 3.0 / ES 3.0 or better is required.

What it adds

All of the fork's settings are under Options → Extended Options → Dab's Mod Options, on five pages that swipe left and right the way the Perfect Menu swipes to Options: Player, Camera, Display, Missions and Recording. A key bind sits on the page of the feature it drives. Each setting persists to pd.ini under a Mod. key.

Movement
SettingWhat it does
JumpOff, or a height from 1 to 5. Bound to the use button, behind whatever that button opens — doors and objects still take priority
Jump ForWhether simulants jump too, or only players
Combat RollA dodge roll. C on the keyboard, right stick click on a pad
Melee CombosThe punch and kick combos solo play has always had, in multiplayer
Flinch When ShotBodies react to where the shot landed instead of ignoring it
Start ArmedSpawn holding a weapon — the arena's, or a random one. Off by default, because stock is off. In a solo mission, Random adds a random gun to the mission's kit; First Weapon changes nothing there, the mission having armed you already
Start Armed ForWhether simulants spawn armed too, or only players
Mission RespawnA death in a solo mission is a new life where you fell, with full health and everything you were carrying, instead of Mission Failed. Off by default
LivesHow many lives a mission has in all: Unlimited, or 5 to 50 in fives. With 5, the fifth death ends the mission
Third person

V on the keyboard, Back on a pad, in solo and multiplayer both. You drop back to first person while aiming. Camera Distance and Camera Wall Clearance tune the framing. A wall behind you brings the camera in, as far as the eye if it must, and your character fades out as it comes close (Camera Body Fade is how close) rather than the view cutting to first person.

Camera Tether makes the camera a pole attached to you instead of one bolted to the back of your head. The right stick orbits the camera all the way round you, the left stick moves you in screen space and you turn to face the way you go, and holding the trigger turns you to face the camera, which is where the shot goes. The pole is elastic: strafing swings it round and it settles back behind the camera. Loose lets it swing further and takes its time, Tight holds it close and is nearly a rigid pole. Off is the rigid camera, with you always facing the aim, and is the default. Body Turn Speed is how fast you come round to face the way you are going, in degrees per frame: 30 by default, 90 is as good as instant.

Picture

Built in, no pack needed. Texture Upscale, Supersampling and TAA are under Extended Video Options; the rest share a page of their own.

SettingWhat it does
Thin Text OutlinesOutlined text gets a thin halo drawn by the renderer instead of the black cell the font bakes in, which at monitor resolutions is a slab behind every letter. Off is the bold border the cell stands for, drawn the same way
Smooth TextThe font's glyphs are scaled up four times over with their edges sharpened, so letters have a clean edge instead of a staircase of blurred squares. Off by default
Texture UpscaleThe game's own textures scaled up two, four or eight times over as they load, resampled through a curve rather than the GPU's straight blend. Nothing is invented, but a 32-texel wall stops being a grid of soft blobs. Textures that are themselves a dot pattern, like a halftone portrait or a screen of tiny text, are left alone. 2x by default; 4x costs four times the video memory and 8x sixteen
SupersamplingThe game drawn at 1.5 or 2 times the window and averaged down to it, which smooths every edge, including the alpha cut-outs and texture detail MSAA leaves alone. Stacks with MSAA and SMAA. 2x draws four times the pixels, so it is for a strong GPU; the drawn frame stops at 8192 pixels on its longer side. Off by default, and choosing it turns FSR Upscaling off, since both set the size the game draws at
TAATemporal anti-aliasing, the last choice under Anti-aliasing: the world is drawn a fraction of a pixel off each frame and blended with the frames before it, following the camera through the depth buffer, so edges, thin rails and texture shimmer settle. The gun and the HUD are drawn after it and stay sharp. It takes MSAA's place rather than stacking with it; SMAA and Supersampling still add. Things that move on their own, like guards, can soften slightly while they move
Vivid ColoursSaturation and contrast turned up on the finished frame, which was drawn for a CRT and looks flat on a panel. Light by default; Normal and Heavy go further. Screenshots and recordings get it too
Black LevelA floor taken off the frame's blacks, so black is black rather than dark grey, without crushing the shadows above it the way contrast would. Light takes 2% off and is the default; Normal 4%, Heavy 7%

Texture packs, where installed, are left alone by Texture Upscale and Smooth Text: their images are already whatever size their author chose.

Simulants

Up to 80 in a Combat Simulator match, set the usual way in the simulant menu. Stock hides any count above four until ten Combat Simulator challenges are done; this fork does not gate its own cap, so all 80 are there on a fresh profile. The four Bond heads that share that unlock are still earned normally.

The save file only grows past the stock 8-simulant format when a setup actually needs it, so ordinary setups stay readable by an unmodified port.

Each simulant has its own Stats... page under its entry in the simulant menu, with five sliders from 10% to 500% of what its type and difficulty give it. All start at 100%, a stock simulant.

SliderWhat it scales
SpeedTop running speed
AccuracyHow far its aim strays from the target; 500% is a fifth of the error
ReactionHow soon it fires once it sees someone, and how fast its aim settles
DamageDamage it deals
ToughnessDamage it takes, to shield and health alike; 500% takes a fifth

Reset to Stock puts all five back, Copy Simulant carries them to the copy, and they save with the setup. A challenge or a preset always plays stock simulants. A setup file that holds a moved slider is in a newer format that older builds of this fork cannot read; one with every slider at 100% is not.

Bodies

Bodies stay where they fell instead of vanishing. Bodies caps how many are kept (up to 500), Body Time how long each lies there, and Bodies Drawn how many may be drawn in one frame — lower that one first if the frame rate suffers, since the bodies still exist, they just aren't all rendered.

Spectator

A camera that comes off the player and flies through the level, including outside it. F on the keyboard. Start Spectating enters it automatically on every stage; Spectator Start Game in the Combat Simulator menu arms it for one match only. Spectator Speed sets how fast it flies. Combined with a match with no time or score limit, it's the tool for watching 80 simulants fight.

Playing online

Combat Simulator matches can be played over the internet with up to twelve players, their simulants and two spectators. One player's game hosts the match (a listen server); everyone else's connects to it. A full room of twelve needs about 2 Mbit/s of upload from the host.

Rooms. Online Game is on the main menu. The GoldenEye and ROM hack modes have the row in their Combat Simulator instead, where a room is made on their own arenas. Online play uses your Ghost Trials account. The page's Sign In row opens the account page (the same one as Ghost Trials

Account): type a name and a PIN and press Sign In. There is no separate Create Account - a name nobody has yet becomes your account, after you pick three security questions (they are only used to reset a forgotten PIN). The Online Game page signs in as it opens and its first line says whether the lobby knows you; a refused sign-in says why. On a PC keyboard, just type: Enter is OK and Escape is Cancel on every on-screen keyboard. Then:

  • Browse Rooms opens the Briefing Room: every open room with its host, players in/max, arena, mode, ping and whether it has a password. A room marked ! cannot be joined from your game - select it to see why (another version of the game, or different ROM, mods or added content). The ping there is an estimate (you to the lobby plus the lobby to the host); a ~ in front means your network blocks the lobby's UDP port and your half was estimated from the web request instead. Once you are in the room the Game Lobby shows the real one.
  • Create Room makes a room from your current Combat Simulator setup: name, password, how many players, then the usual scenario, arena, weapons, limits and simulants.
  • Game Lobby is the room itself: the players by team with how each one reaches the host and their ping (LAN, DIR direct, NAT punched through, RLY relayed through the lobby), chat, Change Team (team 1, team 2 or spectator) and Ready. The host has Launch, Kick and Settings. After the match everyone comes back to the room for the next one. To chat there, press Space (or T) and type; Enter sends, Escape cancels. On a controller, Chat... opens the on-screen keyboard.

LAN and Direct Connect. Online Game first asks where to play: Online Lobbies (the rooms above, on the lobby server), LAN or Direct Connect. The last two need no account and no server, so they play when the lobby is down. Name Entry asks only for the name you play as. After that the pages are the same Briefing Room and Game Lobby, with the host's own game serving the room (its players, teams, ready marks, chat and launch). Co-op, counter-op and campaign rooms work too.

  • LAN lists the rooms on your network by itself. A host's firewall must let the game have UDP ports 27100-27103.
  • Direct Connect has Connect to Address: type the host's IP (or a name), and its port if it is not 27100 (1.2.3.4:27105, or 1.2.3.4 27105 on a pad's keyboard). The addresses you use are kept and listed again. A host picks its UDP port on Create Room (Port, 27100 unless set, kept as Net.Port), and its Game Lobby shows the address friends on its network use. For friends outside its network, the host forwards that UDP port on its router to its computer and gives them its public IP.

Co-op missions. A room can be a co-op mission instead of a match: in Create Room (or the host's Settings) set Game to Co-op Mission, pick whose missions under Missions (Perfect Dark's, GoldenEye's, Goldfinger 64's or Tomorrow Never Dies 64's, as converted on the host's machine), then the mission, difficulty, radar and friendly fire. Up to twelve of you play the mission together as Perfect Dark's own co-operative mode does: one player is Joanna (or Bond), everyone else a coop agent in their Combat Simulator character. Deaths follow the host's Mission Respawn: with it on, a dead player gets up again where they fell once the screen has gone black, with full health and everything they were carrying, and Mission Lives is the whole team's (with five, the team's fifth death does not come back). A player whose death does not come back - Mission Respawn off, or the lives spent - drops their guns for the others and watches the rest of the mission (Z the next player, A a free camera, START or ESC the pause menu), with no gun and nothing to do but watch. The mission fails when everyone is dead; on GoldenEye's missions (and the two ROM hacks') the last death is first replayed three times from GoldenEye's own cameras, as it is alone. Everyone starts on the mission's own start spot, and anyone joining mid-mission appears on a living player's spot: co-op players walk through each other, so nobody is ever put behind a wall to make room. Every mission and difficulty is open online, and nothing played online counts towards your own solo progress. Without the lobby, a --host session starts one from the Carrington Institute's mission briefing with Co-Operative and a human buddy.

Counter-op missions. Set Game to Counter-Op Mission and the room's players pick a side: in the Game Lobby, Change Side moves you between the Agents and the Counter-Ops (a newcomer joins the smaller side), and the host can launch once each side has a player. The agents play the mission together as in a co-op mission, Mission Respawn and its lives included. Every counter-op is Perfect Dark's own counter-operative: they take over one of the mission's living guards - its body, its gun and its health - and when that guard dies, A, Z or START puts them in the next one, for as long as the mission has guards to give (Guards Alerted!'s count too, so its waves keep the counter-ops in bodies). The guards never go after a counter-op, the agents see no name over one, and on GoldenEye's, Goldfinger 64's and Tomorrow Never Dies 64's missions a counter-op only ever takes an ordinary armed guard, never Ourumov, Natalya or anyone the mission needs. The agents win by completing the mission, the counter-ops by killing every agent with no lives left.

Campaigns. Set Game to a campaign instead (Perfect Dark, GoldenEye, Goldfinger 64 or Tomorrow Never Dies 64) and the room's launch puts the host in that game's own menus rather than a match: GoldenEye's folder, or the Perfect Menu's missions. Every mission the host starts there is the room's next co-op mission, and the others are pulled into it from the Game Lobby without a new launch; when it ends the host is back in the folder and everyone else back in the room, ready for the next one. A campaign's room stays open to newcomers for as long as the host plays it: anyone who joins between missions waits in the Game Lobby for the host's next one, and anyone who joins during one drops into it. The host plays through the game as offline, with its own difficulty (GoldenEye's 007 sliders included), and the room follows. A GoldenEye, Goldfinger 64 or Tomorrow Never Dies 64 mission ends as it does offline: everyone watches its ending through the host's camera, anyone's button skips it, and each player gets the folder's report and statistics pages for their own game before the next mission.

A room that is already playing can still be joined: you drop into the match in progress. If your game crashes or your connection drops, rejoin the room within 30 seconds (Net.ReconnectHold) to get your seat and score back.

If the host leaves. The room carries on without them. The lobby hands it to the player best placed to host it: one whose game has the room's arena or conversion (a conversion the host sent you counts), preferring an open connection and a low ping. Mid-match, the match starts again on the same arena under the new host and carries on where it was: the clock, everyone's score, and each player back where they stood with their health, shield, guns and ammo. The arena's pickups and a scenario's briefcase, hill or terminal start over, and a player who was dead when the host left starts a fresh life. A co-op mission starts again from its beginning. It takes a second or two when the host quits, and up to about ten seconds when the host's game crashes or its connection drops. Between matches the room simply has a new host, who keeps its settings, and anyone the old host had to send a conversion to can still be sent it by the new one. If the old host comes back within 30 seconds, it gets its seat and score back as a player.

In the match. A line at the top left of the screen says when someone joins the match in progress, leaves, loses the connection, comes back to their kept seat or starts watching, with how many seats are being played ("3/8"). Press T to chat (and Space too, if none of your binds use it - by default it is a second fire button): type straight away, Enter sends, Escape cancels. Hold P to see the players: each one's score, deaths and ping, the open seats and who is watching. On a controller, pause and pick Players (on the Combat Simulator's Control page, or the mission's pause page) for the same list, the on-screen keyboard and a list of quick messages. The keys are Net.ChatKey, Net.PlayersKey and Net.ChatSpace in pd.ini. Put your crosshair on another player, in a Combat Simulator match or a co-op mission, and their name shows over their head (in their team's colour in a team game); it fades a moment after the crosshair leaves them, and never shows through a wall or a cloak. Net.PlayerNames=0 turns it off.

Ports. Nobody needs to open a port for a room to work: the game finds its own way to the host - over your LAN, straight to the host, punched through both routers, or through the lobby's relay as the last resort. Hosting is smoother if the host forwards UDP 27100 (Net.Port in pd.ini) to its machine, because joiners can then connect directly. The lobby itself only needs outgoing HTTPS and UDP, which every home router allows.

Without the lobby. On a LAN, or with a forwarded port, start the host with --host (or --host PORT) and have the others run --connect ADDRESS (or ADDRESS:PORT); the host then starts the match from its Combat Simulator as usual. A direct host seats four players unless Net.MaxPlayers in pd.ini says more (up to 12). --dedicated r