4rpl:commands:createunitonterrain

This is an old revision of the document!


Index
Unit

CreateUnitOnTerrain

CreateUnitOnTerrain(<-CmodUID <-cellX <-cellZ <-initParams) ->unitUID

Description

Creates a unit from a CMOD UID (GUID)1) or from an internal unit name2).

The unit will be placed on the terrain at the supplied terrain cell coordinates. The lower left corner of the map is 0,0 (0:0) and the top right is mapWidth,mapLength. The unit will be placed at a height (the Y position) based on the terrain height at the specified coordinates.

The unit UID will be pushed to the stack. If the unit can not be created, -1 is pushed to the stack. See CreateUnit for more details.

Examples

"abcdefgh1234567" ->cmodUID
CreateUnitOnTerrain(<-cmodUID 42 23 0) ->unitUID

See Also

1)
You can get the GUID from within the CPACK manager.
GUIDs are unique to each custom unit and never change.
2)
See UnitTypes for a list of these names.
4rpl/commands/createunitonterrain.1695051348.txt.gz · Last modified: 2025/02/14 14:56 (external edit)