Black Ops 2 Server (Plutonium)
Managed from: GamePanel. 25 answers, updated 10 November 2026.
Essentials 6
You need a Plutonium key to start
The server runs on Plutonium and needs a free server key, created on the Plutonium website with your account. Without it, it won't start.
Log in on platform.plutonium.pw, the server keys section, and create a key.
GamePanelServer Options: paste it into
SERVER_KEY.Restart. Never share this key.
How do I connect to the server?
Launch Black Ops 2 from the Plutonium launcher, in the same mode as the server, then open the console and type connect IP:port. The server also shows up in Plutonium's server list, under its name.
Plutonium launcher: BO2 Multiplayer or BO2 Zombies, depending on
GAME_MODE.In game, press
²(or~), then typeconnect IP:portwith the address from the service page.Password-protected server: first type
password yourpassword, thenconnect IP:port.
Does the server need to be in English or French?
Neither: each player sees the game in the language of their own install. Only the text you write yourself shows as typed, like the server name or messages from your scripts.
GamePanelServer Options: change the name in
ZM_SERVER_NAME(orMP_SERVER_NAME), in any language you like.Restart to apply it.
Do I need to update the server?
No. On every start, the server checks for and installs the latest Plutonium version. The game files themselves never need updating.
When Plutonium releases an update, restart the server from the GamePanel.
On startup, the console shows
[Plutonium] Verification des mises a jour...(checking for updates): that's this step.
Are old logs and demos deleted?
Yes. On every startup, the server deletes the old multiplayer console logs (console_mp.log.1, .2…) and demos older than 7 days. The current log is never touched.
To keep a demo, download it through the File Manager (
Plutonium/storage/t6/demosfolder) before the next start.To change the duration, set
PURGE_DAYSin Server Options (in days, 7 by default).Server ordered before 2 October 2026: open a ticket to get this.
Backups, subdomain, SFTP and ports
These topics are common to every game: see the GamePanel fiche. For SFTP, follow the step-by-step FileZilla guide.
Help centre home, GamePanel fiche (all games).
Guides 13
Multiplayer or Zombies: how do I choose the mode?
The server runs one or the other: GAME_MODE in Server Options picks Multiplayer or Zombies. Each mode has its own settings, prefixed MP_ for multiplayer and ZM_ for zombies.
Stop the server.
GamePanelServer Options: set
GAME_MODEto the mode you want.Set the name, max players and password for the same mode (for example
MP_SERVER_NAME,MP_MAX_CLIENTS,MP_SERVER_PASSWORD, or the same withZM_).Players: 18 max in Multiplayer, 8 in Zombies. Plutonium recommends staying at 4 in Zombies to avoid game-breaking bugs.
Start it.
How do I choose the maps in the rotation?
The rotation is set in Server Options, "[ZM] Map rotation" for Zombies ("[MP]" for Multiplayer). This setting takes priority over the dedicated_zm.cfg file: left empty, the file's rotation applies.
Stop the server.
GamePanelServer Options: in "[ZM] Map rotation" (
ZM_MAP_ROTATION), write each map's mode file then the map, one after the other, with no separator:exec zm_classic_transit.cfg map zm_transit exec zm_classic_prison.cfg map zm_prison.For Multiplayer, same idea with the game mode:
exec tdm.cfg map mp_raid exec dom.cfg map mp_slums.Start it. The next map loads at the end of each game, and the list starts over after the last one.
The mode files (zm_classic_transit.cfg, tdm.cfg…) are already in the game's main folder. A DLC map only loads if its files are on the server.
What are the technical names of the Zombies maps?
In the rotation, each map is written as its mode file then its technical name. Only TranZit comes with the server; the other maps are DLC and are added from your own game.
TranZit:
exec zm_classic_transit.cfg map zm_transit.Survival, on
zm_transit:zm_standard_transit.cfg(Bus Depot),zm_standard_town.cfg(Town),zm_standard_farm.cfg(Farm). For Grief:zm_grief_transit.cfg,zm_grief_town.cfg,zm_grief_farm.cfg.Nuketown Zombies:
exec zm_standard_nuked.cfg map zm_nuked.Die Rise:
exec zm_classic_rooftop.cfg map zm_highrise.Mob of the Dead:
exec zm_classic_prison.cfg map zm_prison(Grief:zm_grief_cellblock.cfg).Buried:
exec zm_classic_processing.cfg map zm_buried(Grief:zm_grief_street.cfg).Origins:
exec zm_classic_tomb.cfg map zm_tomb.
What are the technical names of the Multiplayer maps?
The 15 original maps come with the server, Nuketown 2025 included. In the rotation, a mode file (tdm.cfg, dom.cfg…) applies to every map after it, until the next mode.
Included maps: Aftermath
mp_la, Cargomp_dockside, Carriermp_carrier, Dronemp_drone, Expressmp_express, Hijackedmp_hijacked, Meltdownmp_meltdown, Overflowmp_overflow, Plazamp_nightclub, Raidmp_raid, Slumsmp_slums, Standoffmp_village, Turbinemp_turbine, Yemenmp_socotra, Nuketown 2025mp_nuketown_2020.DLC maps, to add from your game: Downhill
mp_downhill, Grindmp_skate, Hydromp_hydro, Miragemp_mirage, Encoremp_concert, Magmamp_magma, Studiomp_studio, Vertigomp_vertigo, Covemp_castaway, Detourmp_bridge, Rushmp_paintball, Uplinkmp_uplink, Digmp_dig, Frostmp_frostbite, Podmp_pod, Takeoffmp_takeoff.Modes:
tdm.cfg(Team Deathmatch),dm.cfg(Free-for-All),dom.cfg(Domination),sd.cfg(Search and Destroy),koth.cfg(Hardpoint),conf.cfg(Kill Confirmed),ctf.cfg(Capture the Flag). The others are in themainfolder.Example:
exec tdm.cfg map mp_raid map mp_slums exec dom.cfg map mp_express.
How do I add the DLC maps (Mob of the Dead, Origins…)?
The server comes with the base game maps: TranZit for Zombies, the 15 original maps for Multiplayer. DLC maps are copied from your own game, and only the .ff files matter.
On your PC, in Steam: right-click Call of Duty: Black Ops II, Manage, Browse local files, then open the
zone/allfolder.Zombies: take every
.fffile withzmin its name (just over 500 MB) and you'll have all the maps at once.Multiplayer: take the
.fffiles named after the map's technical name (for examplemp_skatefor Grind), plus thedlc…_load_mp.fffiles.Upload them over SFTP, in binary mode, to
Server/Zombie/zone/all(orServer/Multiplayer/zone/all): see the FileZilla guide.Wait for the upload to finish before starting, and check that each file has the same size as on your PC.
Add the maps to the rotation: see How do I choose the maps in the rotation.
.ipak files, sound and video aren't used by the server: no need to upload them.
How do I add bots, mods or a map rotation?
Everything goes through Server Options: the map rotation, the mod to load and extra parameters (for bots, for instance). Mod files are uploaded through the File Manager.
Mod: upload its folder to
Plutonium/storage/t6/mods/, then entermods/mod_nameinMP_MOD(orZM_MOD).Rotation: see How do I choose the maps in the rotation.
Bots and advanced options:
MP_ADDITIONAL_PARAMS, following the documentation of the bot mod you're using.GSC scripts: see How do I add GSC scripts.
If players need to download the mod or map when joining: see Enabling FastDL below.
How do I add GSC scripts?
Put your .gsc files in Plutonium/storage/t6/scripts, in the zm subfolder for Zombies or mp for Multiplayer. Placed directly in scripts, they apply to both modes.
GamePanelFiles: in
Plutonium/storage/t6, create thescriptsfolder, thenzm(ormp), if they don't exist.Upload your script there.
Restart. After that, a new game is enough to reload an edited script.
If the server stops or keeps reloading the map: see The server crashes after adding a script.
Scripts placed in Plutonium/storage/t6/raw/scripts, as some guides suggest, are loaded too.
How do I enable FastDL so players download your mods?
FastDL is a small built-in file server: players missing your mod or custom map download it automatically when joining. It needs its own port, separate from the game port and the IW4MAdmin one.
Client areaMy Servicesyour serverServer IPServer ports: click Request a port to get an extra port.
GamePanelServer Options: put this new port in
FASTDL_PORT(never theIW4M_PORTone), then setFASTDL_ENABLEDto1.File Manager: copy the files to serve into the
FASTDLfolder, with the same structure as on the server:FASTDL/mods/mod_name/(.ffand.iwdfiles) andFASTDL/usermaps/map_name/.Restart. The server tells players the download address itself.
To check: open
http://IP:portwith theFASTDL_PORTport, the folder listing should show up.
How do I use RCON?
RCON lets you send commands to the server from the game console. It needs a password, set in Server Options.
GamePanelServer Options: set a password in
ZM_RCON_PASSWORD(orMP_RCON_PASSWORD), then restart. Left empty, RCON is off; if IW4MAdmin is enabled, a password is then created in theiw4m/.rconfile.In game, open the console (
~key) and typercon login yourpassword.Every command then starts with
rcon: for examplercon status(connected players) orrcon map_rotate(next map).With IW4MAdmin, chat commands are often simpler: see What commands can I use in game.
IW4MAdmin: what is it and how do I enable it?
IW4MAdmin is the administration tool for Plutonium servers: kicks, bans, warnings, admin ranks, player stats and a server website. It's included for free and disabled by default.
GamePanelServer Options: set
IW4M_ENABLEDto1.Check that
IW4M_PORThas a port number. It's filled in by the GamePanel, you don't need to change it.Restart. The console shows
[IW4MAdmin] started, website on port ….If
MP_RCON_PASSWORD(orZM_RCON_PASSWORD) is empty, an RCON password is created for you. If you set one: 8 to 64 characters, letters, numbers,_,.or-.
How do I access the IW4MAdmin website and become owner?
The website opens at the server's address, on the IW4M_PORT port. To administer it, claim ownership in game with !owner, then get a login code with !rt.
Open
http://IP:portin a browser, with the server's IP and theIW4M_PORTport.Join your server in game and type
!ownerin chat. The first player to do it becomes owner: do this before opening the server to the public.Type
!rtin chat: the reply gives your Client ID and a login code valid for two minutes.On the website, click the key (Login) in the left menu, then enter your Client ID and the code as the password.
To skip
!rtnext time, set a permanent password: type!sp yourpasswordin the website's Console.To name other admins:
!sl player Moderator(orAdministrator,SeniorAdmin).
What commands can I use in game?
Commands are typed in chat and start with !. Each one needs a minimum rank. !h shows the ones you're allowed to use.
All players:
!rep player reason(report),!who(your info),!stats,!nm(see the next map).Trusted:
!w player reason(warn),!wc player(clear warnings).Moderator:
!k player reason(kick),!s message(announce),!fr(restart the map),!reps(view reports).Administrator:
!tb player 3d reason(temp ban:m,h,d,w),!m map(change map),!mr(skip to the next map).SeniorAdmin:
!b player reason(permanent ban),!ub @ID reason(unban with the Client ID).Full list: https://github.com/RaidMax/IW4M-Admin/wiki/Commands
How do I schedule automatic restarts on my Black Ops II server?
A GamePanel schedule restarts the server at a fixed time, with a single action: Restart the server. How schedules work is explained in Schedule automatic restarts.
GamePanelSystemSchedulesCreate, pick Blank Schedule, Continue, then the name, frequency and time, and Create Schedule.
On the schedule page, Create Task: Send power action, Restart the server, offset 0.
Trigger runs it right away to try it, restart included.
Common errors
- Pick a time when nobody plays: connected players are disconnected.
Troubleshooting 6
The console shows "ipak file not found" or "bad cseg_size": is that a problem?
No. These lines, like "Could not load scriptparsetree", show up on every start and don't block anything. The .ipak files reported missing aren't used by a server: don't add anything.
The server is ready when the console shows
Heartbeat successful: you can connect.A line saying
is not a valid value for dvarflags an out-of-range setting (for exampleai_corpseCountat 16 when the maximum is 8): the value is refused and the server starts anyway.A real problem looks different: the server stops on an error message, or the map keeps reloading. See The server stops on startup and The server crashes after adding a script.
The server stops on startup: "ipak file does not contain a valid header"
An .ipak file in zone/all is incomplete or damaged, most often because the server started while it was still uploading. The server doesn't need it: remove it.
If an upload is in progress, wait for it to finish.
GamePanelFiles: rename the file named in the message by adding
.offat the end (for examplebase.ipak.off), or delete it.Start the server.
.ff files, on the other hand, are needed: upload them over SFTP in binary mode, and check that their size matches the one on your PC.
The server crashes after adding a script
The script calls a function that doesn't exist in Black Ops II, or contains an error: the server stops or keeps reloading the map. Disable it while you fix it.
GamePanel console: an
Unresolved externalline gives the function and the script at fault.GamePanelFiles: rename the script by adding
.offat the end (for examplemy_script.gsc.off), then restart. The server should start normally again.Fix the script, give it back its
.gscname and restart.After a crash, the service page shows "Diagnose my server": it reads the console and gives the cause when it recognizes it (for example the game crashing or a missing Plutonium key).
Players aren't downloading the mod (FastDL)
Almost always a misplaced file in FASTDL, or a FastDL port that's empty or shared with IW4MAdmin.
Check
FASTDL_ENABLEDis1andFASTDL_PORThas its own port, different fromIW4M_PORT.Open
http://IP:port(theFASTDL_PORTone): if nothing shows up, restart the server and try again.The path must match the server's:
mods/mod_name/...orusermaps/map_name/...insideFASTDL, with no extra folder.After adding any new file to the mod, copy it into
FASTDLtoo.
The IW4MAdmin website doesn't show up
Most often, IW4MAdmin isn't enabled, the port is empty, or the server hasn't finished starting. The GamePanel console shows the cause on the [IW4MAdmin] lines.
Check
IW4M_ENABLEDis1and the address:http://(nothttps), theIW4M_PORTport, not the game's.First launch: IW4MAdmin downloads itself, wait one to two minutes.
No
[IW4MAdmin]line, or "IW4M_PORT missing": your server was ordered before 2 October 2026. Open a ticket, we'll set it up.Console shows "RCON_PASSWORD": your RCON password doesn't match the required format (8 to 64 characters, letters, numbers,
_,.,-). Fix it or clear it, then restart.
I get kicked for using a VPN
IW4MAdmin is what kicks players who connect through a VPN. You turn this detection off in the GamePanel: the enabled setting in the ScriptPluginSettings.json file has no effect.
GamePanelServer Options: set "IW4MAdmin VPN detection" (
IW4M_VPN_DETECTION) to0.Restart the server. The console shows
[IW4MAdmin] detection VPN desactivee.
To kick players on a VPN again, set it back to 1 and restart.
No answer here. Try the help center home page or open a ticket.
Can't find it? Open a ticket from your client area. Terms and conditions: helloserv.fr/en/legal