Files

Palworld reference template

This template demonstrates every important V1 contract: official image, public UDP game port, private REST integration port, persistent save data, write-only credentials, online-save backup, import and an independently versioned WebAssembly adapter.

Verified upstream facts

  • Pocketpair publishes the official image and example Compose deployment at pocketpairjp/palworld-dedicated-server-docker.
  • The current official example at specification time uses ghcr.io/pocketpairjp/palserver:v1.0.2.101103, UDP 8211, /pal/Package/Pal/Saved and the packaged helper.sh pattern.
  • The official requirements specify four or more CPU cores, 16 GB memory with over 32 GB recommended for stability, and UDP 8211. The template's 8 GB minimum is an explicit lower bootable boundary mentioned upstream, not a stability recommendation; the UI must warn below 16 GB.
  • The configuration reference documents AdminPassword, RESTAPIEnabled, RESTAPIPort, server name/password and maximum players.
  • The REST API documentation documents information, players, metrics, announce, save, shutdown and moderation operations. REST API credentials and port must remain private.

The image tag and upstream API may change. Catalog maintainers must verify and release a new immutable template version; existing instances remain pinned.

Reference limitations

  • Artwork URLs are intentionally absent until a catalog maintainer selects suitable source files and attribution. DoGaMa caches and converts accepted raster artwork locally.
  • The schema's storage sizes are conservative product defaults because upstream specifies SSD performance but not a fixed disk-size requirement.
  • Local hosted-world migration may require player identity conversion. The generic V1 importer detects structure and warns; it does not silently convert identities.
  • The checked-in module manifest is a source example. It becomes installable only after module.wasm is built and its real SHA-256 replaces the all-zero placeholder.