Skip to content
View PalSupervisor's full-sized avatar

Block or report PalSupervisor

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
PalSupervisor/README.md

🎮 PalSupervisor — Palworld Dedicated Server Manager





image

A full-featured, web-based command center for managing Palworld dedicated servers. Built for server owners who want a clean, modern UI and pro-grade tools — without ever touching the command line after initial setup. From real-time monitoring and surgical player moderation to automated anti-cheat, scheduled backups, and full Nexus Mods integration — PalSupervisor is the only panel you'll ever need.
Join Our Discord for free/paid/trial keys HERE

✨ Features

🖥️ Server Control

- Start, stop, restart, and graceful-shutdown the server from the UI
- Live server status with FPS, frame time, and uptime
- World save on demand
- Broadcast messages and priority alerts to all online players
- Scheduled restarts with configurable interval and custom warning messages ({minutes} placeholder)
- Auto-restart on crash with configurable crash-check interval
- Optional backup-before-restart safety net

📊 Live Dashboard

- Color-coded ring gauges for FPS, frame time, player count, uptime, base camps, in-game days
- CPU, memory, and disk usage bars with health thresholds
- One-click Start · Stop · Restart · Save World · Broadcast
- Online players list with level badges, auto-refreshed every 5 seconds
- API health panel (RCON / PST / Game REST status)

👥 Player Management

- View all online and historical players across all platforms
- Supports Steam, Xbox (GDK/EOS), 32-char hex UIDs, and raw XUIDs (auto-detected)
- Inspect any player: inventory, Pals, stats, base
- Activity log per player
- Kick, ban, unban — one-click moderation
- Full ban list management
- Global item search — find who's carrying what across the server
- Give Items (any ID, any count) and Give Pals (with stats, passives, level)
- PalDefender Templates — save named Pal loadouts and gift them to players

🗺️ Live Map

- Real-time positions of players and guild bases
- Loot browser with category filtering
- Teleport any player anywhere on the map
- Teleport yourself to a player, or summon a player to you
- Per-user map display settings (toggle layers individually)

🏰 Guild Management

- Browse every guild on the server
- View members, levels, and bases
- Drill into base chests and base Pals
- Full guild oversight for moderators

🛡️ Anti-Cheat

- Scheduled automatic scans with configurable cadence
- On-demand manual scans
- Live results + full detection history
- Fine-grained level-gap thresholds (Lv 1–5) for cheat severity
- Kick, ban, reset cheaters, wipe Pals, or delete specific illegal items/Pals
- Resolve flags once reviewed
- Per-flag moderation log

🔧 Mod Manager

- Upload mods with name, version, author, description metadata
- Scan existing mod folders
- Enable / Disable / Toggle mods individually or in bulk
- Drag-style load order editor
- Per-mod config editor
- Dependency validation and update checks
- Profile export/import (share setups across servers)
- Custom mods directory override

🌐 Nexus Mods Integration

- Connect via Nexus API key
- Browse Trending, Latest, and Recently Updated mods
- Search the full Nexus catalog
- View mod details, file lists, and changelogs in-app
- One-click install directly to your server

💾 Backup System

- On-demand and scheduled world snapshots
- Configurable interval, max retained, and custom backup folder
- Optional backup-before-restart safety net
- One-click restore of any snapshot
- Restore server config from backup
- List, browse, and delete backups

📊 Monitoring & Logs

- Real-time server stats with historical charts (configurable retention)
- Live alert feed with clear-all support
- Filterable log viewer
- API health/status dashboard (RCON, PST, Game REST)
- Crash detection and reporting

⌨️ Console

- Send raw RCON commands directly from the browser
- Scrollable command history
- Old-school RCON power, modern UX

⚙️ Configuration

- Visual editor for PalWorldSettings / config.yaml
- YAML editor with full, structured, and raw modes
- Apply community presets in one click
- Import / export full config (JSON)
- Path validation
- Test connections (RCON, Game REST, PST) with one click
- Config backup restore — recover from broken edits

🔐 User & Permission System

- Multi-user support with full user management (create, edit, delete, reset password)
- 6-tier role hierarchy: visitor → member → moderator → admin → super_admin → owner
- Fine-grained permissions per page, per tab, per action
  (e.g., players.ban, mods.tab.nexus, dashboard.ui.broadcast)
- Permission-aware sidebar and routes (users only see what they can use)
- JWT auth with auto-logout on expiry
- 30-second permission refresh
- Forced password change on first login

🎨 Themes & Polish

- Multiple curated themes (colors, fonts, animations)
- Customizable card styles, border glow, spacing, shadows, sidebar styles
- Animated particle backgrounds
- Toast notifications
- Fully responsive layout with mobile-friendly sidebar
- Built-in license panel with activation + version info

🛠️ Advanced Settings (10 Tabs)

- Connections — RCON, PST, Game REST with live Test Connection buttons
- Auto-Detect — parses PalWorldSettings.ini + config.yaml and auto-fills
  ports, passwords, addresses, and admin info (with review modal)
- Server — exe path with native file browser, path verification,
  launch args, crash-check interval, auto-restart on crash
- Admin — personal Steam ID for teleport-to-me features
- Backups — automated snapshot rules
- Scheduled Restarts — interval + custom warning message
- Anti-Cheat — thresholds and scan cadence
- Whitelist — add/remove Steam IDs, global enable toggle
- Map Display — fine-tune what appears on the live map
- Themes — full UI customization
- Dashboard Port Manager + Restart App (with auto-reconnect)
- Full Config Export / Import (JSON)

🚀 Getting Started

Prerequisites

- A running **Palworld dedicated server**
- RCON enabled in `PalWorldSettings.ini` (`RCONEnabled=True`)
- Game REST API enabled (`RESTAPIEnabled=True`)
- PalDefender installed on the server

Installation

Download latest version from Releases Here

1. Extract the .rar file
2. Run PalSupervisor.exe
3. The dashboard will open automatically at http://localhost:3000

🧙 First-Time Setup Wizard

On first launch, you'll be guided through a 5-step setup wizard:

Step 1 — Server Location
- Point the panel at your PalServer.exe
- The wizard auto-detects your server executable and save folder
  by scanning common install paths
- Save path is derived automatically from the exe location
- Native file picker available for manual selection

Step 2 — RCON & REST API
- Enter your RCON address, port, and password
- Enter your Game REST API address, port, and password
- Both passwords typically match AdminPassword in PalWorldSettings.ini
- Optional: enable Base64 encoding for RCON if your server requires it

Step 3 — PST Auth
- Configure address, port, username, and password for your PST API
- Credentials automatically synced to config.yaml → auth
- Optionally enter your Steam ID to enable teleport-to-admin features

Step 4 — Memory Management
- Configure memory flush interval (default: 15 min)
- Check interval (default: 30s)
- Threshold (default: 1024 MB)
- Defaults work well for most setups

Step 5 — Complete
- Review your settings summary
- Click Finish Setup to write both config.json and config.yaml
- All settings can be changed later in the Settings page

🔌 Connection Types

| Connection      | Purpose                                          | Default Port |
|-----------------|--------------------------------------------------|--------------|
| RCON            | Player kicks, bans, broadcasts, teleports        | 25575        |
| Game REST API   | Server info, metrics, player list                | 8212         |
| PST API         | Save file inspection, player editing             | 8080         |

👤 User Roles

| Role          | Level | Description                                |
|---------------|-------|--------------------------------------------|
| visitor       | 1     | Read-only access                           |
| member        | 2     | Basic dashboard access                     |
| moderator     | 3     | Player moderation tools                    |
| admin         | 4     | Server management                          |
| super_admin   | 5     | Full server management                     |
| owner         | 6     | Unrestricted access                        |

🌍 Multi-Language Support

- Full UI translation across 10 languages
- Switch language instantly from the Settings page — no restart required
- Per-user language preference (each account remembers its own setting)
- RTL (right-to-left) layout support for Arabic
- Localized dates, numbers, and notifications

Supported languages:
- 🇬🇧 English
- 🇪🇸 Spanish    (Español)
- 🇯🇵 Japanese   (日本語)
- 🇸🇦 Arabic     (العربية)
- 🇫🇷 French     (Français)
- 🇷🇺 Russian    (Русский)
- 🇩🇪 German     (Deutsch)
- 🇹🇷 Turkish    (Türkçe)
- 🇨🇳 Chinese    (中文)
- 🇻🇳 Vietnamese (Tiếng Việt)

📁 Config Files

After setup, two config files are written:

- config.json — panel settings (RCON, REST, paths, backup, anti-cheat, etc.)
- config.yaml — PST / YAML auth and memory management settings

Both can be edited in the Settings page, or exported/imported as JSON.

🏆 Why PalSupervisor?

🎮 Stop babysitting your server. Start commanding it.
PalSupervisor — run Palworld like a pro.
- One dashboard — total control over your entire Palworld operation
- Zero command-line work after setup
- Built for solo operators AND multi-staff communities
- Permission-aware UI keeps your team focused on what they can actually do
- Automated anti-cheat keeps your world fair
- Scheduled backups keep your world safe
- Native mod + Nexus integration keeps your world fresh

📜 License

For free, trial, and paid keys — plus full community support, updates, and feedback:
Join https://discord.gg/VsctnXnKRk

Admin View



image

image

image



image



image



image



image



image



image



image



image



image



image



image



image



image



image



image



image



image



image



Guest View



image



image



image

Popular repositories Loading

  1. PalSupervisor PalSupervisor Public

    Palworld Server Managing Tool 🎮 PalSupervisor 🛡️ — Web-based control panel for Palworld dedicated servers. Manage players, guilds, mods, backups, anti-cheat, live map, and server config — with mult…

    HTML