feat(core-keeper): add core keeper egg #6

Merged
ryan.mcgee merged 2 commits from feat/core-keeper-egg into main 2026-11-08 07:46:22 +00:00
Owner

Summary

  • bring the Core Keeper egg from UltraVu-Studios/core-keeper-egg into the monorepo, with fixes found by running it against the real server

Changes

  • add game_eggs/core_keeper egg (PTDL_v2) and README; add row to root README
  • password, game ID and seed are quoted: the old unquoted -password turned "my pass" into "my"
  • Game ID rule is 15-28 alphanumeric characters without Y, y, x, 0, O (the old min:28 rejected IDs the game generates itself, which are 15 characters)
  • World Mode allows 0 Normal, 1 Hard, 2 Creative, 4 Casual (names mapped by running the server; 3 has no name)
  • seed is optional and the flag is omitted when empty: seed 0 is not random, it hashes to the same seed every time, so the old default gave every new server the same map
  • World Index goes up to 29, as the game documents
  • PUBLIC_IP and the -ip flag are removed: -ip is the local bind address, and a public address the host does not own made the server fail with EADDRNOTAVAIL and never start
  • placeholder uuid removed, meta.update_url added, console filter uses grep --line-buffered
  • README documents both UDP ports (game and game port + 1), data paths, the stored password and game ID in ServerConfig.json, and the stop behavior
  • install script kept as is: it retried once after a Missing configuration error in one run and succeeded first try in another
  • icon: the official Pelican Core Keeper egg ships none, so use the game key art from the Steam store listing (top square crop of library_600x900, scaled to 200x200 JPEG, 10 KB) as the top-level icon data URI

Verification

  • install script in installers:debian from an empty directory: exit 0, 865 MB, server binary and both steamclient.so present
  • egg startup string with the egg default variable values and AUTO_UPDATE=1 in steamcmd:debian with a TTY: update check ran, Started session after 24s, UDP game and query ports bound, about 1.3 GB RAM
  • old startup vs new on the same server: password with a space (my vs my pass), 15-character game ID accepted, world modes 0/1/2/4 by number and name, seed 0 twice gives the same seed, empty seed gives different seeds on fresh worlds, non-local -ip fails to bind
  • Game ID regex checked against valid and invalid IDs
  • restored an existing world from a backup and it loaded (891 chunks)

Not tested

  • joining from a game client, by IP or Game ID
  • whether a stop with ^C loses unsaved world changes; the server prints no shutdown or save lines and the world file was unchanged after an idle stop
  • an import on a live Pelican panel
## Summary - bring the Core Keeper egg from UltraVu-Studios/core-keeper-egg into the monorepo, with fixes found by running it against the real server ## Changes - add game_eggs/core_keeper egg (PTDL_v2) and README; add row to root README - password, game ID and seed are quoted: the old unquoted -password turned "my pass" into "my" - Game ID rule is 15-28 alphanumeric characters without Y, y, x, 0, O (the old min:28 rejected IDs the game generates itself, which are 15 characters) - World Mode allows 0 Normal, 1 Hard, 2 Creative, 4 Casual (names mapped by running the server; 3 has no name) - seed is optional and the flag is omitted when empty: seed 0 is not random, it hashes to the same seed every time, so the old default gave every new server the same map - World Index goes up to 29, as the game documents - PUBLIC_IP and the -ip flag are removed: -ip is the local bind address, and a public address the host does not own made the server fail with EADDRNOTAVAIL and never start - placeholder uuid removed, meta.update_url added, console filter uses grep --line-buffered - README documents both UDP ports (game and game port + 1), data paths, the stored password and game ID in ServerConfig.json, and the stop behavior - install script kept as is: it retried once after a Missing configuration error in one run and succeeded first try in another - icon: the official Pelican Core Keeper egg ships none, so use the game key art from the Steam store listing (top square crop of library_600x900, scaled to 200x200 JPEG, 10 KB) as the top-level icon data URI ## Verification - install script in installers:debian from an empty directory: exit 0, 865 MB, server binary and both steamclient.so present - egg startup string with the egg default variable values and AUTO_UPDATE=1 in steamcmd:debian with a TTY: update check ran, Started session after 24s, UDP game and query ports bound, about 1.3 GB RAM - old startup vs new on the same server: password with a space (my vs my pass), 15-character game ID accepted, world modes 0/1/2/4 by number and name, seed 0 twice gives the same seed, empty seed gives different seeds on fresh worlds, non-local -ip fails to bind - Game ID regex checked against valid and invalid IDs - restored an existing world from a backup and it loaded (891 chunks) ## Not tested - joining from a game client, by IP or Game ID - whether a stop with ^C loses unsaved world changes; the server prints no shutdown or save lines and the world file was unchanged after an idle stop - an import on a live Pelican panel
- port the egg from UltraVu-Studios/core-keeper-egg with fixes
  found by running it against the real server
- quote password, game id and seed so values with spaces survive
- game id rule is 15-28 chars without Y y x 0 O, not 28 or more
- world mode allows 0, 1, 2 and 4 (normal, hard, creative, casual)
- seed is optional: seed 0 is not random, it hashes to the same
  seed every time, so an empty seed now omits the flag
- world index goes up to 29
- drop PUBLIC_IP: -ip is the local bind address and a public
  address the host lacks makes the server fail to bind
- remove the placeholder uuid, add update_url, line-buffer the
  console filter
- document both udp ports (game and game port + 1)
- the official pelican egg has none, so use the game's own key art
  from the steam store listing: top square crop of the 300x450
  portrait art, scaled to 200x200 jpeg (10 KB)
- stored as the top-level icon data uri, same place as the
  abiotic factor and dragonwilds eggs
ryan.mcgee deleted branch feat/core-keeper-egg 2026-11-08 07:46:22 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
UltraVu-Studios/pelican-eggs!6
No description provided.