Fixes Black Ops 3 on Mac so custom maps from the Steam Workshop can be played and online matches can be played with people running the Windows version of the game.
by Emma / InvoxiPlayGames and Anthony / serious.
Any issues you run into with custom maps or workshop mods should be reported here, and not to the mod's author!
Install Guide: Installing BO3MacFix
BO3MacFix reads BO3MacFix/settings.ini in the game's folder when the game starts, one Name = value per line
(lines starting with // are comments). All of them are optional.
They can also be changed in the game: pick BO3MACFIX SETTINGS in the main menu, or press F10 in the start menu. Settings marked "(restart)" take effect after a restart, which the page offers to do. The Display ones apply right away, mid-match too: changing Game display moves the game to that display.
| Setting | Default | What it does |
|---|---|---|
PrePatchedExe |
1 | Starts a copy of the game with BO3MacFix's changes already made in the file (CoDBlkOps3_Exe.bo3macfix, remade after game or BO3MacFix updates), so Rosetta runs it from its ahead-of-time translation instead of its slower JIT. 0 starts the original. |
JobThreads |
2 | How many job worker threads the game uses, 2 to 4. |
ThreadQoS |
1 | Runs the game's main, render and job threads at the highest scheduling priority. |
JobIdleFix |
1 | Lets idle job threads sleep instead of spinning. |
RenderIdleFix |
1 | Lets the render thread sleep while it waits for the next frame, instead of spinning. |
MainWaitFix |
1 | Lets the main thread sleep while it waits for the render thread, instead of spinning. |
YieldSleep0 |
0 | Makes Sleep(0) yield like on Windows. |
FastSetjmp |
1 | Makes the script VMs' setjmp/longjmp skip saving the signal mask, a syscall each time. |
FastScriptErrors |
1 | Stops each script error from trying to open the script source files (scriptsrc.zip, only the mod tools make them) again for every line of its call stack. All-around Enhancement's scripts hit thousands of errors a second, so this frees up much of the main thread. |
QuietScriptErrors |
1 | Shows each repeated script error (the same message) in console_mp.log 3 times with its call stack, then only counts it: once a minute a line says how many more there were. Mod scripts that hit an error every frame otherwise write that log at up to megabytes a second. 0 prints every error, as before. |
FramesInFlight |
2 | How many frames the CPU may queue ahead of the GPU, 1 to 3 (MaxFrameLatency in config.ini does nothing on Mac). |
FramePacingFPS |
0 | Keeps each frame on screen for at least 1/N of a second, 30 to 240, for even pacing below the refresh rate. |
MetalFXUpscale |
0 | Upscales with MetalFX when the game's resolution is lower than the screen's, in either fullscreen mode. 2 is for scaled monitor modes (like "looks like 2560x1440" on a 4K monitor): it upscales to the panel's own pixels rather than the bigger scaled size macOS shrinks back down. Needs macOS 13. |
DynamicResolution |
0 | Lowers the 3D scene's resolution (ResolutionPercent in config.ini) in 5% steps while the GPU can't keep up with the display's refresh rate (or a lower frame limit), down to this share of it (50 to 95, e.g. 75), and raises it again once there's room; under a frame limit (BatteryFPS and the like), where the GPU slows down to the limit and always looks busy, it tries a step up after the limit has held for 6 s and takes it back if the frame rate drops (each trial taken back, or followed by a step down within 32 windows, makes the next wait twice as long; never in the pause menu, the menus or the background). For 3 s after the frame target rises (a frame limit lifted or raised: the pause menu or a menu closed, the game in front again, plugged in, a setting changed) it takes no step down while the GPU, which macOS clocks down to just fit a limit, may still be speeding up: not in the first frames, partly paced to the lower target, and not while the frame rate is at 65% of the new target or more (a GPU coming up was at 72% or more in every log). A scene further below it, such as a heavy map at its own rate, steps down at once, as without the rise. Without this a close of the pause menu on battery could take 5% off for 8 s. It only goes as low as it has to, so a low share costs nothing where the GPU keeps up: on a heavy map like DEIMOS 935, 85 gave 82 to 91 frames a second, 70 gave 108 to 117 and 50 held the display's 120 (at 55%). The HUD stays at full resolution. config.ini keeps your own value. The render targets it keeps for quick steps are marked as a little older than the ones the game is drawing with, so when the game needs room for yet another size it frees one of those rather than one a frame on screen still reads (in the first frames after a match's warm-up the game's own choice can still fall on one in use, as it could before). 0 = off. |
AAEEngineDefaults |
0 | Keeps the gun's shadow resolution at the game's own values while All-around Enhancement raises it: the mod's HUD sets it to 4.0X at every match start (when its ProMod option is off); the game's own is 2.0X for sunlight and 1.0X for lamps (r_viewModelSunShadowResolution, r_viewModelSpotOmniShadowResolution). With the mod's value the gun is drawn into big shadow maps for every lamp near you each frame. Measured by switching it on and off every 8 s at a fixed spot, with another program busy on the Mac: on the heavy custom map DEIMOS it gave back about 0.2 ms of the GPU's 15 ms a frame (1.5%, about 1 fps at 67; nine pairs between +0.15 and -0.44 ms), and on Kino der Toten about 0.45 ms of 8.1 (5.5%; eight pairs between -0.03 and -0.75 ms) while the display's 120 Hz held, so there it saves GPU time and power rather than giving frames. Pictures of the gun and arms from the hip and aimed, in Kino's lobby and at Origins' spawn, showed no difference; none of those views shows a sharp shadow of the gun, where a lower resolution would be softer. 1 = always, 2 = only while the Mac runs on battery (as BatteryFPS sees it), 0 = off. It only ever lowers the value to the game's own, whoever raised it (the mod, another mod or your own console command); with the mod's ProMod on, which lowers it further, it does nothing, and a value it set goes back when it is turned off. Without a mod nothing raises it, so it does nothing. Nothing else below the graphics menu's lowest settings was worth a setting: of about thirty renderer values tried, the rest saved nothing measurable, spoiled the picture, or were the menu's own (Shadow Quality's actor shadows). Applies at once. |
DisplayFollow |
1 | Follows display changes: when displays are plugged in or unplugged, the game moves to the display GameDisplay picks and adapts its resolution and refresh rate to it. |
GameDisplay |
0 | Which display the game uses: 0 the main display (the one with the menu bar), 1 the MacBook's built-in screen while it's on, 2 an external display when one is connected (the last one the game used, else the fastest), 3 one display you picked by name on the in-game page (it's remembered in BO3MacFix/displays.ini; while it's not connected, the game goes by 2). |
DisplayMemory |
1 | Remembers the resolution and refresh rate the game used on each display (in BO3MacFix/displays.ini), for when it's back on that display. A monitor is still recognised when it's plugged into another port or adapter. |
MatchRefreshRate |
1 | Uses each display's own refresh rate. A MaxFPS that matched the old display's refresh rate follows it too. |
ConfineCursor |
0 | Stops stray clicks landing on another display in fullscreen menus: the pointer stops at the edge of the game's display, and keeps going if you push on past it. |
AvoidNotch |
0 | In fullscreen on a MacBook's built-in screen, keeps the whole picture below the camera notch: the strip beside the notch goes black, and the picture gets a little smaller to fit, with thin black bars at the sides. The mouse follows it. It turns itself off on displays without a notch and on again when the game comes back. |
ControllerMappings |
1 | Lets DualShock 4, DualSense and DualSense Edge controllers work over USB. |
ControllerBridge |
0 | Reads DualShock 4 and DualSense controllers through macOS instead: Bluetooth and USB, rumble and lightbar. Turn Steam Input off for the game. Needs macOS 11.3. |
ButtonPrompts |
0 | 0 shows PlayStation buttons with a PlayStation controller, 1 always Xbox, 2 always PlayStation. |
LightbarColor |
-1 | The lightbar colour as RRGGBB, with ControllerBridge. -1 leaves it alone. |
GyroAim |
0 | Experimental: aims with the DualSense's gyro on top of the right stick, 1 always, 2 while L2 is held. With ControllerBridge. GyroSensitivity and GyroInvert tune it. |
GyroSensitivity |
100 | How strongly the gyro turns the view with GyroAim, in percent. |
GyroInvert |
0 | Inverts the gyro's direction with GyroAim: 1 vertical, 2 horizontal, 3 both. |
AdaptiveTriggers |
0 | Experimental: gives the DualSense's R2 a weapon-style break and L2 light resistance. With ControllerBridge. |
PauseOnDisconnect |
0 | Opens the pause menu when the controller you're playing with disconnects mid-match (a Bluetooth dropout, a flat battery), in games that can pause: solo and offline, and a co-op game you host with All-around Enhancement 4 (with AAECoopPause, which then pauses it for everybody, as on Windows with the mod's plugin). With ControllerBridge. A controller lost while the game is behind another app pauses it when you bring it back, within half a second: the game takes keys only in front, and a match runs on behind. |
RawMouse |
0 | Experimental: aims with raw mouse counts instead of macOS's accelerated movement. RawMouseScale sets the speed. |
RawMouseScale |
100 | The speed of RawMouse aiming, in percent. |
AAEOnline |
0 | Lets All-around Enhancement fetch its version notes and weather (HTTPS GET only, to raw.githubusercontent.com and wttr.in). |
OfflineMode |
0 | Keeps the game off the internet, so that a missing or bad connection (airplane Wi-Fi) can't hold you up. 1 = always: the game gets no internet at all, only this Mac, its local network and multicast (LAN play works). It never signs in to its online service, so Return at All-around Enhancement's start screen goes at once to the mod's main menu, marked as offline, without the "Connecting to Online Service" wait (up to 30 s, then an error), and no lost connection can end a game. For a flight use 1, set before you go (it needs a restart). There, pick ZOMBIES: the mod's PLAY ONLINE still opens the game's own "Connecting to Online Service" wait (30 s, then an error). 2 = automatic: at launch BO3MacFix asks the game's online service (Demonware's lobby server, port 3074) for a connection; when the name lookup and the connection don't both answer within 1.5 s, the launch is offline as with 1, and a notice on the screen says so (with Notices on); a restart tries again. It decides once a launch, and a slow but working connection passes that test: the game is then online, with its waits, as without this. 0 = off. Steam's own Go Offline is yours to switch before you lose the internet. BO3MACFIX_OFFLINEDEBUG=1 logs each refused name and address once. |
AAEBankFix |
1 | Keeps cheats (sv_cheats) off as a map starts with All-around Enhancement loaded, so its bank, weapon locker and saved bank balance load. The game turns cheats on for any map started with a mod, and AAE's bank checks before AAE turns them off again. devmap, AAE's own elmg_cheats and other mods keep the game's behaviour. Applies after a restart. |
WeaponAnims |
1 | Plays the animations All-around Enhancement asks T7Overcharged for when you inspect a weapon (reload with a full magazine, sprint and reload with a controller, or by itself after 30 seconds of standing still with a weapon that has an inspect animation) and after its ammo bag refill. On the gun (startweaponanim): the first raise for a weapon that has no inspect animation of its own, the low-ready animation that holds the inspect for one that has. On your character's body (anim_event), which the third person view shows and the other players see: the first raise, for a weapon without an inspect animation and after the refill (for the others the mod asks for a flourish, which zombies has no body animation for, on Windows neither). Like T7Overcharged it plays the body's where the game's server runs, so in solo and on the host of a co-op game. Without it they're skipped, as before. Applies after a restart. |
AAEScriptPatches |
1 | Loads All-around Enhancement 4's patch scripts. Since 4.0 the mod no longer replaces the game's core zombies scripts; it ships patch scripts (scripts/aae_common/... and, per map, scripts/aae_level/<map>/...) whose functions replace single functions of them, and only its Windows plugin loads those. Without them its starting round, Perkaholic, zombie counter and other options do nothing. BO3MacFix loads each one after the script it patches and sends that script's calls to the replacements; log.txt lists them in lines starting with script patches:, with the reason for any it leaves out. Applies after a restart. |
AAEFreeAim |
1 | A crosshair in All-around Enhancement 4's third person view (its key is L by default). The game draws no crosshair while the view is a third person one, so the mod's view had none on the Mac and nothing could be aimed in it. The mod's Windows plugin gives it one (the first part of what it calls free aim), and so does this, by the plugin's rule: in zombies maps, once the view has been third person for a quarter of a second, and not with the mod's dvar aae_freeaim_enabled set to 0. The crosshair stays while you aim, reload or switch weapons (in first person it goes away then, because you look through the sights): its lines close in as the sights come up, from the weapon's spread to its tightest. That part needs the pre-patched executable. Bullets go to what is under the crosshair: the third person camera looks from beside and behind the player, so a bullet fired straight ahead from the player would pass beside that spot, by more the nearer it is. The mod's script already works out the point under the crosshair (it leaves it in the dvar aae_freeaim_target); the plugin, and now this, turns each bullet from its muzzle towards that point. What you see of your own bullets goes there as well: your game works out a copy of each of your shots by itself, to draw the sparks, marks and blood where it hits, and that copy still went straight ahead from your eye, so in third person those landed beside the crosshair (by about as much as the camera is to the side) while the damage was done under it, and a zombie could be hit with no blood shown. The plugin turns that copy the same way, at the same point, and so does this now. A bullet's tracer (for the weapons that have one) starts at the gun now as well: the game starts it at a point in front of your eyes, which in third person is in front of the head, not the gun; the plugin moves it to the gun's muzzle on your model, and so does this, from the pre-patched executable. Rockets, grenades and other projectiles are turned as they are fired or thrown: from where they start they fly at that point, as fast as they would have flown straight ahead (set aae_freeaim_nonbullet 0 in the console leaves those alone, as with the plugin). One thing that flies is left as the game made it: the landing explosion of the mod's PhD Flopper. The mod's script makes that explosion as a missile fired straight down from above the player's feet, and the plugin turns it like any shot, so in third person the explosion went off far away, at the point under the crosshair, instead of around you (on Windows it still does). The rule: a missile of one of the two weapons the mod's script uses for it (launcher_standard_upgraded and pistol_standard_upgraded) that flies straight down, with no more than a thousandth of its speed to any side. Fired by hand those weapons go to the crosshair as before, because no view looks straight down. That is for the player on the machine that runs the game (playing alone, or as the host). A player in somebody else's game tells the host where they aim the way the plugin does (their game sends the point as a client command, aae x y z, at most 20 times a second and only when it changed), and a host takes that from its guests, so it works between a Mac and Windows players with the plugin, whoever hosts. That part follows the plugin's rules and gives the same results as the plugin's own code for every case run through both, but it has not been tried between two machines yet. BO3MACFIX_FREEAIMDEBUG=1 in the environment logs when it goes on and off and where shots go. Applies after a restart. |
AAEGrenadeArc |
1 | The line All-around Enhancement 4 shows while you hold a grenade, where it will fly (its option Grenade Projection at "Prediction Line And Fuse Timer" or "Prediction Line Only"). The game itself draws such a line only in the campaign's Tactical Mode, so on the Mac the option showed none. On Windows the mod's own build of T7Overcharged makes the game draw it whenever the mod's script asks for one (while you hold a grenade in first person, and for two weapons that aren't grenades), and the mod's plugin starts it at the weapon in your hand instead of in front of your eyes, with its first stretch bent smoothly onto the curve. This does the same, by their rules, with the plugin's guards against an arc longer than the game keeps. Only when the game runs from the pre-patched executable. BO3MACFIX_ARCDEBUG=1 in the environment logs when the line comes and goes and where it starts. Applies after a restart. |
AAEMantling |
1 | Mantling in zombies as All-around Enhancement 4 sets it up. The game has two ways over an obstacle: the old one, which works where a map's maker put a mantle brush, and the newer one from multiplayer, which finds ledges by itself while you jump at them. Since 4.0 the mod switches most maps to the newer one (traverse_mode 1) and gives its rules in dvars that only its Windows plugin reads: aae_t7_mantle_height (the highest ledge), aae_t7_ignore_mantle_checks (anywhere, or only at mantle brushes), aae_t7_move_input_threshold and aae_t7_high_height_offset. Without the plugin the game's own rules stay, and in zombies those allow no ledge at all, so on those maps nothing could be climbed. BO3MacFix applies the mod's rules as the plugin does, and like the plugin turns the newer way on for zombies (trm_enabled) when the loaded mod has the plugin, so the game loads its animations at a map's start. Where a jump would get you onto a ledge, the game's mantle prompt is shown, by the plugin's rules: only in a LAN game ("play local" in the menus, or a map started with devmap), not in one started from the online lobby, and not for ledges lower than 30 units. A vehicle in the way has the plugin's rule of its own while the mod asks for mantle brushes: it can be climbed from the sides its kind of vehicle allows, and from nowhere else. Nothing changes without the mod, or on the maps it leaves on the old way. When the game doesn't run from the pre-patched executable, which animation a ledge of 96 units or more gets stays the game's own choice. BO3MACFIX_MANTLEDEBUG=1 in the environment logs each ledge found, the animation chosen and when the prompt comes and goes. Applies after a restart. |
AAEBulletDepletion |
1 | The bullets on a belt-fed gun's belt go as its magazine empties, for the guns All-around Enhancement 4 lists in its T7Overcharged/viewmodel_hide.cfg (the game's own BRM, and machine guns of custom maps' weapon packs such as the RPD, MG4, M60, LSAT or MG82). On Windows the mod's T7Overcharged hides them; on the Mac the belt stayed full. This does it by T7Overcharged's rules, after the game's own update of the gun's moving parts and the mod's moves each frame: with n rounds in the clip, the listed bullets from number n on are hidden (all of them in an empty clip), each moved out of sight; the second gun of a dual wield weapon by its own clip. The mod's own switch, the dvar bullet_depletion_disabled (its client script sets it, by the script's texts around machine gun reloads), turns it off while it is set. The file is read once, when a map's gun is first drawn. Nothing changes without the mod. BO3MACFIX_VIEWMODELDEBUG=1 in the environment logs the clip and which bullets are hidden whenever that changes. Applies after a restart. |
AAEGunPosition |
1 | All-around Enhancement 4's gun position option (sliders in its pause menu that move and turn the first person gun) and the mod's other moves of the gun's parts. The mod writes them into dvars, viewmodel_p0_move0 to _move4, each a part of the first person gun with three numbers to move it by and three to turn it by, and on Windows its T7Overcharged reads them. Nothing read them on the Mac: the sliders did nothing, an empty gun's bolt or slide wasn't held back where the mod's weapon table asks for it, and the gun didn't tilt as you lean. This does what T7Overcharged does, by its rules, after the game's own update of the gun's moving parts each frame: the dvars are read from _move0 on until one is missing or empty; skip, or a ! or # in front, switches one off; one whose numbers aren't all numbers stays as it last was; the numbers keep six digits; and a viewmodel_move.cfg in the mod's T7Overcharged folder (the mod has none) is read once. Like T7Overcharged it leaves a dvar's move in place when the dvar is later emptied; the mod switches its moves off with a move by nothing instead. Nothing changes without the mod. BO3MACFIX_VIEWMODELDEBUG=1 in the environment logs each dvar's text when it changes and what each move does to which part. Applies after a restart. |
AAEPrompts |
1 | All-around Enhancement 4's prompts in the world, kept by distance. The mod marks things of its own (the Gambler, the ammo bag, a power switch) with the prompts the campaign uses: a name, the button and what it needs, sitting on the thing itself. Its widget shows a prompt when you're near and hides it otherwise, by what the game says about each prompt (nearTo, isFarAway). The game only says that in the campaign, so in zombies every prompt on the map was shown in full all the time. The mod's Windows plugin makes the game say it in zombies as well, and so does this, while the mod with the plugin is loaded. The plugin's glide is there too: the prompt you can use right now is drawn at a fixed place of the screen, and when it stops being that one it glides back to its thing instead of jumping there. Only when the game runs from the pre-patched executable. BO3MACFIX_PROMPTDEBUG=1 in the environment logs when a prompt becomes the one to use and when a glide begins and ends. Applies after a restart. |
AAEGestures |
1 | All-around Enhancement 4's left-hand gestures: when you pick something up, open a door, turn the power on, revive somebody, drink a perk, ping or print, the mod shows your left hand doing it. The hand is an entity the mod's script links to the camera, and the game only notes such an entity in a list of four: nothing puts it at the camera, and nothing takes it off the list again. So without the mod's Windows plugin the hand wasn't shown where it belongs, and as one gesture is played while the map starts, the fourth one of a game was a script error ("Max camera linked entities reached") that ended the gestures for the rest of it. The plugin finishes the game's half, and so does this, by its rules: each frame a linked entity is drawn only once the view of the frame is worked out, at the view's place plus its offset, with the view's angles (or its own, as the script asks), and an entity comes off the list when it is deleted. (The plugin also keeps the list across the game's own save and restore, which only its zombie checkpoint uses; BO3MacFix's saved games start a new game, where the list begins empty.) Only when the game runs from the pre-patched executable. BO3MACFIX_LINKCAMDEBUG=1 in the environment logs each link and delete and where the hand is put. Applies after a restart. |
AAECoopPause |
1 | Pausing a co-op game with All-around Enhancement 4. The game pauses only for a player alone on their machine: with anybody else in the game its own rule takes the pause back at once, so in co-op nobody could pause. The mod's Windows plugin lets the host (the player whose machine runs the game) pause it for everybody, and so does this, by the plugin's rules and with the plugin's own messages over the game's connection, so Mac players and Windows players with the mod pause each other either way round. The host presses the menu key: the host's view stops at once and every other player's game is asked to pause; each one pauses (the mod opens its pause menu there with the game's pause hint, and it can't be closed until the host resumes) and answers; once all have answered, the host's game stops too. If somebody doesn't answer within 3.5 seconds (a player without the plugin, or one still joining when the host pauses), the pause is given up for everybody: the host's pause menu closes by itself, and the host can pause again. If somebody joins while the game is paused, the zombies move again until the newcomer has loaded in, while every player stays frozen (the plugin does the same); the host can resume at any time. A paused player who hears nothing from the host for 10 seconds resumes by themselves. Only the host can pause, and not in a public zombies match (the mod's own rule; the others see the mod's note about it). Two players sharing a Mac (split screen) can pause as well. Needs the pre-patched executable. BO3MACFIX_COOPPAUSEDEBUG=1 in the environment logs what it sees: the players in the game, who may pause, and the messages sent and received. Applies after a restart. |
AAEHoldBreath |
1 | What All-around Enhancement 4's T7Overcharged tells the mod about aiming and holding your breath. Holding your breath with a scope is the game's own and was always there on the Mac as on Windows: aim all the way down a scope that sways and hold the button for it (the left stick or Shift by default, +breath_sprint), the sway steadies for a few seconds, then the player breathes out, or gasps when they held it too long. The game never lets a player with Deadshot Daiquiri hold their breath, and the mod's Perkaholic start gives Deadshot on every map tried (Kino and Shadows of Evil), so with Perkaholic on it can't be held at all, on Windows the same. On Windows the mod's T7Overcharged takes the place of the game's function that draws the "Hold [key] to steady" hint and works out an "aim status" there: 1 while you aim all the way, 2 when holding your breath would steady the weapon, 3 while you hold it, 4 through a scope with zoom levels, 0 otherwise. It hands that to the mod in the dvar aim_status (0 to 5: the game keeps the last of those, so it reads 3 the whole time you hold your breath) and in two HUD models (hudItems.breathStatus and hudItems.breathStatusText), and it registers aim_status and holdBreathTimer when the mod starts it. This does the same by its rules while the mod is loaded, and leaves the hint the game's own (T7Overcharged also draws it in a killcam, while flashbanged or with cg_drawBreathHint 0). In 4.1.7 nothing the mod runs reads these yet, so nothing changes on screen. BO3MACFIX_BREATHDEBUG=1 in the environment logs each new status with the game's hold breath timers and, when it changes, whether the game holds the breath and draws its hint and what stops it. Applies after a restart. |
AAEViewmodelWidgets |
1 | Two Lua functions for HUD widgets on the first person weapon, as All-around Enhancement 4's Windows plugin adds them. The mod doesn't use them yet (4.1.7 calls neither), so this changes nothing you can see today; they are here so that a version of the mod that uses them works on the Mac as it does on Windows. The game's UI elements can be set up with setupGeneric3DWidget to be drawn at a point of the world; the plugin adds two methods next to it for widgets that sit on a bone of the weapon you hold (tag_weapon_right, the right hand's, unless the mod names another): setupViewmodelTagWidget(tag, x, y, z) draws the element there, moved by x, y, z along the bone's own directions, and setupViewmodelTagWidgetLine(tag, x, y, z, callback) calls the mod's function each frame with that place on the screen (or nothing while there is none). This adds them by the plugin's rules: the same arguments, the same limits (128 tags, 1024 widgets of each kind, offsets of at most 1,000,000), the same sums for the point, nothing returned. They only exist while the mod with its plugin is loaded, as with the plugin. One difference, on purpose: when the UI starts again (each map's start, map_restart), a line set up before forgets the old UI's Lua state and references. The plugin keeps them and gives them back when an element at the same place is set up again; the new UI gets the same reference numbers again, so it would give back the new line's own. BO3MACFIX_VMWIDGETDEBUG=1 in the environment logs when they are added and each time they are used. Applies after a restart. |
AAELanJoin |
1 | Joining All-around Enhancement 4 games on your local network from the mod's LAN server list, with players whose game has the mod's Windows plugin, as that plugin does it. The list ends in connect <address>. The game's own connect asks Steam about that address and joins the Steam game server it finds there; the plugin joins the host player's own Steam ID instead, directly, and learns it by asking the host's game (a small UDP query to port 27018, which the host's plugin answers), or takes it from the address when it's written address@steamid. A Mac could do neither. Now, as a host, BO3MacFix answers the plugin's query the plugin's way: only queries of exactly its form, only from addresses of a local network (10.x, 172.16 to 172.31, 192.168.x, 127.x, 169.254.x), only while the game is in LAN or online mode, and only with your Steam ID; it keeps that port open only while the mod is loaded. As a joiner, a connect to an address of a local network asks that address the same way (twice at most, a third of a second in all) and joins the host's Steam ID; without an answer it joins the server's, directly, as the plugin does. As a host it also lets in, as the plugin does, a joiner whose playlist or ffotd version differs from yours (in an online game), and, after set aae_offlinejoin 1 in the console, a joiner coming from online mode into your LAN game; those two need the pre-patched executable. Lobby messages to another player go through your own Steam networking first and through the game's Steam server only when that fails, as the plugin sends them, since a player who joined you by your Steam ID knows you by that. Nothing is sent anywhere else. Not yet tried with a second machine on the network. BO3MACFIX_LANDEBUG=1 in the environment logs each query answered or refused and each connect, with what a join between two games compares (the versions, the netfield checksum, the changelist and the protocol version), so that two players' logs can be laid side by side. Applies after a restart. |
MoreScriptVariables |
1 | Gives the server's scripts 524,288 script variables instead of the game's 130,000. Every value a script holds takes one, and when they run out the game ends the match with a script error. All-around Enhancement 4 fills them much further than the game alone (solo, Shadows of Evil starts with about 80,000 in use), and its Windows plugin raises the limit the same way. The game's own 130,000 are used first, so nothing changes until they would have run out. Applies after a restart. |
AAEHostMigration |
1 | Host migration with All-around Enhancement, as its Windows plugin makes the game do it. When the host of an online game leaves, the game either hands the game to another player (everyone stays in the match, round and points included) or ends the match for everyone. It ends it whenever any mod is loaded, so with the mod a Mac host who left ended the game for the friends still playing. With this on, while the mod with its plugin is loaded, an online game goes to host migration instead (offline and LAN games are left as they are), and in a custom game two of the plugin's fixes come along: when every player's rating for hosting is 0 (the game gives a player 0 who can't reach all the others, which in a custom game can be everyone), the first of 2 to 4 players is taken anyway, and the game's message telling the players where the new host is goes through the party lobby when the game's own lobby can't send it. The game asks for host migration when the host quits a public (ranked) online game from the pause menu, in zombies once enough players are in it; in a custom game quitting ends the game for everyone in any case, and only hostmigration_start typed in the console asks for it. It only does something on the host's machine, so it matters when you host. Only when the game runs from the pre-patched executable. Not tried with a second player yet: on one Mac only the decision itself could be watched. BO3MACFIX_HOSTMIGDEBUG=1 in the environment logs each decision, each pick of a new host and when the message goes through the party lobby. Applies after a restart. |
AAEMovement |
1 | The movement changes of the mod's own build of T7Overcharged, which All-around Enhancement 4 switches on for every player on Windows. Sprinting: in any direction, with stronger strafing (0.9 of the stick instead of 0.667) and full sprint speed at once; where the game's sprint leap is on (in zombies it is off unless something turns sprintLeap_enabled on), its full strength after half a second. Jumping: no penalty for jumping again and again (no lost height, no slowdown and no camera dip on landing), the next jump right away and more control in the air. Sliding: a slide asked for in the air starts on landing at any speed (the game wants 150), no slow build-up of speed after a slide, the view free while sliding, and a sprint can start out of a slide. A slide on the ground still needs a sprint, and the stance button held for a tenth of a second: a quicker tap only crouches, in the stock game too. Aiming: for a player who holds the fast ADS perk the sights come up 1.4 times as fast with every weapon, sniper rifles included (the game's own perk: twice as fast, but not with sniper rifles). They follow the mod's own switches as T7Overcharged does (the console commands movement_patch and movement_patch_all, the dvars t7o_omnimovement, t7o_strafe_speed_scale and t7o_perk_fastads_multiplier), so a map or an option of the mod that turns one off turns it off here too (but for the full height of a quick second jump, which stays, as with T7Overcharged). Only while the mod with T7Overcharged is loaded, and only when the game runs from the pre-patched executable. BO3MACFIX_MOVEDEBUG=1 in the environment logs what acts. Applies after a restart. |
LuaHeapGrowth |
1 | Lets the Lua VM that runs the menus and HUD have more memory when its own runs out. The game gives that VM 60 MB at start and never more: when a mod's menus and a map's own fill them, the game stops with Lua State "UI": Out of memory. With this on the VM then gets another block of at least 4 MB, up to 6 blocks and 24 MB in all, the numbers All-around Enhancement 4's Windows plugin uses. Nothing changes while the 60 MB are enough (on Kino with the mod the VM holds 21 MB); log.txt says so in a line starting with lua heap: whenever a block is added. Applies after a restart. |
LuaUnrefFix |
1 | Makes releasing Lua reference 0 do nothing. The game's Lua (HavokScript) writes the slot before a reference's number when the reference is released, and for 0 that is 16 bytes 64 GB behind the table: a crash, or damage to whatever lies there. The game does it when it frees a menu element whose animation state holds no reference. All-around Enhancement 4's Windows plugin guards that call; this guards every release. log.txt counts them in lines starting with lua:. Applies after a restart. |
FixUIErrorOnRestart |
1 | Keeps the "UI Error 74046 / Attempt to call a nil value" lines off the screen that All-around Enhancement shows top left after every RESTART LEVEL (19 to 31 of them in the first seconds), as T7Overcharged does for its Windows players. They come from the game itself: when the restarted level fills the HUD's data again, the game calls HUD functions that went away with the restart, and reports each one that isn't there. With this on and the mod loaded, the errors of that one place (a UI model's subscribers) are only counted in log.txt, in lines starting with UI errors: with the error's text; every other UI error is shown as before. Off, or without the mod, the game reports them as it always did. Applies after a restart. |
T7OCrashGuards |
1 | Guards two places where the game crashes by itself, as T7Overcharged does for All-around Enhancement's Windows players. When the game sets up a weapon with attachments, it reads which of the weapon's values the attachment that changes its mode (an underbarrel, say) replaces, without looking whether the weapon's table has an entry for that attachment: a weapon without one, a mod's typically, crashes the game. With this on a missing entry replaces nothing and the weapon keeps its other attachments' values, T7Overcharged's rule. And when something asks for the controller of a local player the game doesn't have (the menus' Lua does for a controller no player uses), the game looks outside its table of two players; with this on the answer is "no controller" without that. Both only from when the mod has loaded T7Overcharged; the weapon guard needs the pre-patched executable. log.txt counts what each caught in lines starting with T7O crash guards:. Applies after a restart. |
MoreMapMemory |
1 | Gives the game a second 2 GB of address space for the files it loads. Its own 2 GB (the main address space of its db stack) hold the map, the mod and the common files together, and when a file's next block doesn't fit the game stops with Need ... more bytes of 'main' address space in stack 'db' and Out of memory. With All-around Enhancement loaded that happens on big custom maps (Mob of the Dead Remastered, Call of the Dead, Luigi's Mansion). With this on, what doesn't fit goes into a second address space, as with the mod's Windows plugin; log.txt says so in a line starting with map memory: when that begins. Nothing changes while the 2 GB are enough. Applies after a restart. |
MoreClientEffects |
1 | Gives client effects (the effects a map plays on your side: fire, smoke, lights, explosions...) a table of 2048 instead of the game's 1024. The game keeps the effects a map uses in a table of 1024, and when a map's own effects and a mod's need more, the map stops loading with BG_Cache_GetIndexInternal - Exceeded '1024' items for type 'client_fx'. With All-around Enhancement on that happens on some big workshop maps (zm_cum_on_my_face, zm_mcdonaldsfinale). The mod's T7Overcharged gives client effects a table of 2048 when it starts, while its dvar hook_extend_clientfx is 1 (the mod sets it to 1); this does the same, from the first time a mod starts T7Overcharged in a game, and log.txt says so in a line starting with client effects:, and again when a map goes past the game's 1023. Without a mod that starts T7Overcharged nothing changes. Two script functions (SpawnFX, PlayFXOnDynEnt) still refuse effects past the first 1023, as with T7Overcharged. BO3MACFIX_CLIENTFXDEBUG=1 in the environment also logs each reset of the table with how full it was. Applies after a restart. |
SharpFonts |
1 | Draws menu and HUD text from letters twice as detailed, as All-around Enhancement 4's Windows plugin does. The game draws each letter once, at the size it has in the 720-line picture its menus are laid out in, and stretches that to the screen, so text looks soft on anything sharper. With this on, each letter is drawn twice as big into the game's font atlas; its size and spacing on screen stay exactly what they were. Text of 64 pixels and more and text with an effect isn't touched: the game draws those in a way that already stretches well. The plugin's switch works too: set aae_lui_font_enabled 0 in the console turns it off during play, 1 on again. Applies after a restart. |
ClientFieldGuard |
1 | Keeps a map's or mod's script from crashing the game when it asks for a client field nobody registered, with or without All-around Enhancement. Client fields are the values the server's scripts send to a player, the world or the HUD (perk icons, power-up timers and the like); a script registers each one by name and then sets or reads it by that name. Most of the game's builtins for that don't check that the name was registered, and for one that wasn't they read through nothing and crash. DEIMOS 935 (zm_ou_deimos) did, about 30 seconds into a game with the mod: its HUD asks for the timer of every timed power-up, also of the mod's own Purifier, which the map doesn't know and never registered. With this on, those builtins throw the game's own script error instead (No ClientField named ... found in set ..., the words the game uses itself with com_clientFieldsDebug on): the script gets undefined and goes on, so the game plays on and at most the value that script wanted doesn't show. QuietScriptErrors shows the error 3 times at each place in console_mp.log and then only counts it (DEIMOS's HUD asks about 20 times a second). The game's two value getters, which its own code also calls, read such a field as 0, the value every field has before the server sets it. The guard only acts where the game would read through nothing next, so a game whose scripts only ask for registered fields is unchanged. T7Overcharged, which the mod ships, names these places for this fix, but its build in AAE 4.1.7 doesn't apply it, so Windows players don't have it. log.txt names each missing field once for each place that asked for it, in lines starting with clientfield: (after 64 different ones a line says so and no more are named); BO3MACFIX_CLIENTFIELDDEBUG=1 in the environment says more. Applies after a restart. |
ModUnloadFix |
1 | Keeps the game from crashing when you unload a mod in the game (MODS, Unload) or load another mod over it, after the game started with the mod already on: with StartWithMod, or +set fs_game <mod> on the command line. Without it, All-around Enhancement 4.1.7 crashes the game that way every time, a moment after the stock menus come back. The game has two Lua machines, one for the menus and one for the lobby, and both run a Lua file's code where the file lies in the memory of the mod or map it came from. The menus' one is made anew when that memory goes; the lobby's is made at the start and kept through every change of mods and maps (the game makes it anew only at its lobby_reload command and when it fetches its online storage files again; the Windows game does the same). All-around Enhancement ships its own copy of a file the lobby's Lua loads too (lua/shared/luareadonlytables.lua, through which it replaces Engine.PrintInfo and five more functions), and when the mod is loaded before the lobby's Lua is made, the lobby takes the mod's copy; unloading the mod then frees the code the lobby goes on calling. With this on, the lobby's Lua gets its own copy of each file it loads, about 1 MB in all, kept until the game closes that Lua machine, so the lobby goes on exactly as it did while the mod was loaded. A start without a mod, or one that loads the mod from MODS, never had the crash: the lobby's Lua is made before the mod is there. log.txt says it is on in a line starting with lobby lua:; BO3MACFIX_MODUNLOADDEBUG=1 in the environment names each file kept. Applies after a restart. |
MissingMapGuard |
1 | Keeps the game from crashing when the lobby starts a map it can't load, with or without All-around Enhancement: a map that isn't installed or isn't owned (a DLC map you don't have, or one unchecked in Steam's DLC list) or a workshop map that is no longer installed (removed before the game was started; one that goes while the game runs can still be in the game's own list, and then the game does what it did before). The menus' map lists don't offer such a map, but a lobby can still hold one: the mod's custom game lobby takes the map you played last from your profile without asking whether it is still there, and START starts whatever the lobby holds. To start a map the game first shuts the menus down, which frees what it keeps for each local player, and only then tests whether the map can be had; its answer for one that can't ("You do not have this map ...") would take you back to the menus a frame later, but the game reads the freed memory before that and crashes. With this on, the same test, with the game's own functions, is made before the menus are shut down: a start the game would refuse is refused there, with the game's own message, and the game goes back to the menus as it does after any such error. A start the game would accept is left to the game as it is, and every input of the test is the same before and after the shutdown, so no map the game would load is refused. The Windows game has the same code. log.txt says when it refuses, in lines starting with missing map guard:; BO3MACFIX_MISSINGMAPDEBUG=1 in the environment says more. Applies after a restart. |
TextureSwapGuard |
1 | Keeps the game from freeing a picture the screen may be taking up at that moment. Two places of the game replace a picture's texture while the menus are drawn: the CHANGE MAP list of All-around Enhancement shows each workshop map's preview picture, and the menus' streamed pictures (the mod's globe has twenty) get sharper versions as they load. Each freed the old texture at once, the workshop preview even before the picture pointed at the new one. If the drawing thread took the old texture up in that moment (Aspyr's Direct3D layer then waits for any texture being uploaded by another thread, so the moment can last milliseconds), the texture was freed twice and the game crashed in the menus: a crash report on a "Win" thread with malloc_zone_error, one of two ways to get it (AtomicRelease closes the other). With this on, those places hand the old texture to the game's own delayed release, which the game already uses for one kind of streamed picture: it frees it as a rule after at least 4 of the drawing thread's frames, sooner when a load pauses the streamer, and never sooner than without this. When that queue is nearly full, a texture is freed at once as without this, so the game's own uses of the queue always find room; where nothing can be drawing the picture (the default pictures that take the menus' place when the menus are unloaded, at every start of a map and during a mod load, while the drawing thread only shows the loading screen) the game's own way is left as it is. The new picture shows at once; the old one's memory is held for those few frames. BO3MACFIX_TEXTURESWAPDEBUG=1 in the environment logs how often each place hands a texture over. Applies after a restart. |
AtomicRelease |
1 | Frees a graphics object once when two parts of the game let go of it at the same moment. Every texture, view, buffer and state of Aspyr's Direct3D layer counts who still uses it, and its Release lowered that count and then decided from a second, separate look at it whether the object was now unused: when two threads (the drawing thread and the main thread, say) dropped the last two uses within the same instant, both could see zero and both freed it, and the second free crashes the game (a crash report on a "Win" thread with malloc_zone_error; a picture taken up again while it is being freed gives the same report through a wider opening, and that one is TextureSwapGuard's to close, not this setting's). Run under Rosetta with the game's own code, that happened about once in 60,000 such instants. With this on, the decision is taken from the one atomic step that lowers the count (both of the object's counts are one 8-byte word, exchanged as a whole), so exactly one of them frees it; the counts themselves are computed as before. It costs a fraction of a nanosecond per release as the game uses them, about 3 when a release directly follows the taking of the same object. A release of an object that was already unused is a fault somewhere else; log.txt names it in lines starting with refcount:. Applies after a restart. |
PreviewCache |
1 | Keeps the last six workshop preview pictures loaded (at most 64 MB of them). The game shows a workshop item's previewimage.png in All-around Enhancement's CHANGE MAP list and the mods list, and asks for it again on every change of focus, twice: each step through the list decoded a PNG of up to 2560x1080 on the game's main thread and uploaded it to the graphics card, twice, a small stutter each time (log.txt showed every picture "loaded" twice in a row, the same one up to six times). With this on, a picture that is kept is shown again at once; a picture is kept by its file as it is on disk (its path, size and modification time), so a workshop item that was updated is loaded anew and never shown from an older copy. A picture on screen is never let go of. BO3MACFIX_PREVIEWDEBUG=1 in the environment logs each picture shown again. Applies after a restart. |
MaterialSortGuard |
1 | Keeps the game from crashing when it draws something whose material its renderer hasn't taken in yet, with or without a mod. The renderer keeps every material it has in a sorted table and draws a surface by the place its material has there; only its sort fills that table, and it waits while files are being loaded (R_Init empties the table too). So right after new files come in, their materials name places the table doesn't have yet, and if the game draws one of them in those frames it reads an empty place and crashes, in the main thread or the render thread. That is what happened 37 seconds after a start in which the mod was loaded from the game's MODS menu: the game went on to the zombies lobby by itself and loaded its files while the menu's 3D scene was drawn. With this on, such a surface is left out of the frame until the sort has taken its material in, which is when the files being loaded are in (about three seconds behind the lobby's spinner on the start that crashed), so at most a thing appears when the loading is done; everything else is drawn as before, and a game that never draws such a surface is unchanged. The Windows game has the same gap. log.txt says when it leaves something out, in lines starting with material sort guard: (the first three times, then at each power of two); BO3MACFIX_MATERIALSORTDEBUG=1 in the environment also logs each change of the table's state. Applies after a restart. |
ExitFix |
1 | Quits without the crash (and crash report) Aspyr's shutdown causes every time. |
KeepCrashLogs |
10 | Keeps the log of a game that didn't end by quitting. BO3MacFix/log.txt is written anew at every start from Steam, so the log of a crash used to be gone as soon as the game was started again. Now the log before is kept as log-previous.txt, and when that run didn't end by quitting (a crash, a force quit, a power cut) or ended with an error (a fatal error closes the game with an exit status other than 0) also as crash-<the date and time it started>.txt. What is kept of a log is its end: one bigger than 16 MB keeps its last 16 MB, with a first line that says how much was left out. The newest N crash logs are kept, and no more than 64 MB of them together; the oldest by the files' own time go first. At the start after it, BO3MacFix adds a summary of macOS's crash report of that run (how and where it crashed) and shows a notice with the file's name, once; when macOS has written no report a minute after that start (a force quit, a power cut or an error leaves none), the crash log says so, if the game is still running then. Every log also starts with its date and time, the BO3MacFix build, the macOS version, mains or battery and whether settings.ini was read, and has a line with the time once a minute (after the Mac slept, one line says how long nothing was written) and whenever a menu opens or closes (menu: ZMGlobeMapSelect opened over ChangeMap) or a map loads. Quitting writes a line ended by quitting (exit status 0), a fatal error ended with an error (any other status), whatever ExitFix is: a log without either is from a game that didn't end by quitting. 0 turns all of this off, log.txt as before. Applies after a restart. |
SkipIntro |
1 | Starts without the Black Ops III and Aspyr logo movies (about 31 seconds of them, while the title screen is ready about 12 seconds in), so the title screen comes up about 20 seconds sooner. Only when the game starts at the title screen: with +map, +devmap or +connect on the command line the movies play as usual, because a +map start plays the logo while the map loads in place of the map's own loading movie, which the match waits for (3.5 minutes on Shadows of Evil). Applies after a restart. |
StartWithMod |
1 | Starts the game with the mod that was loaded when you last quit it, as if +set fs_game <mod> were on its command line. Without it every start comes up in the stock game, and loading the mod from MODS unloads the menus, loads the mod and builds the menus twice more behind a spinner (about 14 seconds); started with the mod, the game loads it before its first menu and comes up in the mod's own start screen about 15 seconds sooner (Return, then ZOMBIES: offline that is the LAN lobby the menu load goes to by itself). BO3MacFix notes the mod that is loaded in BO3MacFix/lastmod.txt when the menus are up and the game has finished loading it, and the launcher (AppBundleExe, which Steam starts) adds it at the next start; a mod that stops the game while it loads is never noted. Unload the mod (MODS, Unload) and quit, and the next start is the stock game again; the stand-in usermaps that custom maps load without a mod is never remembered, nor a mod whose folder name has a space or other characters a command line can't carry. The launcher adds nothing when the command line has its own fs_game or starts a map, when the mod's core_mod.ff isn't there (a notice says so) or Steam is downloading it (a notice too). If a start with the mod doesn't get as far as the menus with the mod loaded, the next start is the stock game with a notice, and the mod is forgotten until you load it from MODS again: a mod that stops the game while it loads can't do it at every start. Quitting during a start (Cmd+Q before the menus are up and the mod has loaded) counts as such a start: the next one is the stock game with that notice, and the mod is loaded from MODS once more. Needs the launcher of this version (launcher.log says what it did). Applies at the next start. |
AudioFollowsDefault |
1 | Moves the game's audio to the new default output device, e.g. when AirPods connect or disconnect. |
Notices |
1 | Shows a short notice at the top of the screen when a controller connects or disconnects (with its battery level), when its battery gets low (20, 10 and 5 %), and when the game moves to another display. The controller ones need ControllerBridge. |
AutoSave |
1 | Saves a solo zombies game by itself each time a new round starts, to the same BO3MacFix/checkpoint.ini as the settings page's Save game, so a crash or a force quit loses at most the round being played. A game saved at a higher round stays unless this game resumed it, and a notice says "Saved round N". The file is written on a background thread, at most every 15 seconds. The page's Delete saved game removes the save. |
QuickSave |
96 | A key that saves a solo zombies game like the settings page's Save game, with the same checks: the macOS key code of F5 (96), F6 (97), F7 (98), F8 (100) or F9 (101), or 0 for off. Holding L3 + R3 for a second in the pause menu does the same, with ControllerBridge; All-around Enhancement's Discord invite, which opens on R3 in that menu, then stays closed (R3 alone opens it a fifth of a second later than the mod does, the time it takes to tell). A notice says "Game saved: round N" or why not. A game saved at a higher round that this one didn't resume takes a second press within 5 seconds; with Notices off (the question can't be shown) the key doesn't replace it, the settings page's Save game row does. |
ResumeKeepsBank |
0 | Keeps All-around Enhancement's bank and weapon locker usable in a resumed game. The mod switches both off for a game in which a player has more than 500 points before the first points are earned ("Illegal Scores Detected"), which every resume with more points was. With this on, a resume starts the game with 500 points and hands the rest of the saved points over a moment after the first points you earn, through the game's own function for adding points (with the pause menu open, as soon as you close it); a save made before that counts them in. It is a way round a check the mod's author put in, so it is off unless you turn it on; the mod's other limits (120,000 points before round 7, 1,000,000 later) still apply. |
FrameStats |
0 | Logs the frame rate, 1% low and worst frame time every N seconds. |
BatterySaver |
0 | The battery settings in one: while the Mac runs on battery, 1 (Saver) limits the frame rate to 40 (BatteryFPS), the 3D scene to 85% of ResolutionPercent (BatteryResolution), an untouched menu to 20 fps (IdleMenuFPS), the game behind another app to 15 fps (BackgroundFPS), and lets the display sleep when idle (IdleDisplaySleep 1); 2 (Longest) does the same at 30 fps, 70%, 15 and 10 fps. Where your own setting saves more (a lower limit), it stays. The menu's and the display's parts act only with ControllerBridge, as those settings themselves do. Plugged in, nothing of it applies. Measured on mains (the GPU's own energy counter): DEIMOS at the battery limit of 40 fps 10.9 W at full resolution, 7.1 W at Saver's 40 fps and 85%, 3.2 W at Longest's 30 fps and 70%; Kino 3.3 W at 40 fps and 100%, 2.1 W at 70%; a paused game behind another app 7-10 W of GPU at 30 fps, 2.6 W at 10. 0 = off. |
BatteryFPS |
0 | Limits the frame rate to N (30 to 240) only while the Mac runs on battery, to save power. A display shows each frame for a whole number of its refreshes, so on a 120 Hz display 45 comes out at 40 fps and 90 at 60; the settings page offers Off, 30, 40 and 60, which come out exactly there (another value set here still shows on the page). |
BatteryResolution |
0 | Renders the 3D scene at N% of ResolutionPercent at most (50 to 95; the settings page offers 85, 75, 70 and 60; any other value in settings.ini counts as off) only while the Mac runs on battery, to save the GPU's power; the HUD stays at full resolution, and MetalFX (if on) scales the whole picture as before. At a frame limit the GPU has room, so DynamicResolution keeps your full resolution and every frame costs the GPU that much: measured at 40 fps on mains, DEIMOS's GPU drew 10 W at 100%, 7.4 W at 85% and 4.8 W at 70%, Kino's 3.3, 2.6 and 2.1 W. Unplugged, the scene goes down to N% within about 6 s (the power source is looked at every 5 s) and stays there. Plugged in: with DynamicResolution off, your own resolution again within about 6 s; with it on, where its floor is above N, at once to that floor, and from there (and otherwise) by DynamicResolution's own steps up: a 5% step after every 8 s with room on the GPU, from 70% to 95% about 40 s on Kino, and lower where the GPU can't hold the display's rate, as DynamicResolution does anyway; with a frame limit on battery (BatteryFPS or BatterySaver), which lifts when you plug in, it takes no step down for 3 s while the GPU speeds up after it (see DynamicResolution). A desktop Mac or a UPS never counts as battery. config.ini keeps your own value. 0 = off. |
LowPowerFPS |
0 | Limits the frame rate to N (30 to 240) while macOS's Low Power Mode is on (System Settings > Battery, or Control Center), on battery or plugged in: that is the player asking macOS to save power, and the game otherwise renders as fast as it can in that mode too. Roughly, on an M5 Pro in a zombies match, the Mac draws 66 W at 120 fps, 40 W at 60 and 24 W at 30. 30 is even on 60 and 120 Hz displays. The mode is checked every 5 seconds, so the limit follows it within a few seconds. 0 turns it off. The settings page offers Off, 30, 40 and 60. With other limits on too, the lowest that applies wins. |
PauseMenuFPS |
30 | Limits the frame rate to N (30 to 240) while the pause menu is open in a match, to save power, and lifts the limit as soon as it closes. 0 turns it off. The settings page offers Off, 30, 40 and 60, rates that divide a 120 Hz display's refresh evenly (45 came out at 40 there). With FramePacingFPS or BatteryFPS on too, the lowest limit wins. |
MenuFPS |
40 | Limits the frame rate to N (30 to 240) in the menus outside a match (the main menu, the lobby, the mods menu), to save power: the stock main menu otherwise renders at the display's 120 Hz. It ends as soon as a match starts, and as a map starts loading. 0 turns it off. The settings page offers Off, 30, 40 and 60. With other limits on too, the lowest that applies wins. |
IdleMenuFPS |
0 | Limits the frame rate to N (10 to 60; the settings page offers 15 and 20) while the game is in the menus, or its pause menu is open and the game is really paused (a co-op or LAN match goes on behind the pause menu: not then), and nothing has been pressed for 10 seconds: no key, mouse, trackpad or controller input. Needs ControllerBridge: only through it is a controller's input seen, so without it this stays off (a controller player's menu would count as idle while they use it). A paused game still draws the whole scene behind the menu (Kino: 2.26 W of GPU at the pause menu's 30 fps against 0.77 W at 10, measured on mains). The first input brings the menu's own limit back: a controller's when it happens, a key's within about half a second (at the next of the menu's polls, which run on its frames). With other limits on too, the lowest that applies wins. 0 = off. |
BackgroundFPS |
30 | Limits the frame rate to N (10 to 240) while the game isn't the active app, or is hidden or minimized, to save power (the game itself keeps rendering at full speed behind other apps), and lifts it as soon as the game is in front again. It only applies with the menus or a match up, not while the game starts or a map loads. 0 turns it off. The settings page offers Off, 15, 30 and 60. |
IdleDisplaySleep |
0 | The game keeps the display on for as long as it runs (its SDL disables the screen saver, because a controller's input doesn't count as activity to macOS), so a Mac left with the game paused or in the menus never turns its display off. 1 (on battery) or 2 (always) lets macOS's own "Turn display off when inactive" apply while the pause menu is open, the game is in the menus or behind another app, from 5 s after you left play until you're back in play. Needs ControllerBridge: through it a controller's buttons and sticks count as activity (and wake the display); without it nothing is let go and the display stays on as before. When play goes on, the game takes the display back and wakes it if it went off (it declares user activity once, and a controller's input for 30 s after). In a match the display stays on as before. 0 = off. |
VoiceMicrophone |
1 | The game has Steam record your microphone for voice chat from the voice system's first frame to the game's end, whether or not anybody can hear you (solo, offline: the same; the engine does it on Windows too), so macOS shows the microphone in use for the whole game and Steam's capture runs. 0: the game never asks Steam to record, so there is no voice chat from this Mac; you still hear other players. Steam's own voice chat (friends, the overlay) can still open the microphone. 1 is the game's own behaviour. Applies at the next start. |
MetalHUD |
0 | Shows macOS's Metal performance HUD (FPS and GPU time). |
GpuDiagnostics |
0 | Logs the window, display mode and Metal layer whenever they change. |
NoCodePatches |
0 | For testing only: leaves the game's code exactly as shipped, without any of the fixes. Solo play only. |
ModWarningDialog |
0 | When a mod tries to load a Windows DLL, BO3MacFix warns once a launch with a notice (and in the log). 1 shows the old "BO3MacFix Mod Warning" dialog instead, which stops the game until it's closed, fullscreen too. |
Most can also be set with an environment variable, BO3MACFIX_ and the name in capitals. When the game is started
from Steam, BO3MacFix's log goes to BO3MacFix/log.txt and the launcher's to BO3MacFix/launcher.log.
If the game crashes (or hangs and has to be force quit, or stops with a fatal error), its log is kept as
BO3MacFix/crash-<date>-<time>.txt in the game's folder, named by when that run started, and at the next start a
notice names the file and BO3MacFix adds to it what macOS's crash report says. That report itself is in
/Library/Logs/DiagnosticReports or ~/Library/Logs/DiagnosticReports (Console shows both under Crash Reports),
named CoDBlkOps3_Exe...ips; the crash log names the one it read. The ten newest crash logs are kept
(KeepCrashLogs), each with at most the last 16 MB of its log and all of them together at most 64 MB, and the log of
the start before is always BO3MacFix/log-previous.txt. When you report a crash, the crash log is the file to send.
All-around Enhancement only runs on the latest Windows build: it compares the game's changelist and build time with
that build's, and on anything else opens its downgrade guide and quits. BO3MacFix gives it the values it expects,
read from AAE's own core_mod.ff when the game starts (once per AAE update, then remembered in
BO3MacFix/aae_build.cache), so an AAE update for a new Windows patch doesn't need a new BO3MacFix. log.txt says
what it found, in lines starting with AAE build check:. If AAE opens its downgrade guide anyway, two settings that
aren't on the in-game page set the values by hand:
| Setting | Example | What it does |
|---|---|---|
AAEChangelist |
13892626 |
The changelist AAE checks for. |
AAEBuildTime |
Wed Dec 10 17:10:46 2025 |
The build time AAE checks for, the rest of the line (quotes are optional). |
AAE shows the game's messages (the bank's "Current Balance", deposits, the answers to its chat commands) through a
printsubtitle console command that it has on Windows and the Mac build doesn't. BO3MacFix adds it, so those
messages show up on the left of the screen, as on Windows.
AAE's key binds (the pause menu's "Enhanced Controls": flashlight, ping, third person, the overhead map, hiding
the HUD...) run a SendMenuResponse console command the Mac build doesn't have either. BO3MacFix adds it, so those
keys work. The number at the end of each bind (200, 50) is T7Overcharged's debounce, in milliseconds: as on Windows,
a bind that comes that soon after the last one (any of them) is dropped, so a key that bounces doesn't toggle twice.
AAE's loading screen lets you skip the map's loading movie with Escape or a left click, through T7Overcharged's
customkeymap command; on the Mac only the controller's A button did that. BO3MacFix adds the command, with
T7Overcharged's rules: a mapped key counts when it comes up, only when no other key is held with it, not while the
console is open, and at most once a second for all of them together. AAE plays the movie, and so maps these keys,
only in a game without cheats, so not after devmap. The log says when the loading screen comes up and when its
movie stopped. BO3MACFIX_T7ODEBUG=1 in the environment logs every key that comes up while the mod has keys mapped.
T7Overcharged also changes a few things in the game by itself when the mod loads it, and BO3MacFix does the same
then: a game this Mac hosts sends up to 125 snapshots a second (sv_network_fps; the Mac's default is 100) of up to
50000 bytes a second per player (sv_maxRate; 20000), and votes, map switching and voice packets are off
(g_allowvote, sv_mapswitch and maxvoicepacketsperframe at 0). They stay so until the game quits, as on Windows.
Ten seconds after it starts, T7Overcharged also gives 35 of the game's dvars fixed flags, and so does BO3MacFix: the
field of view scale cg_fovscale, r_fog, r_zfar, depth of field, the shadow and volumetric settings, the
movement ones (doublejump_enabled, mantle_enabled, traverse_mode...) and others can then be set from the
console without cheats. cg_fovscale, ui_enabled and the controller's stick deadzones also get the flag that older
Call of Duty games save in the config (0x1), as with T7Overcharged, but the Mac's game saves nothing for it: only
dvarlist and dvardump show it, and its settings file, players/config.ini, is a fixed list of settings without
these. So a value set from the console lasts until the game quits, and a later start without the mod doesn't see it.
BO3MACFIX_T7ODEBUG=1 logs each dvar's flags before and after.
AAE's UI colour option also picks a mouse cursor, one of the Windows animated cursors in its T7Overcharged/cursors
folder, through T7Overcharged's cursoroverride command. The Mac keeps its own cursor: BO3MacFix adds the command only
so that the console doesn't say "Unknown command" at every start. The same goes for updateVidConfig, which AAE's
graphics options run for T7Overcharged's own ultrawide settings. DB_FreeUnusedResources 0 1, which AAE's lobby
runs as a match starts from it, frees the game's unused loaded data, as on Windows.
- Alyssa / alltheamps - guidance, help, t7patch and the cod2map64 patch DLL.
- The Dobby project - code hooking on macOS. (used under the MIT license)
- Mickael DE LA ROQUE / mickadlr - the custom map stream-stall workaround.
There are two big issues with Steam Workshop map loading in the current (v98, from 2019) Mac build of BO3:
- Texture (.png) conversion crashes the game when hovering or selecting a workshop map
- Havok navmesh/navvolume files are a different format across PC and Mac
This project hooks into the game to solve both these problems. It solves the texture problem by stubbing out the faulty function, and solves the navmesh problem by converting it on-the-fly using a modded version of the modding SDK. We call Wine from within the native Mac game process to call upon the modding SDK, after saving a snapshot of the Havok navmesh/navvolume data from the map, and the patch to the SDK's cod2map tool takes that input and outputs in the Mac-encoded format.
A campaign mission with broken navigation meshes is also fixed in the same way.
A macOS update updated the version of libcurl that was included with the OS, which makes online login fail in Black Ops 3 due to improper usage of the cURL library that's technically "undefined behaviour". This is fixed here by removing one of the HTTP headers the game manually sets and letting cURL do its thing.
Version numbers are spoofed when signing in to match the Windows version's to enable matchmaking between the two, along with using updated scripts and assets from the Windows version.