This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
4rpl:commands:createunitonterrain [2021/01/20 18:39] – virgilw | 4rpl:commands:createunitonterrain [2025/02/14 14:57] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
~~NOTOC~~ | ~~NOTOC~~ | ||
- | < | + | < |
+ | <= [[4rpl: | ||
====== CreateUnitOnTerrain ====== | ====== CreateUnitOnTerrain ====== | ||
Line 6: | Line 8: | ||
===== Description ===== | ===== Description ===== | ||
- | Creates a unit from a CMOD UID (a unit template defined in a CPACK). You can get the CMOD UID from within the CPACK manager. | + | Creates a unit from a CMOD UID (GUID)((You can get the GUID from within the CPACK manager. |
+ | GUIDs are unique | ||
+ | for a list of these names.)). | ||
+ | |||
+ | initParams is a table that contains a set of variables that will be set on the newly created unit. See GetUnitSettings for a list of the data names that can be specified in the initData table when creating built in units. | ||
+ | |||
The unit will be placed on the terrain at the supplied terrain cell coordinates. | The unit will be placed on the terrain at the supplied terrain cell coordinates. | ||
- | The lower left corner of the map is 0,0 and the top right is mapWidth, | + | The lower left corner of the map is 0,0 (0:0) and the top right is mapWidth, |
- | height at the specified coordinates.\\ | + | 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. | 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. | See [[CreateUnit]] for more details. | ||
Line 18: | Line 27: | ||
CreateUnitOnTerrain(< | CreateUnitOnTerrain(< | ||
</ | </ | ||
+ | |||
+ | === See Also === | ||
+ | * [[4rpl: | ||
+ | |||
< | < | ||