3D Map

The Live map tab shows every player on your server as a marker on a 3D model of Los Santos, updated every few seconds. It helps you see where a report is happening, spot players in places they should not be, and act on a player with one click, all without joining the server.

Only Runs While You Watch

Your server only sends positions while someone has the Live map tab open. Nothing is sent while nobody is watching, so the map costs nothing when it is closed.

How It Works

  1. You open the Live map tab. The panel tells codexart.net that someone is watching.
  2. Your server learns this on its next sync. The first positions arrive within about 15 seconds; until then the map shows "Waiting for the server, positions start within 15 seconds…".
  3. While the tab stays open, your server sends the position, heading, speed and vehicle state of every player at the map update interval.
  4. When you close the tab or switch to another browser tab, the panel stops asking. About 30 seconds later the live session ends and your server stops sending positions.

Using the Map

  • Drag to rotate, right drag to move, scroll to zoom.
  • Switch between 3D and Top in the top right corner. Top looks straight down, like a classic map.
  • Hover over a marker to see the player's name, server ID and speed in km/h.
  • Click a marker, or a name in the list on the right, to select a player.
  • Type in Find a player to filter the list by name or server ID.

The status in the top left corner shows Live · 32 players while positions are coming in.

Los Santos in 3D

The map is a 3D model of the whole game world: terrain, mountains, roads, buildings, the airport and the coast. Markers stand at the player's real position and height, so a player on a rooftop or in the hills is shown there.

  • The first time you open the tab, the model (about 11 MB) loads in the background. A "Loading Los Santos" bar shows the progress at the top of the map. Your browser keeps the files, so later visits are much faster.
  • Until the model is ready, the map shows a simple grid with district names, and markers already appear on it.
  • If the model cannot be loaded, for example on a very old browser or a blocked network, the grid stays and the map keeps working.

Markers

MarkerMeaning
Round markerThe player is on foot.
Box markerThe player is in a vehicle. The list shows a car badge.
Ring around the markerThe selected player.
Marker colorThe player's trust band: red, orange, yellow, lime or green. Grey means no band, for example bypassed staff.

See Account Trust for what the bands mean.

Acting on a Player

When you select a player, the card on the right shows their name, server ID, a staff tag for bypassed staff, the trust badge, speed, state (On foot or In a vehicle) and position as x, y, z coordinates.

ButtonWhat it doesWho sees it
FocusFlies the camera to the player.Everyone
ProfileOpens the player drawer with identifiers, linked accounts and history.Everyone
WatchOpens the Monitoring tab and starts watching this player's screen.Owner, admin, editor
MessageSends a chat message to the player.Owner, admin, editor
ScreenshotPosts a screenshot of the player's game to your Screenshots webhook.Owner, admin, editor
KickRemoves the player from the server.Owner, admin, editor
BanBans the player.Owner, admin, editor

These are the same actions as on the Players tab, and they reach your server the same way. See Players. Clear selection deselects the player.

Configuration

Open Configuration → Network & rules → Web monitoring. With a license, the panel values are the ones your server uses; the config.lua lines below only show the matching keys.

OptionKeyDefaultWhat it does
Live mapMonitoring.LiveMaptrueAllows the Live map tab. When off, the map shows "Live map is turned off in Configuration → Network & rules."
Map update intervalMonitoring.MapInterval2Seconds between position updates while the map is open, from 1 to 30.
Config.Monitoring = {
    LiveMap = true,     -- Sends player positions while someone has the map open
    MapInterval = 2,    -- Seconds between position updates while watched (1 - 30)
}

[PERF] While the map is open, your server sends the positions of all players to codexart.net at every update. A lower interval gives a smoother map and more requests. If you only need to see where players are, a longer interval is enough.

Permissions

  • Every role on the license, including viewers, can open the Live map and see all players.
  • Only owners, admins and editors see Watch, Message, Screenshot, Kick and Ban.
  • The player drawer shows IP addresses and locations to owners and admins only.

Read Team Access to change roles.

Limitations

  • Positions are as fresh as the update interval. Fast vehicles can jump between updates.
  • The live session belongs to the license, not to each viewer. If one person has the Live map open while another watches screens in the Monitoring tab, their requests replace each other and the screen streams can stall. Coordinate with your team, or close the map while someone watches screens.
  • The map needs a browser with WebGL. Without it, the panel shows "The 3D map could not start in this browser."

Recommendations

Recommended:

  • Keep the default interval of 2 seconds unless you need a smoother view.
  • Use Profile and Linked accounts before you ban someone from the map.
  • Close the tab when you are done, so your server stops sending positions.

Avoid:

  • Leaving the map open in a background window for hours. It does nothing useful while you are not looking.
  • Banning players only because of where they stand. Teleport and noclip have their own detections.

Credits

The 3D Los Santos model and the way game coordinates are placed on it come from S4, who shared the code from their web admin panel with us. Thanks to S4 for the contribution.

Live Screens

  • Watch on the map opens Live Screens with the player already selected.

Players

  • The map uses the same player drawer and actions as Players.

Detections & Punishments

Common Problems

"Waiting for the server, positions start within 15 seconds…" Does Not Go Away

What you see: The map stays empty with the waiting message.

How to fix it:

  • Wait 15 seconds after opening the tab. The server learns about the map on its next sync.
  • Check that the server is online in the Overview tab.
  • Check that the browser tab is visible. The map pauses while the tab is in the background.

"Live map is turned off in Configuration → Network & rules."

What you see: The map does not start and shows this status.

How to fix it:

  • Turn on Live map under Configuration → Network & rules → Web monitoring and save. Your server picks it up within a minute.

"Server is offline."

What you see: The status says the server is offline.

How to fix it:

  • Start the server, or check the console for [CXA] license warnings. See Setup.

"The 3D map could not start in this browser."

What you see: The map area stays empty and this message appears.

How to fix it:

  • Turn on hardware acceleration in your browser settings.
  • Try another up-to-date browser.

I Cannot See the Moderation Buttons

What you see: The selected player card only shows Focus and Profile.

How to fix it:

  • Your role is viewer. Ask the owner or an admin to make you an editor under Team.

© 2026 CodeXart Studios · CXA Anticheat