[PR #168] [MERGED] kb: Rebuilding Dead Cells' core loop in libGDX, reading the game's own res.pak at runtime (Dead Cells) #177

Closed
opened 2026-10-15 20:54:02 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/168
Author: @rondeo-balos
Created: 10/8/2026
Status: ✅ Merged
Merged: 10/10/2026
Merged by: @rehan-remade

Base: main ← Head: kb/dead-cells-libgdx-rebuild-from-res-pak


📝 Commits (4)

  • bbfa0b9 kb: Rebuilding Dead Cells' core loop in libGDX, reading the game's own res.pak at runtime (Dead Cells)
  • 2a34308 kb: Dead Cells libGDX rebuild from res.pak: review fixes
  • b533107 Merge remote-tracking branch 'origin/main' into land/pr-168
  • 2ef22eb kb: regenerate the index

📊 Changes

3 files changed (+165 additions, -1 deletions)

View changed files

📝 knowledge/INDEX.md (+2 -1)
➕ knowledge/games/dead-cells/libgdx-rebuild-from-res-pak.md (+126 -0)
📝 knowledge/index.json (+37 -0)

📄 Description

What: Dead Cells (Steam macOS, build 35): a field note on a clean-room libGDX rebuild of the first biome that reads every asset from the user's own res.pak at runtime.

The note covers:

  • Formats: the PAK (Dead Cells' 64-byte stamp variant), BATL atlas, BTMX room template and CastleDB layouts, written in my own words.
  • Rendering: hero pages are palette-indexed (red = column, green×4 = row of <model>_<skin>_s.png). Mob pages are flat colour with a magenta glow key. Level tiles are black albedo, with _n normal maps and biome gradients providing the look.
  • Sound: every .wav in the pak is actually Ogg Vorbis.
  • Movement: with the documented jump numbers the hero only reaches about 3.5 cells, so some template pits need the jump-through-up and ledge-grab assists to escape.
  • Gotchas: 7 numbered ones (symptom → cause → fix), plus what was and wasn't verified.

Checklist

  • um kb check passes (field notes)
  • um kb index regenerated (field notes)
  • no game files, extracted assets, decompiled code dumps or secrets
  • nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks
  • versions, verification and what was NOT verified are written down
  • authored by (agent + model / human): Claude Code (Claude Opus 5.5) with @rondeo-balos

🤖 Generated with Claude Code


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/rehan-remade/universal-modder/pull/168 **Author:** [@rondeo-balos](https://github.com/rondeo-balos) **Created:** 10/8/2026 **Status:** ✅ Merged **Merged:** 10/10/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `kb/dead-cells-libgdx-rebuild-from-res-pak` --- ### 📝 Commits (4) - [`bbfa0b9`](https://github.com/rehan-remade/universal-modder/commit/bbfa0b9698fcba400a78c645488cf91f316cf3b5) kb: Rebuilding Dead Cells' core loop in libGDX, reading the game's own res.pak at runtime (Dead Cells) - [`2a34308`](https://github.com/rehan-remade/universal-modder/commit/2a3430805830e38bd27c376d30e7136d5a543aba) kb: Dead Cells libGDX rebuild from res.pak: review fixes - [`b533107`](https://github.com/rehan-remade/universal-modder/commit/b533107063f30611f5d72a8fbc9c3ba67d4b6bcc) Merge remote-tracking branch 'origin/main' into land/pr-168 - [`2ef22eb`](https://github.com/rehan-remade/universal-modder/commit/2ef22ebec4615a29cff5afa249738846747510a7) kb: regenerate the index ### 📊 Changes **3 files changed** (+165 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `knowledge/INDEX.md` (+2 -1) ➕ `knowledge/games/dead-cells/libgdx-rebuild-from-res-pak.md` (+126 -0) 📝 `knowledge/index.json` (+37 -0) </details> ### 📄 Description **What:** Dead Cells (Steam macOS, build 35): a field note on a clean-room libGDX rebuild of the first biome that reads every asset from the user's own `res.pak` at runtime. The note covers: - **Formats:** the PAK (Dead Cells' 64-byte stamp variant), BATL atlas, BTMX room template and CastleDB layouts, written in my own words. - **Rendering:** hero pages are palette-indexed (red = column, green×4 = row of `<model>_<skin>_s.png`). Mob pages are flat colour with a magenta glow key. Level tiles are black albedo, with `_n` normal maps and biome gradients providing the look. - **Sound:** every `.wav` in the pak is actually Ogg Vorbis. - **Movement:** with the documented jump numbers the hero only reaches about 3.5 cells, so some template pits need the jump-through-up and ledge-grab assists to escape. - **Gotchas:** 7 numbered ones (symptom → cause → fix), plus what was and wasn't verified. **Checklist** - [x] `um kb check` passes (field notes) - [x] `um kb index` regenerated (field notes) - [x] no game files, extracted assets, decompiled code dumps or secrets - [x] nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks - [x] versions, verification and what was NOT verified are written down - [x] authored by (agent + model / human): Claude Code (Claude Opus 5.5) with @rondeo-balos 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
bsakaguchi 2026-10-15 20:54:02 +00:00
Sign in to join this conversation.
No labels
pull-request
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
rehan-remade/universal-modder#177
No description provided.