Rival Species Mapping Reference

Index

Required
Overview
Direct Confrontation
Capture the Artifact
Arena
Area Control
Desrtuction
Additional  Goodies
Entity Index
In Depth Entity Information
Class Name Lookup

Required

In order to create a map for RS you will need to configure your map editor to use the RS mapping entities.  The FGD file for configuring the Valve Hammer editor can be downloaded here.  If you wish to map for RS using another editor you will have to convert the FGD into whatever format your editor requires yourself.

Overview

When players connect to a RS server or the round ends players are spawned as a spectator at an info_player_team_st entity .  HL multiplayer can handle up to 32 players at once, so you'll need a lot of these.  Spectators are invisible and intangible, so they won't distract players in-game.

For each team you want in your map you must include a mission_modifier entity.  As well as telling RS what teams are available it also holds all the setting specific to that team, such as what class and weapons are available.

Each team has it's own spawn location enity anything from servo skulls to dreadnaughts can be spawned at  these locations, so give them room.  Here is a list of which entity to use for which team :

Black Templars info_player_team_bt
Ataloc Craftworld info_player_team_at
Iron Warriors info_player_team_iw
World Eaters info_player_team_we
Goff Orks info_player_team_gf

RS has several game modes, but relies on entities placed & configured by you, so they can be mixed and  matched.  In any game mode after 8 minutes victory points decide which team wins.  However you can trigger any ending you want with the rs_roundend entity.

Direct Confrontation (DC game mode)

Direct Confrontation map names start with rs_dc_ .  It's a basic team deathmatch mode, once you've done everything that's required in the section above this mode will work.

Capture the Artifact (CA game mode)

Capture the Artifact map names start with rs_ca_ .  This is a kind of capture the flag mode for RS.  In it's simplest form one team has to capture an item and the other team has to stop them.  It is a simple matter to make a map where both teams have to capture the same artifact or where each tem has to capture a different artifact.  The artifacts themselves are world artefact entities, you can configure which team is allowed to pick up each entity using it's properties.  Picked up artifacts are captured at world_capturelocation entities, you can use this to trigger a rs_roundend for a basic capture the flag round.

Arena (AR game mode)

Arena map names start with rs_ar_ . Arena maps are a bit of fun, offering everyone the chance to get up close and personal.  This mode is intended for hand to hand combat only.  Setting the "ArenaMode" proprty of mission_modifier to 1 will disable all ranged weapons.  Using the  weapon properties of the mission_modifer you can limit the weapons available to each class, so players have to get up close for a good look at the mod's great player models and to beat the living crap out of each other.

Area Control (AC game mode)

Area Control map names start with rs_ac_ . Area Control maps are based around a number of strategic locations marked by world_areacontrol entities.  As soon as a player touches the world_areacontrol's model (which you will have to specify) the model will change to indicate the team that now control's that location and victory points are awarded.  Controlling all the world_areacontrol locations wins the round.

Desrtuction (DE game mode)

Destruction map names start rs_de_ .  In this game mode the objective for one or both teams is to destroy a specific structure (such as a generator for example).  The target to be destroyed is usualy a func_breakable entity with lots of health, with it's "target on break" property specifying the winning team's rs_roundend entity.  This way destruction of the breakable awards the team victory.  In order to make the objective a little more difficult you might want to use a multi-source so that multiple objectives have to be destroyed, or you can put the objectve behind a locked door.

Additional Goodies

You can reward teams to achieving map specific objectives by triggering a rs_victorypoints entity.  All entities named "round_start" will be triggered at the start of each round, and all entities named "reset" will be triggered at the end of a round.

The following entities are reset automatically at the start of a round to the status the had when the map loaded :

world_artefact, func_button, func_door, func_breakable, laser_beam, func_wall_toggle, light, trigger_hurt, trigger_relay, trigger_once, func_wall, info_player_team_bt, info_player_team_iw,  info_player_team_at, info_player_team_we and  multisource

The following standard entities have all been modified so that they can be configured only to activate for members of a specific team using "triggerteamshrink" property :

func_button, func_rot_button, func_door, func_rot_door, func_plat, func_train, func_illusionary, func_mortar_field, func_momentary_door, func_momentary_button, trigger_changelevel, func_ladder, trigger_gravity, trigger_hurt, trigger_multiple, trigger_push, trigger_teleport and trigger_once

All Teams (Default) 0
Spectators 1
Black Templars 2
Iron Warriors

Alaitoc Craftworld 8
World Eaters 16 
Goff Orks 32

Entity Index

info_player_team_st 
info_player_team_bt 
info_player_team_at
info_player_team_iw
info_player_team_we
info_player_team_gf

mission_modifier
rs_roundend
world artefact
world_capturelocation
rs_victorypoints
world_areacontrol
rs_timer
rs_particle_emitter
rs_fog

In Depth Entity Information

info_player_team_st Spectator spawn location.  The only thing to configure with this is what "angle" the spectator will be facing when they spawn here.
info_player_team_bt

Black Templar's spawn location. Use the "angle" property to configure which way the marine is facing when they spawn.  Use the "class shrink" property to specify which classes can spawn here (use the class shrink calculator to work out the right number to enter). 

If you "Name" the spawn location you can turn it on or off by triggering it.  By setting "Inactive Start" to a non-zero value you can prevent players from spawning the at start of the round and use a trigger to activate the spawn location later.

info_player_team_at Alaitoc Craftworld spawn location .  Works the same way as the Black Templar's spawn location only for players on the Alaitoc team.
info_player_team_iw Iron Warriors spawn location.  Works the same way as the Black Templar's spawn location only for players on the Iron Warriors team.
info_player_team_we World Eaters spawn location .  Works the same way as the Black Templar's spawn location only for players on the World Eaters team.
info_player_team_gf Goff Orks spawn location .  Works the same way as the Black Templar's spawn location only for players on the Goff Orks team.
mission_modifier

Team specific setup is done here.  Most important is to specify the "team name" to let RS know that this team is available in this map.  You can modify the balance of the map by changing the ratio of points that each team gets to spend on respawns using the "Team Balance" property. 

To restrict the classes that are available to a specific team you have to turn off "SmartEdit" and add a property called "class" and set it's value to the name of the class (eg "iw_havoc_01"), refer to the Class Name Lookup for the specific names.  By adding multiple Class properties you can forbid multiple classes (don't wory about Hammer renaming them to "class#2" etc that has been taken into account).

Individual weapons can be forbidden by following a similar route.  By adding a property called "weapon"and specifiying the value as "weapon_weaponname", where weaponname is the name of the weapon's model (not including it's p_ or v_ prefix or it's .mdl extension).

Add together the values for whichever game modes your map supports and enter it in the "Game Mode" property.
Direct Confrontation (Default)  1
Area Control  2
Arena  4
Destroy

 8

Capture the Artifact  16  

rs_roundend Used to end the round before the 8 minute timeout.  Use the "Name" property so it can be activated by another entity.  Pick a reason for the round to end from the list in the "Reason" property.
world_artefact An artifact that can be captured. Pick the "Team Name" of the team that can collect it from the dropdown list.  Browse the "Model Path" for a model to represent the artifact.  Specify "Capture Points" to reward the team for picking up the artifact.
world_capturelocation Marks a location where an artifact can be captured. Pick the "Team Name" of the team that can capture items here from the dropdown list.  Browse the "Model Path" for a model to represent the location (not necessary if the location is distinct in the map).  Specify "Capture Points" to reward the team for capturing the artifact and bringing it here.
rs_victorypoints

Used to reward a team for achieving secondary objectives. Give it a "Name" so it can be triggered by another entity.  Pick the "Team Name" of the team that will receive the victory points. Finally specify the "Amount" of victory points to be given.

world_areacontrol

The model switches depending on which team is in control. If a team captures all the world_areacontrols in a map they win the round.

Area controls appear in the top right of the HUD, displaying their "Control Identifier" property and in the map as the model specifed by it's "Model Path" property.  When captured it's appearence will switch to the model indicating the capturing team.

The "* Target" properties are the target names of entities to be triggered when this area is capture by the relevent team.  For example when and black templar marine captures a location the entities named by "BT Target" will be triggered.  The "Control Target" is triggered every time the area is captured, but just before the team target is.

NOTE: The "Control Identifier" MUST be prefixed by a number ( 1-9 ), this indicates it's sequence in which area controls will be listed on the HUD.  An area 0 called "base" is automatically created.

rs_timer Only activates it's target entity if it is triggered at the start and end of the timespan.
rs_particle_emitter

Specifies the location, direction and style of a visual effect known as a "Particle System".  Particle systems are purely asthetic and have no effect on game play, but properly configured can greatly improve the appearence and atmosphere of a map.

A particle system appears as a cloud of additive rendermode sprites around the particle emitter, that generaly move toward the entity specified by emmiter's "Target" property.  The exact appearence of the system is specified by an INI file in the player's rspecies/particles/ folder.  The INI file used by an emitter is specified by it's "Particle"property.

Configuration of particle system INI files is explained by Appendix 1 thanks to Char0n.

An emitter will start to produce particles once it has been triggered using it's "Targetname", however you can have it start as soon as the map is loaded by setting it's "Start Active" spawn flag (on the flags page of the property editor).  If you want to be able to turn it off again you must use the "May Toggle" spawn flag.

NOTE : Each rs_particle_emitter must have a unique "ID" property or it will never generate particles.  We plan to do away with this in a later release, currently it is still required.

rs_fog

Creates the appearence of fog filling the map.  This can create a very atmospheric effect, but looks a bit odd in maps that are partialy indoors.

Players in the map can see clearly up to "Start distance" units from them, the fog then thickens until it reaches "End distance" beyond which it appears a solid color.  The colour of the fog is specified by the "Fog color (R G B)" property.

NOTE : This entity does not work on all machines.

 

Class Name Lookup

To ban a particular class from your map create a property of the team's mission_modifer called "class" with a value of the identifier for the banned class.


Alaitoc Eldar
at_spider_01
at_scorpion_01
at_hawk_01
at_guardian_01
at_driver_01
at_direavanger_01
at_darkreaper_01


Iron Warriors
 
iw_terminator_01
iw_raptor_01
iw_marine_01
iw_havoc_01
iw_eye_01
iw_driver_01


World Eaters
we_terminator_01
we_marine_01
we_driver_01
we_bloodletter_01
we_eye_01

Black Templars

bt_terminator_01
bt_observer_01
bt_marine_01
bt_driver_01
bt_devastator_01
bt_assault_01

Goff Orks 

gf_boy_01
gf_eavyboy_01
gf_leader_01
gf_squig_01
gf_stormboy_01