Maps App

Players install Maps from the tablet's App Store. The app ID is tablet_map; it also works in the preinstalled-app and curated-item lists. Turning off the store makes it available like the other apps.

Maps uses o-link's map artwork and calibrated coordinates, so there is nothing extra to install. Its settings live in the shared oxide_settings table like every other tablet setting — no SQL migration is needed, and cleared locations and disabled availability survive restarts.

Locations

Admins manage Map App → Locations through /tablet settings. Add a name, choose an icon and color, optionally add a description, and enter X/Y/Z or use the world-placement control. Saved places are public and appear immediately in open Maps apps. The factory list is empty.

Adding a Location

The editor allows up to 100 locations, subject to the shared settings payload size. If saving says "The location list is too large. Shorten descriptions or remove some places before saving.", shorten some descriptions or remove places. If the crosshair button says "In-world placement needs an updated o-link. Update o-link to use this.", update o-link or type the coordinates instead.

The allowed icons and colours are listed in Configuration → Allowed Icons and Colours.

Detected Blips

Include existing map blips is enabled by default in the same settings section. Maps discovers location blips on the current player's client when opened and refreshes them every five seconds while open.

• It scans sprite IDs 1–1024 and excludes entity, waypoint, radius, hidden and minimap-only blips.
• These discoveries stay local to that player and are never saved into the shared Locations list.
• An owner-created location takes precedence over a discovered blip within two metres horizontally and three metres vertically.

Discovered places use a sprite-to-icon lookup and the game's blip color. Recognized sprites get a type label with their street or area underneath. Unknown sprites use the street or area as their title, with coordinates as the final fallback when neither is available.

Blip Overrides

Admins can use Map App → Detected blip overrides in /tablet settings to rename or restyle blips Maps found on the game map.

Overriding a Detected Blip

How Overrides Match

• Overrides match the original GTA sprite and position within two metres horizontally and three metres vertically.
• The original match fields are captured automatically and shown read-only.
• Names and appearance can change without moving the GPS destination. Blank optional fields keep the game blip's appearance and description.
• Matching uses the original blip data, so changing the tablet icon never breaks the match.
• An override only affects a blip that already exists for that player; it does not create a new public location.
• Owner-created Locations still take precedence at the same position.
• Removing an override restores automatic naming on open maps.

Overrides are saved in Config.MapBlipOverrides through the oxide_settings lifecycle, with no SQL migration. Empty lists remain empty on restart. Duplicate matches and invalid entries are rejected by the server — if you see "An override already matches this sprite and position. Edit that entry instead.", edit the existing override rather than adding a second one.

Using Maps

Players can search places, pan and zoom, select a marker or list entry, and use the popup above the selected pin to read its details and press Set waypoint to set their GTA GPS destination.

• Category filters group the displayed icons into shopping, food, services, transport, leisure and other places.
• Distance badges show straight-line distance from the player.
• The player marker updates while Maps is open.
• Each open starts at a closer view centered on the player's position, including the appropriate island in separate mode. Position updates, blip refreshes and resizing preserve the player's chosen view.
• Automatic focus and zoom movements ease into place; dragging, scrolling and loss of focus cancel the animation. Reduced-motion preferences are respected.
• Clicking an empty spot on the map immediately sets the GTA waypoint at those calibrated coordinates. Dragging pans the map, and clicking an existing pin opens its location popup.

These locations appear inside the tablet only — they do not create persistent world blips.

GPS Route Overlay

The purple route overlay follows the selected GTA waypoint, including waypoints set through the pause menu.

• In vehicles it samples the normal waypoint route.
• On foot it creates a GPS multi-route with on-foot display enabled and samples the radar-blip route channel (slot 1). This provides road navigation. That temporary route can also appear on the normal minimap; it is cleared when entering a vehicle, changing or clearing the waypoint, closing Maps, unloading the character, or stopping the tablet resource.

The overlay refreshes about once a second while moving, or every five seconds while stationary. Only returned route points are drawn; missing sections are never joined with a straight line to the destination. The sampler is capped at 2,048 points and 40 km, with incomplete routes marked as partial. When GTA cannot supply a route, Maps keeps the destination marker, reports that the road route is unavailable, and retries while open.

Closing Maps keeps the in-game waypoint and stops route sampling. Clear waypoint removes both the native waypoint and its tablet overlay.

Map Mode

Map mode controls how the map shows the mainland and Cayo Perico. It inherits o-link's setting by default and can be overridden under Map App → Map mode in /tablet settings, or with the admin console command:

oxide-tablet:mapmode inherit|combined|separate|disabled

The command is admin-only and answers in the server console, including when it is typed in game. See Admin Tools → oxide-tablet:mapmode.

Next Steps