Coordinates: Difference between revisions

From Vintage Story Wiki
mNo edit summary
m (replace table with wikitable, formatting and some phrasing in intro)
Line 1: Line 1:
= Coordinates =
'''Coordinates''' are the system and general notation that is used to determine location. While playing the game, the coordinate HUD shows position relative the center of the world. This means negative values are possible. However, internally the coordinates are limited to positive values on every axis.
The coordinate system expects positive values on every axis. The world map is generated from the origin point of <code>x: 0, y: 0, z: 0</code>, extending to <code>x: world width in blocks, y: world height in blocks, z: world depth in blocks</code>.<br>
 
Some misconception can arise from the coordinate system, as the in-game HUD displays coordinates based on the center point of the x and z axis of the world, and the player's relation to them.<br>
Some misconception can arise from the coordinate system, as the in-game HUD displays coordinates based on the center point of the x and z axis of the world, and the player's relation to them. The debug screen displays both absolute and relative coordinates.
'''Example:''' For a world size of 1000000 blocks in width and depth, the absolute player position on spawn would be <code>x: 500000, z: 500000</code>. In the HUD, this would be displayed as <code>x: 0, z: 0</code>
 
'''Example:''' For a world size of 1,000,000 blocks along the x and z axes, the absolute player position at spawn would be 500,000 and 500,000. In the HUD, this would be displayed at 0 and 0.


== Notation ==
== Notation ==
For use in commands, coordinates use the following notation.
For use in commands, coordinates use the following notation.
<table class="wikitable">
{| class="wikitable"
  <tr style="background-color: rgba(0,0,0,0.2);">
|-
    <th style="background-color: rgba(0,0,0,0.2);">Coordinate</th>
! Coordinate !! Explaination
<th style="background-color: grey;">Explanation</th>
|-
  </tr>
| <code>x</code> || Relative to the center of the world.
  <tr>
|-
    <td>x</td>
| <code>=x</code> || Absolute with regard to the origin of the world.
<td>Relative to the center of the world.</td>
|-
  </tr>
| <code>~x</code> || Relative to the player.
  <tr>
|}
    <td>=x</td>
<td>Absolute. Relative to the world as a whole.</td>
  </tr>
  <tr>
    <td>~x</td>
<td>Relative to the player.</td>
  </tr>
</table>


'''Example:''' Teleport to the absolute coordinates 0, 50, 0 (Note that the Y value is by default interpreted as an absolute value)<br>
'''Example:''' Teleport to the absolute coordinates 0, 50, 0 (Note that the Y value is by default interpreted as an absolute value)
/tp =0 50 =0
<code>/tp =0 50 =0</code>.

Revision as of 18:07, 14 April 2020

Coordinates are the system and general notation that is used to determine location. While playing the game, the coordinate HUD shows position relative the center of the world. This means negative values are possible. However, internally the coordinates are limited to positive values on every axis.

Some misconception can arise from the coordinate system, as the in-game HUD displays coordinates based on the center point of the x and z axis of the world, and the player's relation to them. The debug screen displays both absolute and relative coordinates.

Example: For a world size of 1,000,000 blocks along the x and z axes, the absolute player position at spawn would be 500,000 and 500,000. In the HUD, this would be displayed at 0 and 0.

Notation

For use in commands, coordinates use the following notation.

Coordinate Explaination
x Relative to the center of the world.
=x Absolute with regard to the origin of the world.
~x Relative to the player.

Example: Teleport to the absolute coordinates 0, 50, 0 (Note that the Y value is by default interpreted as an absolute value) /tp =0 50 =0.