Call of Duty Mapvotes

This project started in March 2020 as a personal challenge. At the time I had almost no experience with GSC modding on Black Ops II, yet I managed to build a working map voting system that lets players vote for the next map or gamemode before each match. I became only the second developer to deliver a functional version for the Plutonium client.

Over time, the same core idea was adapted to many other titles. Each version was written specifically for its client and game logic — there is no single universal script that works across all games. While the concept remains the same, every client requires its own implementation.

Important: The mapvote runs client-side and will not rotate the map by itself. It depends on the server having a working map rotation configured through dvars (such as sv_maprotation).

Each version of the mapvote was written specifically for its client. Even when two versions exist for what is technically the same game (such as the two active clients for Modern Warfare Remastered), the installation steps and folder structures can differ significantly between teams.

Do not assume you can copy files or scripts from one title to another without modification.

---

Black Ops II

Installation

Zombies (ZM)

1. Compile the script (not needed on Plutonium)
   Compile mapvote.gsc using a GSC compiler.

2. Place the compiled file
   Copy it to:
   %localappdata%\Plutonium\storage\t6\scripts\zm\

3. Server configuration
   Paste the content of mapvote.cfg into your server config (e.g. dedicated_zm.cfg).

4. Required Dvars

   set mv_maps "zm_tomb zm_buried zm_town zm_busdepot zm_farm zm_transit zm_prison zm_highrise zm_nuked"
   set mv_enable 1
   

5. Start the server.

Multiplayer (MP)

1. Compile the script (not needed on Plutonium)

2. Place the file in %localappdata%\Plutonium\storage\t6\scripts\mp\

3. Add the content of mapvote.cfg to your server config

4. Required Dvars

   set mv_maps "mp_studio mp_nuketown_2020 mp_carrier mp_drone mp_slums"
   set mv_enable 1
   set mv_gametypes "dm;freeforall.cfg war;mycustomtdm.cfg"
   

5. Plutonium only – LUI mod support

   • Place the T6Mapvote folder in %localappdata%\Plutonium\storage\t6\mods\
   • Set fs_game and mv_lui in your server config

---

Modern Warfare 3

Installation

This version requires compiling with zonetool (the tool is included in the repository).

1. Compile the mod using the provided zonetool (buildZone mod).
2. Copy the resulting mod.ff into your mods folder.
3. Create an .iwd containing the required images.
4. Add the content of mapvote.cfg to your server configuration.
5. Configure the required Dvars:

   set mv_maps "mp_favela mp_rust mp_terminal_cls mp_alpha mp_bootleg mp_bravo mp_carbon mp_dome mp_exchange mp_hardhat mp_interchange mp_lambeth mp_mogadishu mp_paris mp_plaza2 mp_radar mp_seatown mp_underground mp_village"
   set mv_enable 1
   set mv_gametypefiles "TDM_default@FFA_default@SD_default@GG_default"
   set mv_gametypenames "Team Deathmatch@Free for all@Search & Destroy@Gungame"
   

6. Place mapvote.gsc in the scripts folder.
7. Start the server.

Adding Custom Maps

• Create a preview material + .iwi
• Add the preview to the .iwd
• Update the getmapname function in mapvote.gsc
• Rebuild the mod with zonetool

---

Modern Warfare Remastered

There are two active clients for this game, maintained by different teams. While the game is the same, the clients have different folder structures and requirements.

H1 Mod

Installation (H1 Mod):

• Place the files in %localappdata%\h1-mod\scripts\
• Add the content of mapvote.cfg to your server config
• Configure mv_maps, mv_enable, and mv_gametypes
• Restart or reload the script

H2 Mod

Installation (H2 Mod):

• Place the files in <game>\userscripts\mp\
• Add the content of mapvote.cfg to your server config
• Configure the Dvars as above

---

Ghosts

Installation

1. Place the files in %localappdata%\xlabs\data\iw6\data\
2. Add the content of mapvote.cfg to your server config
3. Set the required Dvars (mv_maps, mv_enable, mv_gametypes)
4. Start the server

---

Black Ops

Installation

1. Compile the mod using the Black Ops mod tools
2. Place the mod.ff in %localappdata%\Plutonium\storage\t5\mods\YOURMODNAME
3. Add the content of mapvote.cfg to your server config
4. Configure Dvars (mv_maps, mv_enable, mv_gametypefiles, mv_gametypenames)
5. Place mapvote.gsc in the scripts folder
6. Start the server

Adding Custom Maps

• Create a preview material + .iwi
• Add it to the .iwd
• Update getmapname in mapvote.gsc
• Rebuild and deploy the mod

---

Advanced Warfare

This version is still experimental. More documentation will be added later.

---

Black Ops III

This version is still experimental. More documentation will be added later.

---