Skip to main content

Coordinate picker concept

This page explains the concept and behavior of the coordinate picker itself.

If you are looking for the player workflow to create and manage reusable places, see Saved places in the shop frontend.

What the picker solves​

Many dzbot forms need map coordinates (X, Y, Z). The picker provides one consistent way to fill those fields and avoid manual coordinate errors.

Core entry points in the UI:

  • From map
  • From places
  • From placements

If you need to understand where the reusable places behind From places come from, see Saved places in the shop frontend.

Picker behavior​

The picker generally offers these coordinate sources, even though not all forms use all of them:

  • From map
  • From places
  • From placements

This gives players a predictable way to fill coordinate fields across different forms.

Map selection behavior​

From map opens a full-screen map overlay.

  • clicking the map selects a marker position
  • clicking Use applies X and Z into the target fields
  • if a Y field exists, it is filled automatically when possible

The automatic Y is the height of the ground or, if there is one, the first walkable surface above it: piers, bridges and building ground floors, so deliveries land where players can reach them. Where a structure has no floor, this can be its roof (small sheds, crane decks). Upper floors are not detected; enter Y manually or use a saved place for those.

If the height cannot be determined for a spot, the picker says so and only confirms once you enter Y yourself, so nothing is stored at height 0.

Places and placements as picker sources​

From places shows reusable locations grouped by ownership:

  • personal places
  • faction places (for memberships)
  • group places (for group membership)

Users can search and select one location quickly instead of typing coordinates manually.

For how players create these reusable places, see Saved places in the shop frontend.

From placements shows recent placement positions and helps when a user remembers the action but not the exact coordinates and is only available when creating a new reusable place.

Data source note: From placements depends on imported server logs. Recent placements can appear with delay.

Practical understanding​

  • use From map when users want visual selection
  • use From places when users already saved stable locations
  • use From placements when users want to reuse recent activity positions

For day-to-day player guidance on creating, naming, and reusing places, see Saved places in the shop frontend.

For import/freshness behavior, see Logs import concept.