Mapping with Control Points: Difference between revisions

From Red Faction Wiki
(Created page with "{{RF1Tutorial|Goober}} {{Under construction}} '''Control Points''' are used as objectives in the '''King of the Hill''', '''Damage Control''', and '''Revolt''' game types added in [https://alpinefaction.com Alpine Faction] The process to create these is very straightforward. ==Tutorial Steps== * Create a Trigger * Create a Capture_Point_Handler event, link the event to the trigger Category: Red Faction Category: RF1 Editing Category: Tutorials Category...")
 
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RF1Tutorial|Goober}}
{{RF1Tutorial|Goober}}
{{Under construction}}
'''Control Points''' are used as objectives in the '''[[King of the Hill]]''', '''[[Damage Control]]''', and '''[[Revolt]]''' game types added in [[Alpine Faction|Alpine Faction]] v1.2.


'''Control Points''' are used as objectives in the '''King of the Hill''', '''Damage Control''', and '''Revolt''' game types added in [https://alpinefaction.com Alpine Faction]
The process to create these is very straightforward.
 
== Basic Setup ==
# Create a [[RED Objects#Triggers|trigger]]. This can be a box or a sphere. The only properties of the trigger that matter for control points are the dimensions and the shape.
# Create a [[RED Event List#Capture_Point_Handler|Capture_Point_Handler]] event (under the '''AF_Gameplay''' category).
# Link the Capture_Point_Handler event to the trigger.
 
That's the minimum you need to do to make a control point.
 
If you want a cylindrical control point, tick the ''Cylindrical Trigger'' checkbox in the properties for the Capture_Point_Handler. 
* If the trigger is a sphere, the cylinder will have the same radius as the sphere. 
* If the trigger is a box, the cylinder will have the same diameter as the longest edge of the box.
 
== Label/Progress Sprite ==
The location of the Capture_Point_Handler event is the location of the progress/label sprite for the control point.
 
It’s best to position the Capture_Point_Handler:
* Directly above the center of the trigger
* At a height that is unlikely to result in the sprite blocking important sightlines for combat


The process to create these is very straightforward.
== Event Properties ==
{{Infobox RF1Event
|eventname      = Capture_Point_Handler
|category      = AF_Gameplay
|description    = Controls the behaviour of a multiplayer control point (capture zone) for [[King of the Hill]], [[Damage Control]], and [[Revolt]]. Uses a linked [[RED Objects#Triggers|trigger]] to define the capture area and manages capture progress, ownership, and HUD display.
|params        = * '''Name:''' (str1) Display name for the control point.
* '''Outline offset:''' (float1) Vertical offset for the circular outline drawn on the ground around the capture area. Useful for keeping the outline visible above uneven terrain.
* '''Cap rate multiplier:''' (float2) Multiplier applied to the base capture rate. '''0.0''' = no multiplier (same as '''1.0'''). Higher values capture faster; values between '''0.0''' and '''1.0''' capture slower.
* '''Stage:''' Specify stage for this point. Only used in [[Revolt]].
* '''Cylindrical Trigger:''' If true, treat the linked trigger as a vertical cylinder instead of using its raw shape. For sphere triggers, the cylinder radius matches the sphere radius. For box triggers, the cylinder diameter uses the longest edge of the box.
}}
<div style="clear: both"></div>
== Advanced Mechanics ==
=== Linking to Respawn Points ===
Link the Capture_Point_Handler to [[RED_Objects#Multiplayer_Respawn_Point|respawn points]] to let Alpine Faction automatically manage spawn activation and team assignment depending on the gametype.
 
==== Behaviour per Gametype ====
* '''King of the Hill''' & '''Damage Control''': Linked respawn points are synced to the owner of the control point. Only that team will be able to spawn at those respawn points. Use of this in KOTH is generally not needed/recommended
* '''Revolt''': Linked respawn points are enabled when their control point’s stage is active, and disabled when the game moves to the next stage. The teams assigned to each respawn point never changes, so you should set the red/blue checkboxes on each respawn point to match the intended defending/attacking team for that stage.
* '''Escalation''': Linked respawn points are enabled when their control point is the current defense hill for that team. The teams assigned to each respawn point never changes, so you should set the red/blue checkboxes on each respawn point to match the intended defending/attacking team for that stage. For example, in a 5-point Escalation map, if red controls their own base, their own forward point, and the center point, while blue only controls their own forward point and their own base, only blue spawn points associated with the blue forward point will be enabled, because that's the point blue is defending; while only red spawn points associated with the center point will be enabled, because that's the point red is defending. The only exception to this rule is when the map first starts and the center point is neutral - in that case, both team's spawns associated with the center point will be enabled until the center point is captured by a team.
 
Additionally, the [[RED Event List#Respawn_Point_State|Respawn_Point_State]] and [[RED Event List#Modify_Respawn_Point|Modify_Respawn_Point]] events can be used to manually adjust the behaviour of respawn points in all gametypes.
 
=== Control Point Events ===
{{Infobox RF1Event
|eventname      = When_Captured
|category      = AF_Catalysts
|description    = Fires a message to all linked triggers, movers, and events whenever a linked control point is captured by either team.
}}


==Tutorial Steps==
{{Infobox RF1Event
* Create a Trigger
|eventname      = Set_Capture_Point_Owner
* Create a Capture_Point_Handler event, link the event to the trigger
|category      = AF_General
|description    = Forces linked control points to a specific ownership state. Must be run on the server, ignored when run on a client.
|on            = Set all linked control points to the specified owner.
|params        = * '''Owner:''' (int1) Desired owner.
}}


{{Infobox RF1Event
|eventname      = Owner_Gate
|category      = AF_Flow
|description    = Tests whether a specific control point has a specified owner.
|params        = * '''Handler UID:''' (int1) UID of the Capture_Point_Handler to test.
* '''Required owner:''' (int2) Owner to check.
}}


[[Category: Red Faction]]
[[Category: Red Faction]]

Latest revision as of 11:34, 19 December 2025

Control Points are used as objectives in the King of the Hill, Damage Control, and Revolt game types added in Alpine Faction v1.2.

The process to create these is very straightforward.

Basic Setup

  1. Create a trigger. This can be a box or a sphere. The only properties of the trigger that matter for control points are the dimensions and the shape.
  2. Create a Capture_Point_Handler event (under the AF_Gameplay category).
  3. Link the Capture_Point_Handler event to the trigger.

That's the minimum you need to do to make a control point.

If you want a cylindrical control point, tick the Cylindrical Trigger checkbox in the properties for the Capture_Point_Handler.

  • If the trigger is a sphere, the cylinder will have the same radius as the sphere.
  • If the trigger is a box, the cylinder will have the same diameter as the longest edge of the box.

Label/Progress Sprite

The location of the Capture_Point_Handler event is the location of the progress/label sprite for the control point.

It’s best to position the Capture_Point_Handler:

  • Directly above the center of the trigger
  • At a height that is unlikely to result in the sprite blocking important sightlines for combat

Event Properties

Icon Event E.png

Capture_Point_Handler

Controls the behaviour of a multiplayer control point (capture zone) for King of the Hill, Damage Control, and Revolt. Uses a linked trigger to define the capture area and manages capture progress, ownership, and HUD display.
On Response
None
Off Response
None
Parameters
  • Name: (str1) Display name for the control point.
  • Outline offset: (float1) Vertical offset for the circular outline drawn on the ground around the capture area. Useful for keeping the outline visible above uneven terrain.
  • Cap rate multiplier: (float2) Multiplier applied to the base capture rate. 0.0 = no multiplier (same as 1.0). Higher values capture faster; values between 0.0 and 1.0 capture slower.
  • Stage: Specify stage for this point. Only used in Revolt.
  • Cylindrical Trigger: If true, treat the linked trigger as a vertical cylinder instead of using its raw shape. For sphere triggers, the cylinder radius matches the sphere radius. For box triggers, the cylinder diameter uses the longest edge of the box.

Advanced Mechanics

Linking to Respawn Points

Link the Capture_Point_Handler to respawn points to let Alpine Faction automatically manage spawn activation and team assignment depending on the gametype.

Behaviour per Gametype

  • King of the Hill & Damage Control: Linked respawn points are synced to the owner of the control point. Only that team will be able to spawn at those respawn points. Use of this in KOTH is generally not needed/recommended
  • Revolt: Linked respawn points are enabled when their control point’s stage is active, and disabled when the game moves to the next stage. The teams assigned to each respawn point never changes, so you should set the red/blue checkboxes on each respawn point to match the intended defending/attacking team for that stage.
  • Escalation: Linked respawn points are enabled when their control point is the current defense hill for that team. The teams assigned to each respawn point never changes, so you should set the red/blue checkboxes on each respawn point to match the intended defending/attacking team for that stage. For example, in a 5-point Escalation map, if red controls their own base, their own forward point, and the center point, while blue only controls their own forward point and their own base, only blue spawn points associated with the blue forward point will be enabled, because that's the point blue is defending; while only red spawn points associated with the center point will be enabled, because that's the point red is defending. The only exception to this rule is when the map first starts and the center point is neutral - in that case, both team's spawns associated with the center point will be enabled until the center point is captured by a team.

Additionally, the Respawn_Point_State and Modify_Respawn_Point events can be used to manually adjust the behaviour of respawn points in all gametypes.

Control Point Events

Icon Event E.png

When_Captured

Fires a message to all linked triggers, movers, and events whenever a linked control point is captured by either team.
On Response
None
Off Response
None
Parameters
No additional parameters.
Icon Event E.png

Set_Capture_Point_Owner

Forces linked control points to a specific ownership state. Must be run on the server, ignored when run on a client.
On Response
Set all linked control points to the specified owner.
Off Response
None
Parameters
  • Owner: (int1) Desired owner.
Icon Event E.png

Owner_Gate

Tests whether a specific control point has a specified owner.
On Response
None
Off Response
None
Parameters
  • Handler UID: (int1) UID of the Capture_Point_Handler to test.
  • Required owner: (int2) Owner to check.