DockingOffsetX
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Flag: | DockingOffsetX |
| File(s): | art(md).ini |
| Values: | three comma-separated signed integers |
| Default: | 0,0,0 |
| Applicable to: | BuildingTypes |
Define the positions when units dock[1] to this building, using the XYZ coordinate system.
To make it more clear, here's the Aircraft Command HQ:
Here we can see the X axis, Y axis, and Z axis offsets in leptons from the center (0) of the building, where the red cells are not docks. As an example, from this image you can see that if you wanted to make Dock #5 where the topmost red cell is located, you would use DockingOffset4=-256,-128,0 where the center of that cell's X coordinate is -256 and center of the cell's Y coordinate is -128.
Notes
The value of X is an integer from 0 to NumberOfDocks - 1, corresponding to the order of docks.
For buildings that also have Factory=AircraftType, this is still the initial position[2] where aircraft are produced and created on the map.
Although in the DockingOffset0 entry under the corresponding section of Tank Bunker in art(md).ini, it is written:
;unused, but must be present. Doocking offset depends on the direction ou are coming from
However, because there is a default value, removing it won't cause any problems. As for the actual offset-related content in the latter part of the sentence, please refer to the table on the Bunkerable page.
Bugs/Side-Effects/Unexpected Limitations
Although aircraft can start reloading ammunition as long as they dock to the position on the building corresponding to their own order, for those aircraft with AirportBound=yes, they will still check whether the landing site is within the building's Foundation; if not, then they will hover at the height set by the aircraft's own FlightLevel directly above the dock coordinates.
- Setting the Z-coordinate of DockingOffsetX to the same height as FlightLevel cannot forcibly complete the docking.
Footnotes
- ↑ This also includes the situation when vehicles dock to buildings with UnitRepair=yes, although they do not need to fill in buildings in Dock=, however, in this case, only one (Um... unless you want the game to crash) dock connection at the same time, thus only DockingOffset0 is used.
- ↑ In this case, non-zero Z values are valid; they determine the height at which aircraft are created.
References
Harvester dock positions use separate hard-coded rules and ignore NumberOfDocks or Dock. If you need to define them, please use Ares version 3.0 or above and use DockUnloadCell to define. Refer to Ares documentation.