Perfect Dark Source: Weapon Sets
Perfect Dark Source introduces weapon sets, also known as weapon profiles, item sets, etc. With these, the weapons that spawn on a map can vary to the admin's tastes.
For Server Admins
Adding or modifying weapon sets can be accomplished by using console commands to test in-game then loading notepad and editing the weapon set definitions.
Editing weaponsets.txt
This file is required by the mod, it resides at the root level, next to GameInfo.txt.
The file consists of a key named WeaponSets that contains a list of WeaponSet keys. Each weaponset has a Name and Slots keys. Name contains the name of the weaponset, this name will be used ingame. Slots contains a numbered list of weapons/items. The list doesn't have to be ordered neither does it have to be complete, a list may contain slots 1 through 5 except number 3. The list of item names to place on each slot definition is [here].
"WeaponSets"
{
"WeaponSet"
{
"Name" "Standard"
"Slots"
{
"1" "falcon2" // Weapon #1
"2" "ammo_heavy"
"3" "ammo_g_round"
"4" "rcp120"
"5" "ammo_medium"
"6" "ammo_medium"
"7" "superdragon"
"8" "ammo_heavy"
"9" "ammo_g_round"
...
"16" "grenade"
"17" "ammo_grenade"
"18" "ammo_grenade"
}
}
"WeaponSet"
{
"Name" "Random"
"Slots"
{
"1" "<random>"
}
}
"WeaponSet"
{
"Name" "Unarmed"
"Slots"
{
"1" "<none>"
}
}
}
The file is loaded with the mod. The first loaded uses the first weapon set on the list. The current set may be modified by using a console command.
The number of slots on a weapon set equals the maximum slot number contained by it, for example, a weapon set with only slot 1 and 12 defined has twelve slots not two, slots 2 to 11 contain the item <none>.
When a map requires the content of a slot number greater than the number of slots on a weapon set the value will wrap and start counting again. On the previous example when asked for slot 13 the game will get to slot number 12, rollback, and start counting again, it will use the contents of slot 1. Slot 24 would use the contents of slot 12, slot 21 the contents of slot 9 (<none>) and so on.
The standard number of slots to define on a weapon set is only 1 slot to make all weapons of the same type, 18 for a regular weapon set, or a multiple of 18 (36, 54, etc). The reason is so the weapon set works on any map.
Item Names
Names on bold are usable on the current release.
<allweaps-old> <allweaps-new> <random> <none> ar34 callisto cmp150 knife crossbow cyclone dartgun devastator dragon dy357 dy357lx falcon2 falcon2-sil falcon2-sco farsight grenade k7avenger laptopgun laser magsec4 mauler mineremote minetimed mineproxy nbomb phoenix rcp120 reaper rpg shotgun slayer sniper superdragon unarmed ammo_standard ammo_medium ammo_heavy ammo_maian ammo_skedar ammo_g_round ammo_rpg ammo_sk_rpg ammo_knives ammo_dart ammo_bolt ammo_shell ammo_magnum ammo_sniper ammo_grenade ammo_nbomb ammo_minetimed ammo_mineremote ammo_mineproxy shield
Names on bold are usable on the current release.
For Level Designers
To add a weapon spawn compatible with weapon sets the entity item_weaponset has to be placed on the map. Among the many options it includes, the spawning weapon has to be set as "Use Weapon Set" and the weapon set slot to any number. Numbers 1 through 18 under this template are recommended:
Slot 1: Strong Weapon Slot 2: Strong Weapon's Ammo 1 Slot 3: Strong Weapon's Ammo 2 Slot 4: Medium Weapon Slot 5: Medium Weapon's Ammo 1 Slot 6: Medium Weapon's Ammo 2 Slot 7: Weak Weapon Slot 8: Weak Weapon's Ammo 1 Slot 9: Weak Weapon's Ammo 2 (and repeat)
Greater numbers than 18 should be used for the slots when the map requires more than 18 weapon spawns, always keeping in mind the sets of 9 shown above. It is not a requirement that each item_weaponset entity has a different slot number for the mod to run correctly.