WEB PANEL ADDRESS :

http://:8127

PlayerMapX

PlayerMapX is a server-side web map, player tracking, and admin monitoring plugin for Minecraft servers.

It gives server owners and staff a browser-based control panel where they can view the server map, track online players, inspect player information, monitor server activity, and manage visibility tools from one place — without requiring any client-side mods.

PlayerMapX is designed for Paper, Spigot, and Bukkit servers and focuses on giving admins better server visibility while keeping performance and security in mind.

Naming Note:
PlayerMapX is the new public project name.
Some commands, folders, config keys, permissions, logs, and internal labels may still use the older development name SNKAWatchMap for compatibility.

---

What is PlayerMapX?

PlayerMapX works like a lightweight admin control room for your Minecraft server.

Instead of checking everything manually in-game, server owners and trusted staff can open a web dashboard and monitor important server information directly from a browser.

You can use PlayerMapX to:

• View a live server map
• Track online players in real time
• See player location, health, ping, world, and gamemode
• Open detailed player information panels
• View inventory or equipment data if enabled
• Monitor server status and performance
• Check render status and map updates
• Use optional admin-only map layers
• View anti-cheat alerts when supported
• Manage visibility tools safely from a web panel

PlayerMapX is built for server owners who want more control without installing a large or heavy full-server management system.

---

Web Panel

PlayerMapX includes a built-in web dashboard that runs from your server.

The web panel is designed to help admins quickly understand what is happening on the server without needing to constantly teleport, use commands, or inspect logs manually.

The dashboard can include:

• Live map viewer
• Online player list
• Player detail sidebar
• Player status cards
• Inventory viewer
• Server status section
• World and dimension selector
• Map render status
• Tile cache status
• Anti-cheat alert section
• Performance/debug section
• Admin-only tools
• Basic security and session controls

The panel is intended for server owners, admins, moderators, and trusted staff.

---

Live Web Map

PlayerMapX provides a browser-based map view for your Minecraft server.

The map system is designed to be lightweight and performance-aware. It can show a 2D or 2.5D-style view of the world using cached rendered tiles.

Map features may include:

• Surface world map
• 2D tile-based rendering
• 2.5D-style height shading
• Cached map tiles
• Dirty tile updates when blocks change
• Multi-world support
• Dimension support
• Lazy tile loading
• Render queue limits
• Optional manual render controls
• Optional admin-only visibility layers

The goal is to give staff a useful visual overview of the world without putting unnecessary load on the server.

---

Real-Time Player Tracking

PlayerMapX can show online players directly on the web dashboard.

Staff can monitor player movement and basic status information in real time.

Player tracking information can include:

• Player name
• UUID
• Current world
• Coordinates
• Direction
• Health
• Food level
• Ping
• Gamemode
• Online/offline status
• Movement updates
• Last known location

This is useful for staff teams who need to monitor active players, check suspicious behavior, or quickly find where players are located.

---

Player Detail Panel

Clicking a player in the dashboard can open a detailed player information panel.

Depending on configuration and permissions, the panel may show:

• Player name
• UUID
• World
• X, Y, Z coordinates
• Health and food level
• Ping
• Gamemode
• Current status
• Armor
• Offhand item
• Current held item
• Inventory overview
• Ender chest view, if enabled
• Potion effects
• Recent activity
• Anti-cheat context, if supported

Inventory-related features are designed to be on-demand only, so the plugin does not constantly pull heavy player data when it is not needed.

---

Inventory Viewer

PlayerMapX can optionally provide inventory visibility for trusted staff.

This can help admins check suspicious items, verify player inventories, or investigate reports without needing to interrupt gameplay.

Inventory features may include:

• Main inventory view
• Armor slots
• Offhand slot
• Current selected item
• Ender chest support, if enabled
• Item names
• Stack amounts
• Basic item metadata display

Inventory viewing should only be enabled for trusted roles because it can expose sensitive player information.

---

Admin-Only Map Layers

PlayerMapX can support advanced admin-only layers for deeper server monitoring.

These features are intended for trusted server owners and staff only.

Optional admin layers may include:

• Underground view
• Cave view
• Y-level slice view
• Ore overlay
• Container markers
• Hidden area visibility
• Staff-only map tools

These tools are disabled or restricted by default because they can reveal hidden bases, caves, ores, containers, or private player builds.

They should only be used for moderation, investigation, or controlled admin monitoring.

---

Anti-Cheat Alert Support

PlayerMapX can integrate with supported anti-cheat systems when available.

If an anti-cheat plugin such as GrimAC is installed and supported, PlayerMapX may show alert information inside the web dashboard.

Anti-cheat alert data may include:

• Player involved
• Check name
• Violation level
• Alert time
• Player location
• Ping context
• TPS context
• Recent alert history

If no supported anti-cheat plugin is installed, PlayerMapX continues working normally as a map and monitoring plugin.

---

Server Status Monitoring

The web panel can show basic server health and activity information.

Server status information may include:

• Online player count
• Maximum player count
• Current TPS
• Server uptime
• Loaded worlds
• Map render queue status
• Tile cache status
• Memory usage
• Plugin status
• Debug information
• Recent activity indicators

This helps server owners quickly see whether the server is running normally or if something needs attention.

---

Performance-Safe Design

PlayerMapX is designed with server performance in mind.

The plugin avoids heavy constant scanning and uses safer systems for map rendering and player inspection.

Performance-focused systems may include:

• Cached map tiles
• Lazy tile rendering
• Dirty tile updates
• Render queue limits
• Async tile image generation
• Main-thread snapshot budgeting
• TPS-aware load reduction
• WebSocket update batching
• On-demand inventory snapshots
• No full-world render by default
• No ore scanning by default
• No underground scanning by default
• No heavy 3D rendering by default

The goal is simple:

Give admins better visibility without destroying server TPS.

---

Security

PlayerMapX is built for admin use, so security is important.

The web panel should never be treated like a public website unless it is properly protected.

Security-related features may include:

• Login protection
• First-run setup process
• Password hashing
• Session expiration
• Role-based dashboard access
• Permission-gated admin tools
• Rate limiting
• Audit logging
• Localhost-safe defaults
• Restricted sensitive features
• Protected inventory access
• Protected admin map layers

By default, sensitive tools should be used only by trusted staff.

Do not expose the dashboard publicly unless you understand the security risks and configure authentication, firewall rules, reverse proxy rules, and access controls properly.

---

Commands

Main command:

/snkawatchmap