-
v0.8.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 29sCI / audit (pull_request) Successful in 19sCI / stable (pull_request) Successful in 57sCI / python bindings (3.11) (pull_request) Successful in 26sCI / msrv (1.90) (push) Successful in 28sCI / audit (push) Successful in 19sCI / stable (push) Successful in 57sCI / python bindings (3.11) (push) Successful in 1m15sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m45sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 1m46sRelease / publish (push) Successful in 13sRelease / publish (npm) (push) Successful in 1m46sRelease / publish (crates.io) (push) Successful in 1m52sRelease / publish (PyPI) (push) Successful in 17sreleased this
2026-11-01 20:29:31 +01:00 | 21 commits to main since this releaseAdded
- Convert / wasm / FFI / Python —
GraphicsArchive::palettedecodes
palette_lutrecords: 16 pixel→palette values,nullpassing the
pixel through. - Convert / wasm / FFI / Python —
GraphicsArchive::headerreports
thefamily:consolearchives (Amiga, Sega CD, FM-Towns) honour
image'sstyleandlight,pcones ignore them. - Convert / wasm / FFI / Python —
GraphicsArchive::sequences: a
creature's per-command animations (DOS, Mac US) and a wall or
floor ornament's, frames one per tick, with each step's timing,
chance, sound, action, mirrors, scale and shift, and the names of
commands whose engine use is clear. - Convert / wasm / FFI / Python —
GraphicsArchive::animation
draws a sequence view as one PNG: creatures as the game draws them one
tile ahead, moved, scaled and flipped per step on a common ground
point. - Graphics —
Archive::creature_sequences,Archive::ornament_steps,
Archive::creature_ticks,Archive::creature_view_image,
Archive::ornament_view,Archive::decode_animation_png,
creature_command_name. - Graphics —
Archive::lights_images: whether images take a
LightingContext. - Convert / wasm / FFI / Python —
iconandanimationtake
image'sstyleandlight. - Convert / wasm / FFI / Python —
GraphicsArchive::text_image
draws aglyph_textorglyph_namewith a Japanese archive's font. - Convert / wasm / FFI / Python —
text_imagetakesvaluesfor
placeholders,{hero_name},{macro_15}; without one they are blank
(#477). - Graphics —
glyph_codes,Archive::glyph_sheets,find_glyph,
Archive::decode_glyphs_png: the Japanese ports' glyph sheets. - Graphics / Convert / CLI — Japanese names and texts read in
Unicode:GlyphSettables for every Japanese port, the PC-9801 demo
included,Archive::parse_text,Text::with_glyph_set(#438). Only
runes take private-use code points;text_imagemaps Unicode back to
glyph codes (#476).
Changed
- Graphics —
Archive::decode_icon_pngtakes aLightingContext. - Convert / wasm / FFI / Python / CLI — the Japanese language code
isja(ISO 639-1), wasjp.
Fixed
- Graphics — Japanese text decoded as Shift-JIS, giving mojibake: it
holds glyph codes (#438). - Graphics / Convert —
iconwith frames of different sizes wrote
an invalid APNG (first frame smaller than the canvas); every frame
now fills the canvas. - Graphics / Convert — IBM PS/V and PC-9821 record
0.0.5.0, the
packer's unobfuscated banner, listed as a text that failed to decode;
it is now abanner(Archive::is_banner, #475).
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Convert / wasm / FFI / Python —
-
v0.7.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 29sCI / audit (pull_request) Successful in 19sCI / stable (pull_request) Successful in 57sCI / python bindings (3.11) (pull_request) Successful in 26sCI / msrv (1.90) (push) Successful in 28sCI / audit (push) Successful in 20sCI / stable (push) Successful in 57sCI / python bindings (3.11) (push) Successful in 29sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 2m10sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m53sRelease / publish (push) Successful in 13sRelease / publish (npm) (push) Successful in 1m45sRelease / publish (crates.io) (push) Successful in 1m50sRelease / publish (PyPI) (push) Successful in 17sreleased this
2026-10-31 11:02:11 +01:00 | 40 commits to main since this releaseAdded
-
Magic map — unfilled maps:
Layout::unfilledleaves out solid
rock no room touches and nothing references, as the DMDC2 World Atlas
does;layout_chipsreports any layout's chips;
RenderOptions::fillanddm2 extract --no-fillfor images. -
Magic map —
Layer::objects: the records an item or creature
layer draws, a creature group's members included. -
Graphics —
Archive::creature_text: a creature type's name. -
Convert / wasm / FFI / Python —
GraphicsArchive: a
graphics.datparsed once (in wasm, copied once: about 9× faster over
every DOS image), its records addressed byindex:entries: every record with its class tuple, kind, category, size
or inline value, image size and transparency, text language;
find: a tuple's index, per language among variants;image(with console lightingstyle/light, asdm2 extract),
icon,sound(WAV),music(MIDI),font,text,palette:
one record asdm2 extractexports it; the CLI shares the sound,
music and font code;labels: the game's name for every item, champion and creature
type, in a language.item_catalog: every item kindSaveGame::create_itemaccepts;
skill_title: the inventory panel's title of a skill level.
Every method takes one options object: JS objects in wasm, JSON text
in C, keyword arguments in Python; unknown options are errors, and a
new option changes no signature. The npm build frees forgotten
handles (--weak-refs). -
Convert / wasm / FFI / Python —
DungeonFile: adungeon.dat
parsed once, withto_json,skproject_json,map_layout,
level_layout, andmap_png,level_png,map_chips,
level_chipsdrawn through aGraphicsArchive; options objects as
GraphicsArchive's;from_jsonandto_bytesfor its lossless
dump. Images and chips takefill, off leaving out unreferenced
solid rock; chips take alanguageand name item and creature layers
(name,glyph_name, groupcount). -
Convert / wasm / FFI / Python —
SaveGame: a save decoded once
against aDungeonFileand aGraphicsArchive, which it keeps, read
and edited in place, so the full dump no longer passes in and out per
edit:to_json,to_bytes,gameplay/set_gameplay,inventory,
container, the item moves, container puts and takes,create_item,
preview_itemandfield_limits; a refused edit changes nothing.
SaveGame::limitedopens a save without its files, gameplay only,
untilattachgives them. -
Saves —
SaveDump::set_gameplay: replace a dump's gameplay
section, refused unless it encodes. -
Graphics —
Archive::decode_image_ctx,
Archive::decode_image_record,Ent1::find_index,
Ent1::find_index_in_language.
Changed
- wasm — option keys are camelCase:
IconOptions.frameMs, not
frame_ms(breaking); C and Python keepframe_ms. - Dungeon / convert / CLI —
DungeonDump::reconstruct(dm2 build,
DungeonFile::from_json) rejects champion's bones (misc #0): they
exist only in saves.
Removed
- Convert / wasm / FFI / Python —
graphics_header_json,
graphics_decode_png,graphics_decode_png_transparentand
graphics_decode_icon_png(breaking):GraphicsArchive'sheader,
image(withtransparent) andiconreplace them, the image
addressed byfind(cls1, cls2, 0x01, cls4). - Convert / wasm / FFI / Python —
dungeon_to_json,
dungeon_skproject_json,dungeon_map_png,dungeon_level_png,
dungeon_map_chips_json,dungeon_level_chips_json,
dungeon_map_layout_json,dungeon_level_layout_jsonand
dungeon_from_json(breaking):DungeonFile's methods replace
them,DungeonFile::from_jsonrebuilding a dungeon from its dump. - Convert / wasm / FFI / Python —
save_to_json_full,
save_from_json_full,save_inventory_json, the
save_inventory_*edits,save_container_json,
save_container_put_json,save_container_take_json,
save_item_create_jsonandsave_item_preview_json(breaking):
SaveGame's methods replace them, champion field edits going
throughgameplay/set_gameplay;item_catalog_jsonand
skill_title_json(breaking):GraphicsArchive'sitem_catalog
andskill_titlereplace them;save_to_json,save_from_json
andsave_field_limits_json(breaking): a limitedSaveGame
replaces them.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
-
v0.6.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 29sCI / audit (pull_request) Successful in 18sCI / stable (pull_request) Successful in 55sCI / python bindings (3.11) (pull_request) Successful in 25sCI / msrv (1.90) (push) Successful in 29sCI / audit (push) Successful in 19sCI / stable (push) Successful in 55sCI / python bindings (3.11) (push) Successful in 30sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m31sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 5m13sRelease / publish (push) Successful in 14sRelease / publish (npm) (push) Successful in 1m39sRelease / publish (crates.io) (push) Successful in 1m47sRelease / publish (PyPI) (push) Successful in 16sreleased this
2026-10-30 10:10:20 +01:00 | 63 commits to main since this releaseAdded
- Graphics —
GAME_TICK_MS, the game tick length (134 ms, measured on
DOS EN). - Dungeon — accessors for bits the engine reads:
Map::use_invisible_lower_pitfall,
Map::use_message_board,Scroll::gdat_text,Creature::important,
Creature::keeps_possession_positions, and the shooter word 3
Actuator::shot_energy/shot_energy_decay,Teleporter::blocks_passage
andTeleporter::activation. - CLI —
dm2 build <json> -o <file>rebuildsdungeon.datfrom a
dump --format dungeon-losslessdump, rejecting out-of-range values. - Dungeon —
Map::num_leading_creature_typesexposesw12bits 11:8,
which no known engine code reads; the format doc records the observed pattern. - Graphics —
Archive::creature_ai_indexand the free function
creature_ai_is_static: a creature type's AI descriptor and its static flag. - Magic map — new
dm2-magicmapcrate: draws eachdungeon.datmap
as the in-game magic map does (terrain, ornaments, teleporter swirls,
creatures) from any retail port'sgraphics.dat, as PNG or looping
APNG (render_map_png). - Graphics — map chips (
cls4 = 0xf9) on Amiga, FM-Towns and Sega CD
resolve to the UI palette(0x01, 0x00, 0x09, 0x00), as in game. - CLI —
dm2 extract dungeon.dat --gdat <graphics.dat>writes
map_NN.pngbeside eachmap_NN.json;--no-creaturesleaves
creatures off,--scale Nenlarges. - Convert / wasm / FFI / Python —
dungeon_map_png(dungeonMapPng,
dm2_dungeon_map_png): one map's magic-map image. - Magic map — level images:
render_level_pngplaces a level's maps
as in game (level_layoutresolves cells several maps share);dm2 extract --gdatalso writeslevel_NN.png;dungeon_level_png
(dungeonLevelPng,dm2_dungeon_level_png) in every binding. - Graphics —
Image::to_rgb_bufferis now public. - Magic map —
Runes(MapView::with_runes) selects the creature,
reveal and items runes; items are drawn as the items rune does
(item_chips,held_item_chips,cell_chips). - Magic map — chip reports:
map_chips/level_chipsgive each
cell's owning map, tile type and layers (class tuple, frames, ticks per
frame, mirror), tagged with the rune that shows or hides them. - Convert / wasm / FFI / Python —
dungeon_map_chips_jsonand
dungeon_level_chips_json(dungeonMapChipsJson,
dungeonLevelChipsJson,dm2_dungeon_map_chips_json,
dm2_dungeon_level_chips_json): chip reports as JSON. - Magic map — layouts:
map_cells/level_cellsgive a chip
report's cells and owners fromdungeon.datalone;
dungeon_map_layout_json/dungeon_level_layout_json
(dungeonMapLayoutJson,dungeonLevelLayoutJson,
dm2_dungeon_map_layout_json,dm2_dungeon_level_layout_json) in
every binding.
Changed
- Dungeon — lossless JSON schema 3 (breaking): each map's header and
body merge into onemapsentry with decoded fields, and tiles become
tagged objects (MapEntry,TileJson). Records carry decoded fields too
(ObjectsJson); actuator word 3 is atargettaggedshotor
locatorby type and placement.
Reconstruct rejects values that overflow their bit fields, and schema 1
and 2 input. - Dungeon — the actuator catalog adds the types KKDF2 leaves blank and
the word-1 parameters it misses, from SKWINSPX's handlers
(ParamClass::PartyFacing,ParamClass::CreatureFilter,
ParamClass::Direction), including wall0x29. - Dungeon —
TileAttrfollows SKWINSPX's tile flags (breaking): walls
carry a per-siderandom_ornamentsmask, pitsopen/hidden/
imaginary, stairsnorth_south/up, doors gainnorth_south,
teleportersopen/haze, trick wallsopen/random_ornaments/
imaginary. - Dungeon — lossless JSON schema 2: the tile-data block and the
trailing checksum are rebuilt from the map bodies, so edits reload with
a valid checksum.tile_block_seedis now present only for files the
bodies do not rebuild; the storedchecksumonly when it was wrong.
Schema 1 dumps still reconstruct.
Removed
- Saves —
records::CREATURE_GIDX_ALT_TABLE(breaking); use
dm2_graphics::creature_ai_is_static.
Fixed
- Saves — animated item icons play at the game's measured 134 ms tick
(TICK_MS, nowdm2_graphics::GAME_TICK_MS), not 320 ms.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Graphics —
-
v0.5.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 30sCI / audit (pull_request) Successful in 17sCI / stable (pull_request) Successful in 51sCI / python bindings (3.11) (pull_request) Successful in 23sCI / audit (push) Successful in 19sCI / msrv (1.90) (push) Successful in 28sCI / stable (push) Successful in 51sCI / python bindings (3.11) (push) Successful in 25sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m39sRelease / publish (push) Successful in 13sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 1m58sRelease / publish (npm) (push) Successful in 1m34sRelease / publish (crates.io) (push) Successful in 1m35sRelease / publish (PyPI) (push) Successful in 18sreleased this
2026-10-27 22:38:59 +01:00 | 121 commits to main since this releaseAdded
- Graphics / wasm / FFI / Python —
graphics_decode_png_transparent
(graphicsDecodePngTransparent):graphics_decode_pngwith the
engine's transparent colour intRNS, asdm2 extract --transparent. - Saves / wasm / FFI / Python / CLI — inventory and container items
carryframes, the icons the game draws for them where they are
(inventory_view::icon_frames, afterDM2_guidraw_2405_014a), with
frame_ms.graphics_decode_icon_png(graphicsDecodeIconPng)
encodes them as one PNG, a looping APNG when animated.
save_item_preview_json(saveItemPreview) shows an item before
save_item_create_jsonmakes it.dm2 save inventory --show --gdat
lists the frames;--icons <dir>writes them as PNGs.
Changed
- Saves —
ItemNamesgainsfacing, for the compass icon. - Tooling —
cargo tandcargo t-nomusicrun the tests under an
optimisedfastprofile, the latter without the music suites. CI caches
dependency builds (Swatinem/rust-cache): about 2 min down to 73 s.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Graphics / wasm / FFI / Python —
-
v0.4.0
StableAll checks were successfulCI / audit (pull_request) Successful in 44sCI / python bindings (3.11) (pull_request) Successful in 35sCI / stable (push) Successful in 1m53sCI / python bindings (3.11) (push) Successful in 47sRelease / publish (push) Successful in 13sCI / msrv (1.90) (pull_request) Successful in 47sCI / stable (pull_request) Successful in 1m40sCI / msrv (1.90) (push) Successful in 45sCI / audit (push) Successful in 22sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 2m15sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m41sRelease / publish (crates.io) (push) Successful in 1m31sRelease / publish (npm) (push) Successful in 1m34sRelease / publish (PyPI) (push) Successful in 18sreleased this
2026-10-27 10:05:53 +01:00 | 127 commits to main since this releaseAdded
- Saves / wasm / FFI / Python — inventory and container items carry
fits, the held slots the game lets them go in
(inventory_view::fits_slot, afterIS_ITEM_FIT_FOR_EQUIP): hands and
backpack always, body slots, pouches and scabbards by the item's DBSPEC
word 4. Edits stay permissive. - Saves / wasm / FFI / Python — swap two held items:
RecordStream::swap_items(wasmsaveInventorySwap,
dm2_save_inventory_swap_json,dm2_tools.save_inventory_swap), under
the rules of a move of each, with no spare slot needed. - Saves / wasm / FFI / Python — items are created inside containers,
held or nested:saveItemCreatetakes<container>/in
under the container's rules; coins created in a money box take
charge. API:create_itemtakes anItemDestination.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Saves / wasm / FFI / Python — inventory and container items carry
-
v0.3.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 45sCI / audit (pull_request) Successful in 24sCI / stable (pull_request) Successful in 1m52sCI / python bindings (3.11) (pull_request) Successful in 44sCI / msrv (1.90) (push) Successful in 47sCI / audit (push) Successful in 23sCI / stable (push) Successful in 1m54sCI / python bindings (3.11) (push) Successful in 46sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 1m52sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m42sRelease / publish (push) Successful in 13sRelease / publish (crates.io) (push) Successful in 1m31sRelease / publish (npm) (push) Successful in 1m36sRelease / publish (PyPI) (push) Successful in 17sreleased this
2026-10-26 22:46:05 +01:00 | 132 commits to main since this releaseAdded
- wasm —
resforkListJsonandresforkExtract, at parity with FFI and
Python. - Saves / wasm / FFI / Python — containers nested in containers are
listed and edited in place:<loc>/in:<index>locations
(ContainerLocation) forsaveContainerJson,saveContainerPutand
saveContainerTake. - Saves / wasm / FFI / Python — champion field limits per save variant,
read off the encoding masks (ChampionLayout::limits, wasm
saveFieldLimitsJson): range, step and display scale (Mac stamina ×10). - Saves / Graphics / wasm / FFI / Python — skill helpers: level from
experience, the least experience for a level
(hero::skill_level,hero::experience_for_level), and the inventory
panel's skill titles (Archive::skill_title), runes included (wasm
skillLevel,skillExperienceForLevel,skillTitleJson). - Saves / Graphics / wasm — item names come with a
glyph_namegiving
rune n the private-use code point U+E000 + n
(Archive::item_glyph_name); the npm package ships a matching vector
rune font (dm2-runes.css,dm2-runes.woff2). - Saves / wasm / FFI / Python — item catalog:
item_create::item_catalog
(wasmitemCatalogJson,dm2_item_catalog_json,dm2_tools.item_catalog)
lists every kind item creation accepts, with name, icon and settable
field ranges. - Saves / wasm — inventory item fields carry a
settableflag: the
fields item creation accepts. - Saves / wasm — inventory items carry a
movableflag;falsefor
the maps move, copy and clear refuse. - FFI / Python — the wasm save editing exports: full save JSON,
inventory read / move / copy / clear, container contents / put / take
and item creation (dm2_save_*_json,dm2_tools.save_*). - Saves / wasm — item creation:
SaveFileFull::create_item/
SaveDump::create_item(wasmsaveItemCreate) put a new item, given as
a category and named fields, at an empty held location. Non-persistent
fields, out-of-range values and unknown item kinds are refused; each item
grows its type's record pool, capped at 1024. - Saves / wasm — held container contents:
RecordStream::container_contents
/put_in_container/take_from_containerand
inventory_view::container_view(wasmsaveContainerJson,
saveContainerPut,saveContainerTake), under the game's rules: 8
items per chest or bag, no nesting except money boxes, arrows only in
quivers, coins and gems only in money boxes, which give coins back one
at a time. Money box contents reportchargeas persistent and
importantas not. - Saves / wasm — inventory edits on a full dump:
RecordStream::move_item/copy_item/clear_itembetween any two
slots or the cursor, across champions (wasmsaveInventoryMove,
saveInventoryCopy,saveInventoryClear; locations parse as
ItemLocation,cursoror<hero>:<slot>). Records move verbatim, so
chests keep their contents; occupied destinations and map containers
are refused. - Graphics / saves / wasm — item names:
Archive::item_nameresolves
an item's GDAT class to the game's name;InventoryViewitems carry
name(fallback"<category> #<cls2>") andicon, the class tuple of
the base icon forgraphicsDecodePng.saveInventoryJsonnow takes
graphics.datand a language (en,de,fr,jp). - Graphics —
Text::parse_plain/parse_with_flagsand
FeatureFlags::obfuscated_text(bit0x08): the DOS 0.9 Beta stores
dtText unobfuscated, so its 664 text records now decode. - Saves / wasm — inventory read model:
InventoryView(and wasm
saveInventoryJson, from asaveToJsonFulldump) lists every champion's
30 slots, empty ones included, plus the cursor item. Each item carries its
type, subtype, a container flag and its fields, each marked persistent or
dropped on re-encode. - Saves — champion experience:
Champion::experience/
set_experiencefor the 20 skill counters (Skillorder), and
skill_levelwith the engine's level formula (item bonuses excluded:
they are not saved). The save JSON gainsskills
(name,experience,level; onlyexperienceis applied on rebuild).
Values the save cannot store (not a multiple of 32, or ≥ 2²⁹) are
rejected. - Saves — the save JSON (and so
saveToJson) now carries each champion's
seven abilities (cur/max/enhanced),herotypeandench_aura,
re-applied on rebuild like the HP/stamina/mana fields.schema_versionis
now 2; version-1 dumps no longer load. - wasm —
saveToJsonFull/saveFromJsonFulldump and rebuild a save
with its record stream decoded, given the save'sdungeon.datand
graphics.dat. A dungeon from another port or version is rejected, as is a
save whose record stream does not fully decode. Adds about 14 KB gzipped to
the wasm module. - Release —
cargo release <version>now does the mechanical half of a
release: the workspace version, every inter-crate requirement,Cargo.lock,
the Python package's version, and the changelog's heading and link-reference
surgery. It is configured not to tag, push or publish, so tagging stays the
deliberate act that triggers the workflow. Changelog entries are still
written by hand. - Release — the tag now publishes to crates.io, npm and PyPI. Three jobs
(publish-crates,publish-npm,publish-pypi) run after the Forgejo
release, each gated on it, and each skipping a version already present on
its registry so a half-failed run can be re-run. PyPI receives the same
wheels the release carries, and npm's package is built by the same
build-npm.shused locally. None of the three registries accepts a
self-hosted Forgejo as an OIDC trusted publisher, so each job carries a
scoped long-lived token from the repository secrets.
Changed
- Dependencies — base64 0.23, sha2 0.11, comfy-table 8, xmrs and
xmrsplayer 0.15; CI uses uv 0.13.5 andactions/checkoutv7.
Fixed
- Saves / wasm — bones read
<champion>BONES, the champion their
statepicks, instead of{hero_name}BONES; past the party,BONES. - Saves — a field-driven rebuild re-pads the bitstream for its new
length: an edit that grew a save, rebuilt and reloaded, then reverted no
longer leaves an extra trailing byte. - Saves — held maps are named as maps (MAGIC MAP, SCOUT MAP, MINION
MAP), not as the chest, bag or money box sharing their subtype. - Graphics —
Archive::item_namespells rune glyphs as rune names
(Ra Sar SHIELD, notvw SHIELD). - CLI —
dm2 save inventory --move/--copykeep chest contents
and class,--move x=xno longer deletes the item, and occupied
destinations and map containers are refused instead of overwritten or
desynced. - wasm —
build-npm.sh --devfailed: the script always passed
--release, which wasm-pack rejects next to another profile. It now
passes--releaseonly when no profile flag is given. The README
documents the tools wasm-pack downloads and how to build offline. - Saves — DOS Beta champions are read and written with their own
layout (ChampionLayout::DosBeta) instead of the retail one: abilities,
herotypeandench_aurapreviously hit the wrong bytes, and
herotypeedits were silently dropped. Applies to the library, the save
JSON anddm2 save champion. On Beta,enhanced_abilityisNone
(JSONnull) and setting it is an error. API:enhanced_abilityreturns
Option<u8>,set_enhanced_abilityreturnsbool, and
decode_champions_with_maskis replaced bydecode_champions_with_layout.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- wasm —
-
v0.2.1
StableAll checks were successfulCI / stable (pull_request) Successful in 1m36sCI / python bindings (3.11) (pull_request) Successful in 38sCI / msrv (1.90) (pull_request) Successful in 42sCI / audit (pull_request) Successful in 23sCI / msrv (1.90) (push) Successful in 43sCI / audit (push) Successful in 24sCI / stable (push) Successful in 1m37sCI / python bindings (3.11) (push) Successful in 39sRelease / wheel + c bundle (manylinux x86_64) (push) Successful in 1m44sRelease / build (cli + windows wheel + c bundle) (push) Successful in 2m14sRelease / publish (push) Successful in 23sreleased this
2026-09-05 08:29:21 +02:00 | 170 commits to main since this releaseAdded
- C bundles — tagged releases now attach
dm2-ffi-<ver>-x86_64-linux-gnu
and-x86_64-windows-gnuarchives, each with the cbindgen header, the shared
library, the crate README carrying theDm2Bufferownership contract, and
both licenses. The Linux one is built in the manylinux image, so it needs
only glibc 2.28. The 30-40 MB static archive is left out: it would grow the
compressed bundle elevenfold to duplicate what the shared library provides.
Changed
dm2-wasm— prepared for npm.build-npm.shbuilds the package for the
bundlertarget and publishes it under the namedm2-tools, matching the
PyPI distribution; the crate ships copies of the two licenses, which
wasm-pack bundles,build-npm.shlists infilesso npm actually packs
them, and CI diffs against the originals; andwasm-optnow optimises for
size (-Oz). CI gained awasm32-unknown-unknowncheck,
since a host build compiles the#[wasm_bindgen]layer inertly and cannot
catch a break in it.dm2-wasm— no longer published to crates.io (publish = false, and
0.2.0 deleted there). The bindings target JavaScript, which reaches them
through wasm-pack output rather than cargo, and the crates.io copy
documented nothing: docs.rs builds for x86-64, where every#[wasm_bindgen]
export is compiled out, so the page listed onlyWasmError. The crate stays
in the workspace and is built and tested exactly as before. Its unused
[workspace.dependencies]entry, which carried a version requirement no
crate consumed, is dropped.- Python bindings —
requires-pythonraised to>=3.11. 3.9 went EOL in
October 2025 and 3.10 follows in October 2026, so the old>=3.9floor
advertised runtimes that no longer get security fixes and that the suite
could not import anyway. Installing already requires a Rust toolchain to
build the cdylib, so a distro system Python was never the constraint. The
test helper now parses the manifests with the stdlibtomllibinstead of a
regex. Adds aclassifierslist so a PyPI upload carries version, platform
andTyping :: Typedtrove tags. - CI — new
pythonjob installs the bindings on a standalone CPython 3.11
(fetched by a pinned, hash-checkeduv) and runs their pytest suite, so the
declared floor and the hatchling cdylib-bundling hook are both exercised.
Previously nothing in CI touchedbindings/pythonat all. - Python bindings — the wheel is now tagged
py3-none-<platform>instead
ofcp3XX-cp3XX-<platform>. Nothing links against the CPython C API, so the
old tag demanded a separate wheel per interpreter minor for no reason; one
wheel per platform now installs on every supported Python. The build hook
also clears its_libstaging directory, which previously let a cross-built
wheel ship a second, wrong-platform library. - Python bindings — packaging metadata filled in:
[project.urls],
keywords, and the twoLICENSE-*files, which the wheel previously omitted
despite declaringLicense-Expression. - Release — tagged builds now attach Python wheels:
py3-none-manylinux_2_28_x86_64from a newwheel-linuxjob in the
manylinux image (auditwheelrelabels thelinux_x86_64tag PyPI rejects),
andpy3-none-win_amd64cross-built with mingw alongside the CLI. Wheels
only, no sdist — an sdist ofbindings/pythoncannot build, since the
cdylib it compiles lives in the cargo workspace above it. macOS and aarch64
Linux wheels are not built; seedocs/development.md. - Release — the workflow is now two build jobs feeding a
publishjob
through Forgejo'supload-artifactaction, instead of one job that built
and published in sequence. Assets are attached only once every build has
succeeded, so a failure can no longer leave a published tag missing one;
SHA256SUMS.txtcovers the wheels as well as the CLI archives; and a
workflow_dispatchrun leaves every asset downloadable from the run page.
Fixed
- Python bindings —
bindings/python/pyproject.tomlstill declared
0.1.1, so the 0.2.0 wheel carried pip metadata a version behind the
cdylib it bundles, and the suite's version assertion (hardcoded to the old
string) failed against it. The package version now tracks the workspace, and
the test derives both sides from the manifests instead of pinning a literal. - Python bindings —
tests/test_roundtrip.pyannotated a helper with a
PEP 604 union but omittedfrom __future__ import annotations, so importing
the module raisedTypeErroron the 3.9 and 3.10 thatrequires-python
claims to support. The suite only ever ran on 3.11+.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- C bundles — tagged releases now attach
-
v0.2.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 45sCI / audit (pull_request) Successful in 22sCI / stable (pull_request) Successful in 1m17sCI / audit (push) Successful in 22sCI / stable (push) Successful in 1m16sCI / msrv (1.90) (push) Successful in 46sRelease / build + release (push) Successful in 1m28sreleased this
2026-09-04 19:23:59 +02:00 | 179 commits to main since this releaseAdded
dm2-wasm— browser bindings exposing the parser crates to JavaScript
viawasm-bindgen. All parser crates already compile to
wasm32-unknown-unknownunchanged, so this is a marshalling layer rather
than a port: a purefn(&[u8]) -> Result<_, WasmError>core covered by
native tests, one unifiedWasmErrorwhoseDisplayis the JS-facing
message, and#[wasm_bindgen]passthroughs with camelCase names. Saves and
dungeons get a byte-exact self-contained JSON round-trip plus the lossy
read views; graphics, music, and FTL are read-only decoders (header summary
and image→PNG; detect, HMP→SMF, MOD→WAV,snd→WAV; FTL container info and
round-trip). Byte order is auto-detected inside the crate.dm2-convert— wasm-free crate holding the conversion functions and
their unified error, extracted out ofdm2-wasm(now a re-export plus a
wasm-bindgenshim). Adds resource-fork listing and extraction.dm2-ffi— C ABI over the parser crates: a stateless
Dm2Buffer { data, len, error }return convention with a single
dm2_buffer_free, 16 panic-guarded exports plusdm2_version, and a
committed cbindgen-generated header guarded by a drift-check test.- Python bindings (
bindings/python, pip-installabledm2-tools) —
ctypes overdm2-ffiwith a Pythonic dict/bytes API and aDm2Error
exception, a hatchling build hook that builds and bundles thedm2-ffi
cdylib into a platform-tagged wheel, and a pytest suite mirroring the ABI
round-trip and read proofs. - Savegame JSON —
dm2 dumpnow emits savegame JSON in three flavours:
gameplay-only by default (typed header, SGB, globals, champions, effects,
and timers, each with a raw escape hatch),--self-containedto embed the
full bitstream so the JSON reloads without adungeon.dat/graphics.dat,
and--full(with--gdatand--dungeon) for a field-driven dump whose
record_streamis editable. Both self-contained and field-driven dumps
reconstruct byte-identical originals, gated over all 4 DOS retail slots and
all 14 Mac retail saves. Reconstruction is hardened against hand-edited or
untrusted JSON: typed errors instead of panics, and a 16 MiB allocation cap. dm2 dump --format dungeon-lossless— self-contained lossless
dungeon.datJSON.DungeonDumpcarries every typed section as editable
fields plus the tile-data-block tail as a base64 seed, soreconstruct()
needs no external files, and parse → JSON → reconstruct is byte-exact over
every dungeon fixture in both byte orders (including the FM-Towns JP
off-by-one tail padding). Format, schema, length, and allocation guards
return typed errors instead of panicking. The lossyskprojectdump is
unchanged.serdeSerialize/Deserializederives across thedm2-saves
RecordStreamgraph and every owned section type of thedm2-dungeon
graph, so both are usable as data models outside the CLI.- Forgejo issue templates (feature / bug / research) that preset the
type/*
labels and prompt for area and port.
Changed
- Documentation: a Releasing runbook in the development guide covering the
dependency-ordered publish; the "Known DM2 ports" table moved into
docs/sources/overview.mdas a "Platform families" section; the Sega CD
in-game SFX location documented as resolved (they arecls3=0x02dtSnd
records ingraphics.dat, missed by the 6-byte DOS/Mac SFX-framing scan). - Documentation and source comments no longer reference untracked working
directories, so a fresh clone has no dangling pointers. The one
load-bearing tool that lived there,extract_mac_object_masks.py, moved
intotooling/oracle-compare/. - Corrected the documented Mac champion mask: its field bit widths are the
same as DOS (HP/MP 10-bit, stamina 14-bit, food/water 16-bit, popcount
1045), not widened/narrowed as previously claimed, and the-2shift drops
damagesuffered, notbodyflag. Three stale rows in the DOS mask table
(0x29, food, water) were fixed alongside. - Dependencies updated.
Removed
ROADMAP.md, in favour of issues and milestones on the project forge.
Per-format and per-port reference material stays indocs/.
Fixed
- A corrupt savegame is now reported with the parser's own diagnostic instead
of a generic "could not identify" / "not a recognised DM2 savegame". The
savegame family gate (thelooks_like_*header fingerprint) is now
separated from the full parse, soinfo,verify,dump,raw-extract,
and thesavesubcommands surface e.g. "sksave truncated in map_table:
need 704 bytes, got 14" for a truncated save. Matches the behaviour the
magic-bearing families (graphics.dat, FTL, Mac resource forks) already
had.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.1.1
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 42sCI / stable (pull_request) Successful in 1m1sCI / audit (pull_request) Successful in 19sCI / msrv (1.90) (push) Successful in 44sCI / stable (push) Successful in 1m1sCI / audit (push) Successful in 18sRelease / build + release (push) Successful in 1m28sreleased this
2026-07-23 14:10:31 +02:00 | 219 commits to main since this releaseFixed
- Dependency issue on internal dev crate
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.1.0
StableAll checks were successfulCI / msrv (1.90) (pull_request) Successful in 44sCI / stable (pull_request) Successful in 58sCI / audit (pull_request) Successful in 15sCI / msrv (1.90) (push) Successful in 42sCI / stable (push) Successful in 57sCI / audit (push) Successful in 15sRelease / build + release (push) Successful in 1m26sreleased this
2026-07-23 13:34:48 +02:00 | 222 commits to main since this releaseFirst public release: a Rust workspace of parsers, decoders, and a
dm2
command-line tool for the assets of Dungeon Master II: The Legend of
Skullkeep, covering the PC (DOS), Macintosh, Amiga, and Sega CD editions in
both little- and big-endian byte orders.Added
dm2CLI — inspect, extract, convert, repack, render, and edit game
assets:info— print format metadata for a single asset file.extract— unpackgraphics.dat/dungeon.datinto a directory, with
indexed-PNG transparency detection, font-sheet spacing control,
console-family lighting (--style/--light), per-language text
filtering, and additive type filters (--sfx,--music,--palette,
--font, …).dump— convert a recognised file to JSON.convert— transcode music between formats (HMP↔MIDI, …) and savegames
between DOS and Mac layouts.repack— reassemble an original install into a target engine's expected
layout.render— render music to 16-bit audio: Mac via the SoundMusicSys synth
(22254 Hz), DOS via OPL2/OPL3 (49716 Hz), Amiga via a Paula-faithful
ProTracker replayer (44100 Hz). WAV to a file, raw s16le PCM to stdout.verify— round-trip parse → emit → byte-compare to prove writer fidelity.save— read and edit savegames.
dm2-graphics— parser and writer forgraphics.dat(format 3/4/5, LE
and BE), including image, palette, font, text, and sound-effect payloads.dm2-dungeon— parser and writer fordungeon.dat(LE and BE variants).dm2-saves— parser and writer for savegame files (SkSave.dat,
sksave.bak), across DOS and Mac variants.dm2-music— decoders for DM2 music and audio: HMI/HMP (DOS), Amiga MOD,
and the Macintosh classic resource fork ('Midi'SMF,'snd 'Sound Manager
samples, plus AppleDouble v2 / MacBinary II unwrappers).mod-audio— ProTracker (Amiga MOD) rendering with Paula-faithful hard
panning.dm2-ftl— parser for the FTL 68k module container used by the Sega CD
and Amiga ports (and the DM/CSB console ports), including the zero-run
HUNK_DATAand nibble-streamHUNK_CODEdecompressors and all four
container checksums.dm2-wav— WAV writing helpers for the audio formats the game shipped.dm2-binrw— workspace-internalbinrwglue: trait-bounded
parse / write / to-bytes helpers shared by the binary parsers.dm2-test-fixtures— workspace-internal test helpers that resolve paths
againstfixtures/and skip silently when a fixture is absent.- Per-crate
examples/demonstrating minimal use of each library crate. - Engineering hygiene: CI,
cargo-denysupply-chain checks, Kaitai Struct
format specs, rustdoc pages, and fuzz targets.
Notes
- The reusable synth crates
opl-audioandsms-audiowere split out of this
workspace and are published separately on crates.io;dm2-toolsconsumes
them as external dependencies.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads