gitwtfhub

wtf is paldex?

catrenelle/paldex — explained in plain English

Analysis updated 2026-05-18

1HTMLAudience · developerComplexity · 4/5Setup · hard

TL;DR

A self-hosted live map for a Palworld dedicated server that tracks players, collectibles, bosses, and world state directly from the game's save files.

Mindmap

mindmap
  root((PalDex))
    What it does
      Live server map
      Player progress tracking
      Boss and collectible layers
      Active dungeon tracking
    Tech stack
      Python
      Flask
      Leaflet.js
      C#
    Use cases
      Dedicated server dashboard
      Per-player progress view
      World state monitoring
    Audience
      Palworld server admins
      Game modders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a live map dashboard for a self-hosted Palworld dedicated server showing player positions and progress.

REASON 2

Track per-player collection, boss defeats, and quest progress across a shared game world.

REASON 3

Monitor which open-world dungeons are currently spawned and active on the server.

What's in the stack?

PythonFlaskLeaflet.jsC#Docker

How it stacks up

catrenelle/paldexabhishek-kumar09/mern-live-js-june-2021abhishek-kumar09/z
Stars111
LanguageHTMLHTMLHTML
Last pushed2021-09-132019-12-23
MaintenanceDormantDormant
Setup difficultyhardmoderateeasy
Complexity4/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires SSH access to a dedicated server host, save file parsing tools, and a one-time asset extraction step.

License terms are not stated in the README.

Wtf does this do

PalDex is a self-hosted live map for a Palworld dedicated game server. It shows where players are, what they have collected, which bosses they have defeated, and the overall state of the game world, almost all pulled directly from the server's own save files and the game's own asset files rather than guessed or scraped from a wiki. The map covers a wide range of layers: player positions and stats, hundreds of collectible statues and blueprints, dozens of boss encounters and named enemy leaders, boss rush towers, fast travel points, lore pickups, shops run by NPCs, quests, player built guild bases, and dungeon entrances that only appear on the map while they are actually active in the game. Most of these can be filtered per player, so picking a player from a dropdown shows exactly what that person has found, defeated, or unlocked, and centers the map on their current position. Under the hood, a Python script connects to the server over SSH to pull down the save files every thirty seconds, and another script decodes those files using an existing open-source save-parsing library, since the standard published tool does not support the newest save format. A separate one-time C# tool reads the game's own asset files to extract things that do not change often, like map textures, icons, and names, and that output gets baked into the deployment rather than recomputed on every request. A small Flask backend serves all of this as JSON, and the frontend is a single HTML page using the Leaflet mapping library, with no build step or framework. A handful of details, like elemental type matchups and a few NPC spawn positions, are not stored anywhere in the game's own files, so those specific values are cross-checked against public wiki sources instead, with the reasoning documented in the project's notes file. Deployment works either through Docker or as a plain Linux service.

Yoink these prompts

Prompt 1
Write a Python script that connects over SSH to a game server and pulls save files on a recurring schedule.
Prompt 2
How do I decode a proprietary game save file format using an existing open-source parsing library?
Prompt 3
Build a Flask API that serves live and static game data as JSON endpoints for a Leaflet.js map frontend.
Prompt 4
Design a per-player filtering system for a game progress map that toggles collectible and boss checklists.

Frequently asked questions

wtf is paldex?

A self-hosted live map for a Palworld dedicated server that tracks players, collectibles, bosses, and world state directly from the game's save files.

What language is paldex written in?

Mainly HTML. The stack also includes Python, Flask, Leaflet.js.

What license does paldex use?

License terms are not stated in the README.

How hard is paldex to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is paldex for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.