Mapping (configuration guide)
This section will go over all the settings you can use to configure how your map runs on a server.
You do not need any of this to create and play a map, but the configuration options provided can greatly help fine tune your map how you want it to be played.
Contents
Configuration files
The following files go in the maps folder along with your BSP to configure it. map-name must match your BSP map name to work. For example, if your map was volcano.bsp, your configuration file would be volcano.cfg in the same folder.
| File | Purpose |
|---|---|
| map-name.cfg | Contains the weapons and equipment you spawn with and physics settings. |
| map-name_motd.txt | Contains a message to show players when they join the map. Good place to put mission briefings or an objective list. |
| map-name_skl.cfg | Contains any modifications of the default skill configuration, found in skill.cfg. Simply copy things from the default skill configuration that you want to modify. |
| map-name_detail.txt | Contains any texture high-definition overlays. For more details on this, please see this article at TWHL. |
Weapons & equipment
In your map-name.cfg file, you can put these statements inside to provide various weapons, equipment, and ammo to be provided when players spawn.
It is important that each statement is used once and once only!
| Setting | Value | Description |
|---|---|---|
| Weapons | ||
| weapon_crowbar | No value for this | Provide a crowbar. |
| weapon_wrench | No value for this | Provide a pipe wrench. |
| weapon_grapple | No value for this | Provide a barnacle grapple. |
| weapon_glock | No value for this | Provide a 9mm pistol. |
| weapon_357 | No value for this | Provide a .357 magnum. |
| weapon_uzi | No value for this | Provide an uzi. DO NOT USE WITH WEAPON_UZIAKIMBO! Use one or the other. |
| weapon_uziakimbo | No value for this | Provide two uzis. DO NOT USE WITH WEAPON_UZI! Use one or the other. |
| weapon_eagle | No value for this | Provide a desert eagle. |
| weapon_shotgun | No value for this | Provide a SPAS-12 shotgun. |
| weapon_mp5 | No value for this | Provide an MP5a3 submachine gun. |
| weapon_m16 | No value for this | Provide an M16 assault rifle with M203 grenade launcher. |
| weapon_crossbow | No value for this | Provide a crossbow. |
| weapon_rpg | No value for this | Provide a rocket propelled grenade launcher. |
| weapon_gauss | No value for this | Provide a gauss gun. |
| weapon_egon | No value for this | Provide a gluon gun. |
| weapon_hornetgun | No value for this | Provide a hornet gun. |
| weapon_handgrenade | No value to provide 1, or specify the number of hand grenade packs to provide (value x5). | Provide 5 hand greandes. |
| weapon_satchel | No value to provide 1, or specify the number of satchel charges to provide. | Provide a satchel charge. |
| weapon_tripmine | No value to provide 1, or specify the number of tripmines to provide. | Provide a tripmine. |
| weapon_snark | No value to provide 1, or specify the number of snark nests to provide (value x5). | Provide 5 snarks (1 snark nest). |
| weapon_sniperrifle | No value for this | Provide a M40a1 sniper rifle. |
| weapon_saw | No value for this | Provide a M249 saw. |
| Equipment | ||
| nomedkit | No value for this | Do not provide a medkit. |
| nosuit | No value for this | Do not provide a hazard suit (will disable the entire HEV and flashlight), not recommended! |
| item_longjump | No value for this | Provide a long jump module. |
| starthealth | 1 to 100 | Amount of health to provide. |
| startarmor | 0 to 100 | Amount of HEV battery power (armour) to provide. |
| Ammo | ||
| ammo_9mm | Number of clips. | Provide 9mm ammo clips (17 rounds). Used by the 9mm pistol, uzis, and MP5. |
| ammo_357 | Number of clips. | Provide .357 ammo clips (6 rounds). Used by the .357 magnum and desert eagle. |
| ammo_buckshot | Number of boxes. | Provide shell boxes (12 rounds). Used by the shotgun. |
| ammo_556 | Number of clips. | Provide 5.56mm ammo clips (200 rounds). Used by the M16, SAW, and minigun. |
| ammo_ARgrenages | Number of assault rifle grenade packs. | Provide two assault rifle grenades. Used by the M16's M203 grenade launcher. |
| ammo_crossbow | Number of clips. | Provide bolt clips (5 bolts). Used by the crossbow. |
| ammo_gaussclip | Number of batteries. | Provide gauss/egon battery modules (20 units). Used by the guass gun and gluon gun. |
| ammo_rpgclip | Number of rocket packs. | Provide rocket packs (2 rockets). Used by the RPG. |
| ammo_762 | Number of clips. | Provide 7.62 ammo clips (5 rounds). Used by the sniper rifle. |
Variables
| Setting | Default value | Description |
|---|---|---|
| skill | 1 | The default skill level your map will use.
|
| sv_accelerate | 10 | The speed players accellerate while on ground. |
| sv_airaccelerate | 10 | The speed players accellerate while in the air, |
| sv_friction | 4 | The amount of friction created by the ground. |
| sv_gravity | 800 | The amount of gravity. |
| sv_maxspeed | 320 | The speed players can run on ground. Various triggers and effects (explosions etc) can allow players to move faster. |
| sv_wateraccelerate | 10 | The speed players accellerate while underwater. |
| sv_waterfriction | 1 | Whether friction also applies to water. |
| sv_zmax | 8192 | The maximum distance (units) rendered from players. 32768 is recommended for maps with very large areas. |
| mp_disablegaussjump | 0 | Disable vertical knock back caused by the gauss cannon's charge up shot. This can sometimes be used to exploit maps or get places players aren't meant to go. This is a direct rename of mp_allowgaussjump, which for some reason got inverted in Sven Co-op 3.0. |
| mp_falldamage | 1 | Use realistic fall damage. If disabled, when players get hurt from falling they will always lose 10 health. |
| mp_flashlight | 1 | Allow players to use their flashlight. |
| mp_footsteps | 1 | Players generate footstep sounds while moving. |
| mp_forcespawn | 0 | Force players to respawn after they die. Disabling this allows players to respawn when they are ready to. |
| mp_fraglimit | 0 | Map changes after someone obtains this many frags. Currently obsolete in Sven Co-op. |
| mp_telefrag | 1 | Players will kill someone if they are teleported inside them. Disabling this will result in players piling up inside each other unable to move. |
| mp_timelimit | 60 | Map changes after this amount of time (minutes) if the map hasn't been completed already. |
| mp_weaponstay | 1 | Weapons can be picked up multiple times, with the exception of miniguns. Disabling this will result in a couple of players taking all the weapons leaving others with nothing. |
| mp_banana | 1 | Allow players to throw banana bombs. |
| mp_disable_autoclimb | 0 | Deny players to use the auto-climb feature. |
| mp_disable_player_rappel | 0 | Deny players to use the Barnacle grapple on each other. |
| mp_dropweapons | 1 | Allow players to drop weapons. Miniguns can always be dropped. |
| mp_grapple_mode | 1 | Players are pulled to monsters bigger than headcrabs when grappled rather than the monster being pulled to a player. |
| mp_multiplespawn | 1 | Allow players to use more than 1 spawn point. Disabling this would be epic fail on your behalf. |
| mp_no_akimbo_uzis | 0 | Deny players to have akimbo uzis. This may help balance power on some maps or large player capacities. |
| mp_noblastgibs | 0 | Deny monsters to be gibbed (ripped apart) when killed with explosives. |
| mp_npckill | 2 | Set the behaviour of killing allied NPC's. This setting replaces the old killnpc command.
|
| mp_respawndelay | 6 | The time (seconds) a player must wait before respawning. This is 6 seconds by default to help encourage use of the new reviving feature. |
For security reasons map configurations can only use settings for altering physics and game play. For example, you can't modify the server or RCON password from your map config, but you can modify the gravity or maximum running speed.