Features & Architecture ⚡🛡️
PalSupervisor operates as an in-process native supervisor for Palworld dedicated servers (PalServer-Win64-Shipping-Cmd.exe). Engineered in high-performance C++20, PalSupervisor hooks directly into Unreal Engine 5.1.1 runtime memory via a non-intrusive Windows proxy DLL (version.dll).
1. Engine Detour Hooking & Zero-Tick Architecture
- Direct ProcessEvent Interception: Detours player RPCs and engine dispatch tables before server gameplay logic processes them, allowing instant sanitization of malicious network packets.
- No Disk Modification: Hooks game memory dynamically upon server boot. No game files or executable binaries are patched on disk.
- Zero Overhead: Detour hook execution overhead is measured under 0.02 milliseconds per tick, preserving 100% server tick rate (TPS).
2. Autonomous Server Janitor & Audit Trail 🧹
- Orphaned Wild Structure Demolition: Automatically detects and dismantles structures built outside official guild base camp circles, freeing up physics memory and actor limits.
- Loose Ground Drop Purging: Sweeps abandoned ground item drops (
DropItem) at scheduled intervals to prevent RAM bloat and physics clutter. - Deathbag Cleanup & Age Retention: Purges player death corpse containers exceeding configurable age limits (
deathbag_max_age_minutes), preventing deathbag hoarding from degrading server tick rates. - Live In-Memory Audit Trail: Records up to 500 recent swept items in an in-memory ring buffer accessible via
GET /api/janitor/sweptand in-game command/janitor history. Captures item category, item name, quantity, owner UID, owner player name, UE world coordinates, and in-game map coordinates. - Manual & Automated Sweeps: Supports background timers as well as instant manual sweeps with customizable criteria and dry-run mode via
POST /api/janitor/run.
3. Real-Time Spatial Live Map & Entity Radar 🗺️
- Full-World Entity Indexing: Continuously indexes live world entities including loose loot, player death corpse containers, wild dropped Pal spheres, world treasure chests, dungeon chests, wild Pal eggs, supply drop capsules/meteorites, and unowned player structures.
- Calibrated Dual-Coordinate Projection: Projects raw 3D Unreal Engine centimeter vectors into standard Palworld in-game map coordinates ($X, Y$) matching the player HUD map ($X = ext{WorldX} \times 0.002179 - 344$, $Y = ext{WorldY} \times 0.002179 + 270$).
- One-Click Deathbag Recovery: Direct item restoration from deathbags into player inventories via
POST /api/map/recoverbagor in-game command/recoverbag.
4. Proactive Anti-Cheat Matrix 🛡️
- Movement & Delta-Position Validation: Calculates delta position over delta time to detect speed hacking, fly hacking, and illegal coordinate teleportation.
- Stamina & Stat Sanitization: Detects and clamps impossible stamina values, health spikes, and unearned stat points.
- Illegal Item & Pal Detection: Filters out unobtainable or blacklisted item IDs and illegal Pal passives.
- Evidence Logging & Webhooks: Maintains an active violation score per player, triggers auto-bans when thresholds are breached, and dispatches rich embed alerts to Discord webhooks.
5. Dynamic Boss & Encounter Engine 👑
- Template-Driven Boss Spawns: Define custom multi-tier boss encounters in
PalSupervisor/Templates/*.jsonwith custom hitpoints, minions, level scaling, and drop tables. - Invasion Raid Management: Trigger, monitor, or immediately cancel base camp raid events with
/raidand/stopraid. - Supply Drops & Meteorites: Trigger on-demand supply capsules or meteorite strikes at specific coordinates or target players.
6. Native Embedded REST API 🌐
- High-Speed HTTP Daemon: Lightweight, multi-threaded C++ REST API listening on port
27020(http://127.0.0.1:27020). - Complete Administrative Suite: Over 120 endpoints providing full server control, player moderation, inventory grants, cheat toggles, and live radar feeds for dashboard managers and Discord bots.