Loner-StrikeReference

Reference

Spawning and transforms

Making props, creatures and effects, and moving, turning and attaching them.

Props, creatures, NPCs, interactables, components, weapons on the ground, effect entities, projectiles and trigger volumes all come from spawn nodes. They share one way of saying where a thing goes, which way it faces and how it moves. Learn it once and every spawn node works the same.

The spawn nodes

NodeMakes
Spawn PropA model. Its Collision: None (walk through), Box, players only, or Box, players and bullets (a box the model's own size; at run time both boxes stop bullets too).
Spawn CreatureA creature of a type from Creature Studio, with health, tier and pay.
Spawn NPCA character people talk to.
Spawn InteractableSomething people use with E: a lever, a note, a terminal.
Create ComponentA component: a capture point, a crate, a zone (no Velocity or Scale).
Spawn Weapon On GroundA gun or item lying on the ground, picked up like the map's own.
Spawn EntityOne of the game's entities with your keys: sprites, beams, sparks, sounds, relays. Only classes that are safe while the game runs.
Spawn ProjectileA flying model or sprite that hits things (below).
Spawn Trigger VolumeAn invisible box or sphere that says who goes in and out (below).

Each one hands back what it made (its Entity output). Keep it in a variable to move, change or remove it later with Remove Entity.

The transform pins

Every spawn node has the same pins for where the thing goes:

PinWhat it does
At entity (at_ent)Put it at this entity's spot: a player, a marker, another prop.
At position (pos)Put it at this point. Wins over At entity when both are wired (the Problems tab says so).
Local offset (offset)Move it from At entity along that entity's own forward, right and up.
Rotation (angles)Its facing (pitch, yaw, roll), set outright.
Rotation offset (angles_offset)Turned this much more than At entity's facing (or its own).
Velocity (vel)Starts it moving. A thing that stood still then falls and slides.
Scale (scale)Its size, for models and sprites (1 is normal).

The setting Face the way At entity faces (on by default) turns the new thing to match At entity before Rotation offset is added.

A crate one step in front of a player, facing them:

Chat Command ("crate") → Spawn Prop (At entity: Player, Local offset: 64 0 0, Rotation offset: 0 180 0)

A gun tossed forward when a player dies:

Player Killed → Spawn Weapon On Ground (deagle, At entity: Victim, Local offset: 0 0 32, Velocity: Scale Vector (Aim Direction Victim, 250))

Local and world space

World space is the map's own X, Y and Z: the same for everyone. Local space is seen from a player or entity: X forward, Y right, Z up, by its facing. Local offset is local; At position and Velocity are world.

One exception: Attach To's Offset is along the world, not the parent's facing. Use the Follow setting to stick to one of the model's attachment points instead.

A sprite floating over a player's head that follows them:

Spawn Entity (env_sprite, At entity: Player) → Attach To (Entity, Parent: Player, Offset: 0 0 48)

When the spot is taken

Collision on Spawn Prop (and Spawn Entity making a cycler_sprite or cycler model) has the map editor's names: None, Box, players only, Box, players and bullets. A box is the model's own size times its scale. The game has no players-only solid for something spawned, so at run time both boxes stop bullets too; in the map editor, players only is an invisible CLIP brush. A graph from before keeps what it did (Spawn Prop: what Solid says).

Spawning on top of a wall, a player or another prop can leave a thing stuck. Spawn Prop, Spawn Creature, Spawn NPC, Spawn Interactable, Spawn Entity, Spawn Weapon On Ground, Create Component and Spawn Projectile check the spot for you. Their setting If the spot is blocked says what to do (the same choices as Unreal's Spawn Collision Handling):

If the spot is blockedWhat happens
Always spawn, ignore collisionsExactly there, even overlapping. It may get stuck.
Try a nearby spot, but always spawnMoved to a free spot within Max distance if there is one, else exactly there anyway.
Try a nearby spot, don't spawn if still blockedMoved to a free spot within Max distance, or not made at all (Failed: Blocked). The default.
Don't spawn if blockedExactly there, or not made at all (Failed: Blocked).
Retry every N seconds up to M triesExactly there once the spot clears; tries again every Retry every seconds, Retry tries times (0: until it's clear), then Failed: Retries used up.

Max distance for a nearby spot is 128 to start (16 to 1024).

The outputs tell you how it went:

  • Then runs right away, whatever happened. Use it when you don't care.
  • Spawned runs once the thing exists, and Failed once the node gives up. With Retry, either can come seconds later.
  • Entity is what it made (valid on Spawned). Success says whether it worked, Moved whether it went to a nearby spot instead of the one you asked for.
  • Failure reason says why it failed: Blocked, Out of entity slots, Limit reached, Missing file, Retries used up or Bad input (At entity is gone and there's no position).

A fallback: try one spot, then another, and say why if both fail:

Spawn Creature (At entity: Spot A, Don't spawn if blocked) → Failed → Spawn Creature (At entity: Spot B) → Failed → Switch on Enum (Failure reason) → Out of entity slots → Log Line

A crate that waits until players step off its spot:

Round Started → Spawn Prop (crate, At entity: Marker, If the spot is blocked: Retry, every 2 s, 0 tries) → Spawned → Sprite At (At: Entity)

To pick a spot yourself, Find Free Spot Near gives the point if a player (or the size you pick) fits there, else the nearest free spot in rings round it, up to Max distance. Found is No when there's none.

The default is "Try a nearby spot, don't spawn if still blocked" for most nodes; Spawn Interactable starts at "Don't spawn if blocked", and Spawn Projectile at "Always spawn, ignore collisions" (a projectile isn't solid). Spawn Trigger Volume has Spawned, Failed and Failure reason too, but never checks the spot: a trigger volume isn't solid either. Whatever the node, the debugger marks it with the reason, and the server log says what was skipped.

Wave creatures (Round Table On) spawn on the wave spawners' free spots. By default they hunt the defenders from anywhere and never flee when badly hurt. Turn off Creatures hunt players to keep each type's own aggression, or set Flee when badly hurt to Creature's own. A waves.ini section (hunt = 0, flee = own) or one wave's line (wave 8 = hound 5 hunt=0 flee=own) can change it for its waves.

Projectiles

Spawn Projectile fires a model or sprite. Where from: At position, else At entity (a player's eyes) with Local offset, else the Owner's eyes. Which way: Direction, else Rotation, else the way At entity faces. Gravity 0 flies straight; 1 falls like a grenade. Damage hits what it touches, or everything in Radius.

Its own On Hit output runs later, for this projectile only, with Hit Position, Hit Player, Hit Entity, Hit World and Hit Zone (each bounce too). On Expired runs when its Lifetime runs out. So two kinds of projectile from the same mode never mix up their hits. Projectile Hit is the event for every projectile at once.

Player Pressed Button (Attack 2) → Branch (Is Ready) → True → Start Cooldown (3 s) → Spawn Projectile (Owner: Player, At entity: Player, Speed 1200) → On Hit → Explosion (Hit Position, Damage 60)

A kill counts for the Owner. Up to 64 fly at once (the Projectiles at once setting); a new round clears them. Remove Projectile takes one away with no hit. Tick Dangerous to bots so bots dodge it. The starter library's Fireball is this, ready to use.

Trigger volumes

Spawn Trigger Volume makes an invisible box or sphere. Begin Overlap runs when something goes in, End Overlap when it leaves (or dies or leaves the server inside, or the volume is removed). Who counts: players, creatures or anything. Give it a name so the events pick out the right one.

Put it at a Position, or At entity with a Local offset: then it follows the entity and turns with it. Rotation turns a box; a sphere ignores it. Volumes are checked ten times a second.

A jump pad:

Round Started → Spawn Trigger Volume (Box 96×96×32, Name: "pad", At position: Marker)
Begin Overlap ("pad") → Push (Who, Straight up, 900)

Is Overlapping asks who's inside right now; Remove Trigger Volume takes it away. Map-made triggers still work with Player Touched and Entered Map Zone.

Moving and changing things later

See also

A hand-written guide. Every node it names links to the node reference, which is made from the app's own catalog.