Live Screens
The Monitoring tab lets your staff watch what a player sees in the game, live, from the browser. Use it to check a report or a suspicious player without joining the server or spectating in-game. The stream is a series of screenshots, refreshed about once per second by default.
Requirements
Live Screens needs the screenshot-basic resource running on your server under exactly that name. Only owners, admins and editors see the Monitoring tab.
How It Works
- In the Monitoring tab, you tick the players you want to watch.
- The panel tells codexart.net who you are watching. Your server learns this on its next sync, so the first frame arrives within about 15 seconds.
- Your server asks each watched player's game for a JPEG screenshot through
screenshot-basic, at the frame rate you set, and sends each frame to codexart.net. - The panel shows the newest frame of each player. Every new frame replaces the previous one, so no recording or history is kept.
- When you stop watching a player, or close the tab, the panel stops asking. About 30 seconds later your server stops taking screenshots.
Nothing is captured while nobody is watching.
Watching a Player
- Open your license and go to the Monitoring tab.
- In Online players on the left, find the player. Search by name or server ID if the list is long.
- Tick the player. The counter shows how many you watch, for example
2 / 4. - The stream appears on the right. It shows "Waiting for the first frame…" until the first image arrives.
You can also start from the 3D Map: select a player and press Watch.
Each stream shows the player's name, server ID, ping and trust badge. The label in the corner of the image tells you how fresh it is:
| Label | Meaning |
|---|---|
| Connecting | No frame yet. |
| Live | The newest frame is less than 10 seconds old. |
12s ago | No new frame for that many seconds. The image you see is older. |
The buttons under each stream:
| Button | What it does |
|---|---|
| Larger / Smaller | Shows the stream across the full width, or back to normal size. |
| Message | Sends a chat message to the player. |
| Kick | Removes the player from the server. |
| Ban | Bans the player. |
| Stop watching | Removes the stream and stops capturing that player. |
Message, Kick and Ban work exactly like on the Players tab, see Players.
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.
| Option | Key | Default | What it does |
|---|---|---|---|
| Screen monitoring | Monitoring.Screens | true | Allows watching player screens from the panel. Needs screenshot-basic. |
| Players watched at once | Monitoring.MaxScreens | 4 | How many players can be watched at the same time, from 1 to 9. |
| Frames per second | Monitoring.Fps | 1 | [PERF] Screenshots per second for each watched player, from 0.2 to 4. |
| Image quality | Monitoring.Quality | 0.35 | JPEG quality from 0.1 to 0.9. Higher is sharper and larger. |
Config.Monitoring = {
Screens = true, -- Allows watching player screens from the panel (needs screenshot-basic)
MaxScreens = 4, -- Players watched at the same time (1 - 9)
Fps = 1, -- [PERF] Frames per second per watched player, every frame is a screenshot on that client
Quality = 0.35, -- JPEG quality 0.1 - 0.9
}Live Screens does not depend on Configuration → System → Screenshots. That setting is for screenshots attached to detection logs and the Screenshot action. Live Screens only needs screenshot-basic to be started.
Performance
[PERF] Every frame is a full screenshot taken on that player's game, so watching costs the watched player some performance, and every frame travels from the player to your server and from your server to codexart.net.
- The cost grows with the number of watched players, the frame rate and the image quality.
- Keep Frames per second at
1or lower.0.5(one frame every two seconds) is often enough to follow what a player does. - Keep Image quality near the default. Raise it only when you need to read small text on screen.
- Stop watching as soon as you have what you need.
See Performance Tuning for the other settings marked [PERF].
Privacy and Fair Use
Watching someone's screen is a strong tool. Use it for moderation only.
- Watch players because of a report, a detection or a clear suspicion, not out of curiosity.
- CXA does not show the player a notice while you watch. Tell your community in your server rules that staff can view screens for moderation.
- The panel keeps only the newest frame of each watched player; there is no recording. Don't save or share frames unless you need them as evidence.
- Only owners, admins and editors can watch. Give these roles only to staff you trust, see Team Access.
Limitations
- At most 9 players at once, and never more than Players watched at once.
- The live session belongs to the license, not to each viewer. If someone else on your team has the Live map open, or watches other players at the same time, the requests replace each other and streams can stall. Agree with your team who is watching.
- Frames that are too large are dropped. If a stream stalls at a high Image quality, lower the quality.
- The stream pauses its updates while your browser tab is in the background.
Recommendations
Recommended:
- Watch one or two players at a time with the default settings.
- Combine it with the 3D Map to find the player first, then press Watch.
- When you need evidence, use the Screenshot action on the Players tab or the 3D Map. It goes to your Screenshots webhook with your name.
Avoid:
- Raising Frames per second to 4 on a busy server.
- Leaving streams open when nobody is looking at them. Capturing continues while the Monitoring tab is open, even in a background tab.
- Watching staff or players without a moderation reason.
Related Features
3D Map
- Watch on the 3D Map adds the selected player to Monitoring. Both use the same live session.
Screenshots
- Single screenshots for logs and the Screenshot action are set up separately. See Screenshots.
Players
- The same Message, Kick and Ban actions, and the same rules for who can use them. See Players.
Common Problems
"Screen monitoring is off"
What you see: The Monitoring tab shows "Screen monitoring is off" instead of the player list.
How to fix it:
- Turn on Screen monitoring under Configuration → Network & rules → Web monitoring and save.
The Stream Stays on "Waiting for the first frame…"
What you see: No image appears, even after 15 seconds.
How to fix it:
- Check that
screenshot-basicis started. Typeensure screenshot-basicin the server console, then check the stream again. - The resource must be named exactly
screenshot-basic. A renamed copy is not found. - Check that the player is still online.
- Close the Live map if a teammate has it open, because it shares the live session.
The Image Is Black or Frozen
What you see: Frames arrive, but they are black or show the same picture.
How to fix it:
- The player's game may be minimized or still loading. Wait until the player is in the game world.
- Check the label in the corner. If it shows
12s agoor more, the player's game stopped answering; it may have a slow connection or be frozen. - Lower Frames per second so each screenshot has time to finish.
The Stream Is Blurry
What you see: You cannot read text or see details.
How to fix it:
- Raise Image quality step by step, for example to
0.5, and save. - Press Larger to make the stream bigger in the panel.
"You can watch up to 4 players at once."
What you see: The panel does not let you tick another player.
How to fix it:
- Stop watching one player first.
- Raise Players watched at once in Configuration if you really need more, up to 9.
"Server is offline, streams start when it comes back."
What you see: A yellow banner above the streams.
How to fix it:
- Start the server. The streams continue on their own once it syncs with the panel again.
The Monitoring Tab Is Missing
What you see: You see Live map but no Monitoring tab.
How to fix it:
- Your role is viewer. Only owners, admins and editors can watch screens. Ask the owner or an admin to change your role under Team.
© 2026 CodeXart Studios · CXA Anticheat