trigger_changelevel Last edited 6 months ago2024-04-28 12:22:52 UTC

trigger_changelevel - Brush Entity

Attributes

• Name (targetname) - Property used to identify entities.
• New map name (map) - The name of the new map to load.
• Landmark name (landmark) - The name of the info_landmark that defines the same point in space in both maps.
• Change Target (changetarget) - The entity name to be triggered in the next map.
• Delay before change target (changedelay) - Self-explanatory.

Flags

• No Intermission (1) - This flag appears to be unused and has no effect.
• USE Only (2) - Entity can only be triggered by another event.

Notes

• The game must be restarted completely if updates to the level change brushes are made. Not doing so causes incorrect and/or problematic transitions, even if all the change level brushes and entities are properly set up and configured.
• It's recommended to keep your map names short with no capital letters, spaces, or special characters. Instead of "Chapter 3 Level 5", try c3l5 or ch3_lvl5.
• It's recommended to follow the same naming conventions for landmarks - no capital letters or spaces / special characters.
• You must set up changelevels between two maps both ways viz. map1 ←→ map2, even if the player is meant to progress one way. Where players aren't meant to backtrack, place the "return" trigger as a small brush in an unreachable place, with USE Only (2) flag set. Not setting this up properly will crash the game.
• If a trigger_transition is set up with the same name as the info_landmark, the trigger_changelevel can be triggered by other entities. The player will change level only if they are inside the trigger_transition when the trigger_changelevel gets triggered. For example, an elevator door's "target on close" fires the elevator's changelevel, and the changelevel succeeds if the player is inside the elevator but fails if they're outside of it.
  • With the trigger_transition taking care of the affected area, the trigger_changelevel then needs to be placed in an unreachable area (preferably with USE Only (2) flag set) to avoid out-of-sequence activation. In our elevator example, we want the changelevel to occur after the elevator door has fully closed and not when the player touches a trigger_changelevel when the door could still be open.
• Change Target (changetarget) works similar to trigger_auto but differ in that trigger_auto fires once on map load, whereas the change target fires every time you load into a map from this map through this specific trigger_changelevel. This is useful when using the trigger_changelevel+info_landmark+trigger_transition triple setup to kickstart the corresponding sequence in the other map, for example a multi_manager that plays the elevator sequence and opens the door in an elevator level change.

Related pages

• info_landmark
• trigger_transition
• Tutorial: Changing Levels
• VERC: In Depth: Level Transitions