1
ground
Bruno Carneiro edited this page 2026-02-13 18:25:50 -03:00

Ground Actors and Stationary Objects

AiGroundActor and AiGroundGroup represent ground units (vehicles, ships, artillery, etc.). GroundStationary is for static objects (buildings, AA guns, etc.) that can be queried and destroyed. GroundBuilding and GroundBombExplosion are data holders for building titles/positions and bomb explosions. Use IGamePlay.gpGroundGroups, gpGroundStationarys to get ground groups and stationaries.


AiGroundActor

Kind: interface (extends AiCart)
Ground unit: type, fuel, health.

Member Type Description
AiGroundActorType Type() AiGroundActorType Unit type (tank, truck, ship, etc.).
int Fuel() int Fuel.
double Health() double Health.

AiGroundGroup

Kind: interface (extends AiGroup)
Ground group: position, group type, and string ID.

Member Type Description
void GetPos(out Point3d pos) Get group position.
AiGroundGroupType GroupType() AiGroundGroupType Vehicle, train, ship, artillery, town.
string ID() string Group ID.

AiGroundWayPoint

Kind: class (extends AiWayPoint)
Ground waypoint with wait time and road/bridge info.

Member Type Description
waitTime double Wait time at waypoint.
roadWidth double Road width; also used for bridge index.
BridgeIdx int Property: bridge index derived from roadWidth.
AiGroundWayPoint(ref Point3d p, double speed, double wait_time, double road_width) constructor Construct.

AiGroundGroupType

Kind: enum

Value Description
Vehicle 1
Train
Ship
Artillery
Town

AiGroundActorType

Kind: enum
Categories include: vehicles (Medic, Motorcycle, ArmoredCar, Tractor, Car, Amphibian, SPG, Tank, Bus, LightTruck, Truck, Trailer), stationary (Balloon, Generator, Predictor, Radar, Artillery, AAGun, Plane, GroundCrew, …), trains (EngineWagon, FreightWagon, PassengerWagon), ships (ShipMisc, ShipTransport, ShipDestroyer, ShipCruiser, ShipBattleship, ShipCarrier, ShipSubmarine), and statics (Bridge, House).


AiAIChiefType

Kind: static class

Constant Value Description
GROUND 0x01 Ground chief type.

AiAIChief

Kind: interface (extends AiGroundGroup)
Chief ground group with field radius.

Member Type Description
double FieldR() double Field radius.

GroundStationary

Kind: interface
Static object on the map (building, AA, etc.). Obtain from GamePlay.gpGroundStationarys() overloads.

Member Type Description
Title string Title.
Name string Name.
country string Country.
Category string Category.
pos Point3d Position.
Type AiGroundActorType Type.
void Destroy() Destroy the stationary.
IsAlive bool True if still alive.

GroundBuilding

Kind: class
Simple container for building title and position (e.g. in OnBuildingKilled-related events).

Member Type Description
Title string Building title.
pos Point3d Position.

GroundBombExplosion

Kind: class
Container for bomb explosion data (title, mass, position). Used in bomb explosion events and OnBombExplosion.

Member Type Description
Title string Title.
Mass double Mass.
pos Point3d Position.