Custom Mutations Tutorial

Hello everyone. In this tutorial I’ll teach you how to create your own custom Mutations.

If you have any questions just ask, I'll be glad to assist you.

Now lets get started!

Getting Started

• Step 1: Download this ZIP folder containing the templates you'll need in order to create your very own Mutations.[www.dropbox.com]
  
  
• Step 2: Extract the Mutations folder to your desktop from within the Example Mutations ZIP file.
  
  
• Step 3: Open the Mutations folder and you'll see two folders, "modes" and "scripts" and one file, "addoninfo.txt". The modes folder contains the mode data for your Mutations, while the scripts folder will contain scripts to tweak settings for your Mutations that can't be done in the mode files. The addoninfo.txt file is used to set a name for your mod, enter the author name and add a description for your mod.
  
  
• Step 4: Now open the modes folder and you'll see two files, "testmutation1.txt" and "testmutation2.txt". These are here as examples, so you can easily use them as a template.
  
  Note: Each file can hold data for one mode only. Don't try to add multiple modes in the same file.
  
  
• Step 5: Open testmutation1.txt. You'll see the modename is declared above the brackets. It has the same name as the text file.
  
  Note: I would recommend changing the name of the file and the modename within the file to something different when you're ready to release your Mutation. The text file and modename can differ, but I recommend keeping them the exact same to prevent any issues.
  
  
• Step 6: Go back to the main directory of your Mutations folder, and open the scripts folder. You'll see another folder called "vscripts". This is where your VScripts would be placed to change additional settings in your Mutations. They're written in the Squirrel Scripting Language.
  
  Note: If you're unfamiliar with Squirrel, I recommend reading about it here.[www.squirrel-lang.org]
  
  
• Step 7: Open the vscripts folder and you'll see two files, "testmutation1.nut" and "testmutation2.nut". Notice how the name of the nut file and modename are exactly the same? This is important to keep them the exact same, otherwise your VScript wont be read when the Mutation starts.
  
  
• Step 8: Download decompiled vscripts here[www.dropbox.com]. They’re there for reference, do not place them in your vscripts folder.
  
  
• Step 9: You can use a decompiled nut file. Copy/paste a nut file and place it in your vscripts folder. Now rename it to say, “testmutation1” (or whatever name your mode is). Now go inside the nut file and add the commands you want, or remove the commands you don‘t.
  
  Note: Make sure you keep the command, “ActiveChallenge = 1”, in the nuts.
  
  
• Step 10: Go here for a list of Cvars to be used in the mode files.
  Go here for a list of VScript commands for the nut files.
  Also go here for information regarding the Extended Mutation System (EMS).
  
  Note: Not all Cvars will work. You'll have to test them.
  
  
• Step 11: When you're done, or you want to test your Mutation. Download the Authoring Tools from Steam -> Libraries -> Tools -> Left 4 Dead 2 Authoring Tools. Then navigate to the bin folder and use the VPK creator. C:\Program Files (x86)\Steam\steamapps\common\left 4 dead 2\bin. Move the Mutations folder into the VPK program, and it'll create the VPK. Then place it in your addons folder and play your Mutation.

Here's a list of weapon commands for VScripts, to be used for the nut files.

        "weapon_pistol",

	"weapon_pistol_magnum",

	"weapon_smg",

	"weapon_smg_silenced",

	"weapon_pumpshotgun",

	"weapon_shotgun_chrome",

	"weapon_hunting_rifle",

	"weapon_sniper_military",

	"weapon_rifle",

	"weapon_rifle_desert",

	"weapon_rifle_ak47",

	"weapon_autoshotgun",

	"weapon_shotgun_spas",


	"weapon_first_aid_kit",

	"weapon_defibrillator",

	"weapon_pain_pills",

	"weapon_adrenaline",

	"weapon_molotov",

	"weapon_pipe_bomb",

	"weapon_vomitjar",

	"weapon_gascan",

	"weapon_propanetank",

	"weapon_oxygentank",


	"weapon_melee",

	"weapon_chainsaw",

	"weapon_grenade_launcher",

	"weapon_rifle_m60",


	"weapon_gnome",

	"weapon_cola_bottles",

	"weapon_fireworkcrate",


	"weapon_upgradepack_incendiary",

	"weapon_upgradepack_explosive",

	"weapon_ammo_pack",


	"weapon_smg_mp5",

	"weapon_rifle_sg552",

	"weapon_sniper_awp",

	"weapon_sniper_scout",

	"weapon_knife",


	"ammo",

	"upgrade_item", //Laser Sights can only be removed

Here's a list of melee commands for VScripts, to be used for the nut files.

Note: The only melee weapon that will appear in all maps is the baseball_bat. The rest will only appear if the mission file for the Campaign allows them to spawn.

        "fireaxe",

	"frying_pan",

	"machete",

	"crowbar",

	"cricket_bat",

	"tonfa",

	"katana",

	"electric_guitar",

	"knife",

	"golfclub",

	"baseball_bat",

Now good luck making your Mutations!

Testing Your Mutation

After you've created the .VPK file and placed it in your addons folder, launch L4D2. Once at the main-menu, open the developer console and type the following, "map mapname testmutation1". This will launch your Mutation, if it works correctly you should see the loading text say "Label" instead of "Joining a Campaign game." If you do not see the "Label" text, then there's either an error somewhere, or there's another mod that's conflicting with the mode file.

You'll also find your Mutation available in Mutation -> Change Mutation. All you need to do is create a lobby and host a Local Server to play it.

[half life scientist]

Hey, I want to make a Mutation about the original L4D1 Special Infected, and I wanted to make the Boomers do damage when they vomit/explode on you. Not an instakill but like 10 damage, since I'm planning on making so that there's no hordes, only SI. I know there's an "IT" command or something like that which makes the game know you're vomited, but I'm really not sure how to do it. Any ideas?

[toyota_driver_99]

Hello! My plan is to create melee weapons only mutation. In this mutation all SMGs, shotguns, assault rifles and sniper rifles are removed. There are just pistols, desert eagle, melee weapons, chainsaws, vomitjars, pipebombs, molotovs, first aid kits, defibrillators, adrenaline shots and pain pills. How I can create this mutation?

[Vernous]

How do i repeat lets say 4 smokers every 1 min?

[Jugger]

How can i replace all medkits(even the ones in the safe rooms) with pills and remove defibrilators and laser sights? It's for a Versus mutation

[Rayman1103]

@Reaverer - No worries, happy to help! I don't mind if you want to use some of my stuff as templates for your own.

[Reaverer]

Also, thanks for supporting this after all these years :) .

[Reaverer]

Thanks @Rayman1103! That did indeed fix the issue. Hey, by any chance are your mods open source? There are so many that would make for great starting points.

[Rayman1103]

@Reaverer - You'll want to place your own vpks in the addons folder, not the workshop sub-folder. That could be why it's deleting the file, since there's no subscribed Workshop item that uses it.

[Reaverer]

I've made a mutations.vpk simply by running vpk.exe on the Mutations folder straight from "Example Mutations.zip", no modifications. I copy over the .vpk file to my ...\left4dead2\addons\workshop directory. When I start the game, my vpk file gets deleted and the mutation is nowhere to be found. The console has a line saying "Deleting file addons\workshop\mutations.vpk". Nothing else in the log seems relevant. Any ideas what I'm doing wrong?

[CokedBadger]

The link isn't working, it SHOWS the tab is Dropbox, but it's just white, I tried refreshing but that didn't do it

Maybe try some other upload method, like a Google Drive or Github