About this project

Palworld Live Map is a self-hosted, Docker-based web application that provides a real-time interactive map for Palworld dedicated servers. It connects to the server's official REST API and game-data API to display live player locations, guild bases, companion Pals, NPCs, and server health metrics such as FPS, uptime, and player count. The tool is read-only and requires no client-side mods. Key features include interactive maps of Palpagos and the World Tree, live player tracking, save-backed leaderboards for level, captures, Paldeck discoveries, Arena RP, exploration, and boss/tower clears. It supports guild base visualization with members and assigned worker Pals, search and filters for players, guilds, Pals, bases, and in-game locations, and configurable refresh intervals. Optional save integration enriches the map with offline player data, saved locations, levels, guilds, capture totals, Paldeck progress, Arena RP, fast-travel points, discovered areas, boss/tower clears, and last-seen times. A 'My Progress' feature combines private save-confirmed exploration with a local browser checklist, showing completion by landmark category and allowing users to hide completed locations. A private character-connection flow uses a grounded multiple-choice question to grant self-only completion access without exposing raw save identifiers. The application is deployed via Docker or Docker Compose, with a demo mode available for local preview without a Palworld server. It supports integration with the thijsvanloef/palworld-server-docker image. Configuration is handled through environment variables, including REST API URL, admin password, polling intervals, and save data settings. A healthcheck endpoint is available at /-/health. The project is licensed under MIT for original code, with Palworld-derived assets remaining under Pocketpair's copyright. It is an independent, fan-made project not affiliated with Pocketpair, Inc.