• v0.8.0 5e9a373c3f

    v0.8.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 29s
    CI / audit (pull_request) Successful in 19s
    CI / stable (pull_request) Successful in 57s
    CI / python bindings (3.11) (pull_request) Successful in 26s
    CI / msrv (1.90) (push) Successful in 28s
    CI / audit (push) Successful in 19s
    CI / stable (push) Successful in 57s
    CI / python bindings (3.11) (push) Successful in 1m15s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m45s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 1m46s
    Release / publish (push) Successful in 13s
    Release / publish (npm) (push) Successful in 1m46s
    Release / publish (crates.io) (push) Successful in 1m52s
    Release / publish (PyPI) (push) Successful in 17s
    Stable

    jqueuniet released this 2026-11-01 20:29:31 +01:00 | 21 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • Convert / wasm / FFI / Python — GraphicsArchive::palette decodes
      palette_lut records: 16 pixel→palette values, null passing the
      pixel through.
    • Convert / wasm / FFI / Python — GraphicsArchive::header reports
      the family: console archives (Amiga, Sega CD, FM-Towns) honour
      image's style and light, pc ones 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 — icon and animation take
      image's style and light.
    • Convert / wasm / FFI / Python — GraphicsArchive::text_image
      draws a glyph_text or glyph_name with a Japanese archive's font.
    • Convert / wasm / FFI / Python — text_image takes values for
      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: GlyphSet tables 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_image maps Unicode back to
      glyph codes (#476).

    Changed

    • Graphics — Archive::decode_icon_png takes a LightingContext.
    • Convert / wasm / FFI / Python / CLI — the Japanese language code
      is ja (ISO 639-1), was jp.

    Fixed

    • Graphics — Japanese text decoded as Shift-JIS, giving mojibake: it
      holds glyph codes (#438).
    • Graphics / Convert — icon with 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 a banner (Archive::is_banner, #475).
    Downloads
  • v0.7.0 4ba1dd0106

    v0.7.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 29s
    CI / audit (pull_request) Successful in 19s
    CI / stable (pull_request) Successful in 57s
    CI / python bindings (3.11) (pull_request) Successful in 26s
    CI / msrv (1.90) (push) Successful in 28s
    CI / audit (push) Successful in 20s
    CI / stable (push) Successful in 57s
    CI / python bindings (3.11) (push) Successful in 29s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 2m10s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m53s
    Release / publish (push) Successful in 13s
    Release / publish (npm) (push) Successful in 1m45s
    Release / publish (crates.io) (push) Successful in 1m50s
    Release / publish (PyPI) (push) Successful in 17s
    Stable

    jqueuniet released this 2026-10-31 11:02:11 +01:00 | 40 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • Magic map — unfilled maps: Layout::unfilled leaves out solid
      rock no room touches and nothing references, as the DMDC2 World Atlas
      does; layout_chips reports any layout's chips;
      RenderOptions::fill and dm2 extract --no-fill for 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.dat parsed once (in wasm, copied once: about 9× faster over
      every DOS image), its records addressed by index:

      • 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 lighting style / light, as dm2 extract),
        icon, sound (WAV), music (MIDI), font, text, palette:
        one record as dm2 extract exports 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 kind SaveGame::create_item accepts;
        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: a dungeon.dat
      parsed once, with to_json, skproject_json, map_layout,
      level_layout, and map_png, level_png, map_chips,
      level_chips drawn through a GraphicsArchive; options objects as
      GraphicsArchive's; from_json and to_bytes for its lossless
      dump. Images and chips take fill, off leaving out unreferenced
      solid rock; chips take a language and name item and creature layers
      (name, glyph_name, group count).

    • Convert / wasm / FFI / Python — SaveGame: a save decoded once
      against a DungeonFile and a GraphicsArchive, 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_item and field_limits; a refused edit changes nothing.
      SaveGame::limited opens a save without its files, gameplay only,
      until attach gives 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 keep frame_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_transparent and
      graphics_decode_icon_png (breaking): GraphicsArchive's header,
      image (with transparent) and icon replace them, the image
      addressed by find(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_json and
      dungeon_from_json (breaking): DungeonFile's methods replace
      them, DungeonFile::from_json rebuilding 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_json and save_item_preview_json (breaking):
      SaveGame's methods replace them, champion field edits going
      through gameplay / set_gameplay; item_catalog_json and
      skill_title_json (breaking): GraphicsArchive's item_catalog
      and skill_title replace them; save_to_json, save_from_json
      and save_field_limits_json (breaking): a limited SaveGame
      replaces them.
    Downloads
  • v0.6.0 ca5177137e

    v0.6.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 29s
    CI / audit (pull_request) Successful in 18s
    CI / stable (pull_request) Successful in 55s
    CI / python bindings (3.11) (pull_request) Successful in 25s
    CI / msrv (1.90) (push) Successful in 29s
    CI / audit (push) Successful in 19s
    CI / stable (push) Successful in 55s
    CI / python bindings (3.11) (push) Successful in 30s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m31s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 5m13s
    Release / publish (push) Successful in 14s
    Release / publish (npm) (push) Successful in 1m39s
    Release / publish (crates.io) (push) Successful in 1m47s
    Release / publish (PyPI) (push) Successful in 16s
    Stable

    jqueuniet released this 2026-10-30 10:10:20 +01:00 | 63 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • 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
      and Teleporter::activation.
    • CLI — dm2 build <json> -o <file> rebuilds dungeon.dat from a
      dump --format dungeon-lossless dump, rejecting out-of-range values.
    • Dungeon — Map::num_leading_creature_types exposes w12 bits 11:8,
      which no known engine code reads; the format doc records the observed pattern.
    • Graphics — Archive::creature_ai_index and the free function
      creature_ai_is_static: a creature type's AI descriptor and its static flag.
    • Magic map — new dm2-magicmap crate: draws each dungeon.dat map
      as the in-game magic map does (terrain, ornaments, teleporter swirls,
      creatures) from any retail port's graphics.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.png beside each map_NN.json; --no-creatures leaves
      creatures off, --scale N enlarges.
    • Convert / wasm / FFI / Python — dungeon_map_png (dungeonMapPng,
      dm2_dungeon_map_png): one map's magic-map image.
    • Magic map — level images: render_level_png places a level's maps
      as in game (level_layout resolves cells several maps share); dm2 extract --gdat also writes level_NN.png; dungeon_level_png
      (dungeonLevelPng, dm2_dungeon_level_png) in every binding.
    • Graphics — Image::to_rgb_buffer is 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_chips give 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_json and
      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_cells give a chip
      report's cells and owners from dungeon.dat alone;
      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 one maps entry with decoded fields, and tiles become
      tagged objects (MapEntry, TileJson). Records carry decoded fields too
      (ObjectsJson); actuator word 3 is a target tagged shot or
      locator by 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 wall 0x29.
    • Dungeon — TileAttr follows SKWINSPX's tile flags (breaking): walls
      carry a per-side random_ornaments mask, pits open / hidden /
      imaginary, stairs north_south / up, doors gain north_south,
      teleporters open / haze, trick walls open / 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_seed is now present only for files the
      bodies do not rebuild; the stored checksum only 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, now dm2_graphics::GAME_TICK_MS), not 320 ms.
    Downloads
  • v0.5.0 9f7d1a603e

    v0.5.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 30s
    CI / audit (pull_request) Successful in 17s
    CI / stable (pull_request) Successful in 51s
    CI / python bindings (3.11) (pull_request) Successful in 23s
    CI / audit (push) Successful in 19s
    CI / msrv (1.90) (push) Successful in 28s
    CI / stable (push) Successful in 51s
    CI / python bindings (3.11) (push) Successful in 25s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m39s
    Release / publish (push) Successful in 13s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 1m58s
    Release / publish (npm) (push) Successful in 1m34s
    Release / publish (crates.io) (push) Successful in 1m35s
    Release / publish (PyPI) (push) Successful in 18s
    Stable

    jqueuniet released this 2026-10-27 22:38:59 +01:00 | 121 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • Graphics / wasm / FFI / Python — graphics_decode_png_transparent
      (graphicsDecodePngTransparent): graphics_decode_png with the
      engine's transparent colour in tRNS, as dm2 extract --transparent.
    • Saves / wasm / FFI / Python / CLI — inventory and container items
      carry frames, the icons the game draws for them where they are
      (inventory_view::icon_frames, after DM2_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_json makes it. dm2 save inventory --show --gdat
      lists the frames; --icons <dir> writes them as PNGs.

    Changed

    • Saves — ItemNames gains facing, for the compass icon.
    • Tooling — cargo t and cargo t-nomusic run the tests under an
      optimised fast profile, the latter without the music suites. CI caches
      dependency builds (Swatinem/rust-cache): about 2 min down to 73 s.
    Downloads
  • v0.4.0 82d3dda813

    v0.4.0
    All checks were successful
    CI / audit (pull_request) Successful in 44s
    CI / python bindings (3.11) (pull_request) Successful in 35s
    CI / stable (push) Successful in 1m53s
    CI / python bindings (3.11) (push) Successful in 47s
    Release / publish (push) Successful in 13s
    CI / msrv (1.90) (pull_request) Successful in 47s
    CI / stable (pull_request) Successful in 1m40s
    CI / msrv (1.90) (push) Successful in 45s
    CI / audit (push) Successful in 22s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 2m15s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m41s
    Release / publish (crates.io) (push) Successful in 1m31s
    Release / publish (npm) (push) Successful in 1m34s
    Release / publish (PyPI) (push) Successful in 18s
    Stable

    jqueuniet released this 2026-10-27 10:05:53 +01:00 | 127 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • Saves / wasm / FFI / Python — inventory and container items carry
      fits, the held slots the game lets them go in
      (inventory_view::fits_slot, after IS_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 (wasm saveInventorySwap,
      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: saveItemCreate takes <container>/in
      under the container's rules; coins created in a money box take
      charge. API: create_item takes an ItemDestination.
    Downloads
  • v0.3.0 9f5079b4af

    v0.3.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 45s
    CI / audit (pull_request) Successful in 24s
    CI / stable (pull_request) Successful in 1m52s
    CI / python bindings (3.11) (pull_request) Successful in 44s
    CI / msrv (1.90) (push) Successful in 47s
    CI / audit (push) Successful in 23s
    CI / stable (push) Successful in 1m54s
    CI / python bindings (3.11) (push) Successful in 46s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 1m52s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m42s
    Release / publish (push) Successful in 13s
    Release / publish (crates.io) (push) Successful in 1m31s
    Release / publish (npm) (push) Successful in 1m36s
    Release / publish (PyPI) (push) Successful in 17s
    Stable

    jqueuniet released this 2026-10-26 22:46:05 +01:00 | 132 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • wasm — resforkListJson and resforkExtract, 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) for saveContainerJson, saveContainerPut and
      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_name giving
      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
      (wasm itemCatalogJson, 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 settable flag: the
      fields item creation accepts.
    • Saves / wasm — inventory items carry a movable flag; false for
      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 (wasm saveItemCreate) 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_container and
      inventory_view::container_view (wasm saveContainerJson,
      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 report charge as persistent and
      important as not.
    • Saves / wasm — inventory edits on a full dump:
      RecordStream::move_item / copy_item / clear_item between any two
      slots or the cursor, across champions (wasm saveInventoryMove,
      saveInventoryCopy, saveInventoryClear; locations parse as
      ItemLocation, cursor or <hero>:<slot>). Records move verbatim, so
      chests keep their contents; occupied destinations and map containers
      are refused.
    • Graphics / saves / wasm — item names: Archive::item_name resolves
      an item's GDAT class to the game's name; InventoryView items carry
      name (fallback "<category> #<cls2>") and icon, the class tuple of
      the base icon for graphicsDecodePng. saveInventoryJson now takes
      graphics.dat and a language (en, de, fr, jp).
    • Graphics — Text::parse_plain / parse_with_flags and
      FeatureFlags::obfuscated_text (bit 0x08): 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 a saveToJsonFull dump) 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_experience for the 20 skill counters (Skill order), and
      skill_level with the engine's level formula (item bonuses excluded:
      they are not saved). The save JSON gains skills
      (name, experience, level; only experience is 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), herotype and ench_aura,
      re-applied on rebuild like the HP/stamina/mana fields. schema_version is
      now 2; version-1 dumps no longer load.
    • wasm — saveToJsonFull / saveFromJsonFull dump and rebuild a save
      with its record stream decoded, given the save's dungeon.dat and
      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.sh used 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 and actions/checkout v7.

    Fixed

    • Saves / wasm — bones read <champion>BONES, the champion their
      state picks, 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_name spells rune glyphs as rune names
      (Ra Sar SHIELD, not vw SHIELD).
    • CLI — dm2 save inventory --move / --copy keep chest contents
      and class, --move x=x no longer deletes the item, and occupied
      destinations and map containers are refused instead of overwritten or
      desynced.
    • wasm — build-npm.sh --dev failed: the script always passed
      --release, which wasm-pack rejects next to another profile. It now
      passes --release only 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,
      herotype and ench_aura previously hit the wrong bytes, and
      herotype edits were silently dropped. Applies to the library, the save
      JSON and dm2 save champion. On Beta, enhanced_ability is None
      (JSON null) and setting it is an error. API: enhanced_ability returns
      Option<u8>, set_enhanced_ability returns bool, and
      decode_champions_with_mask is replaced by decode_champions_with_layout.
    Downloads
  • v0.2.1 9ed7aebfbb

    v0.2.1
    All checks were successful
    CI / stable (pull_request) Successful in 1m36s
    CI / python bindings (3.11) (pull_request) Successful in 38s
    CI / msrv (1.90) (pull_request) Successful in 42s
    CI / audit (pull_request) Successful in 23s
    CI / msrv (1.90) (push) Successful in 43s
    CI / audit (push) Successful in 24s
    CI / stable (push) Successful in 1m37s
    CI / python bindings (3.11) (push) Successful in 39s
    Release / wheel + c bundle (manylinux x86_64) (push) Successful in 1m44s
    Release / build (cli + windows wheel + c bundle) (push) Successful in 2m14s
    Release / publish (push) Successful in 23s
    Stable

    jqueuniet released this 2026-09-05 08:29:21 +02:00 | 170 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • C bundles — tagged releases now attach dm2-ffi-<ver>-x86_64-linux-gnu
      and -x86_64-windows-gnu archives, each with the cbindgen header, the shared
      library, the crate README carrying the Dm2Buffer ownership 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.sh builds the package for the
      bundler target and publishes it under the name dm2-tools, matching the
      PyPI distribution; the crate ships copies of the two licenses, which
      wasm-pack bundles, build-npm.sh lists in files so npm actually packs
      them, and CI diffs against the originals; and wasm-opt now optimises for
      size (-Oz). CI gained a wasm32-unknown-unknown check,
      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 only WasmError. 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-python raised to >=3.11. 3.9 went EOL in
      October 2025 and 3.10 follows in October 2026, so the old >=3.9 floor
      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 stdlib tomllib instead of a
      regex. Adds a classifiers list so a PyPI upload carries version, platform
      and Typing :: Typed trove tags.
    • CI — new python job installs the bindings on a standalone CPython 3.11
      (fetched by a pinned, hash-checked uv) and runs their pytest suite, so the
      declared floor and the hatchling cdylib-bundling hook are both exercised.
      Previously nothing in CI touched bindings/python at all.
    • Python bindings — the wheel is now tagged py3-none-<platform> instead
      of cp3XX-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 _lib staging 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 two LICENSE-* files, which the wheel previously omitted
      despite declaring License-Expression.
    • Release — tagged builds now attach Python wheels:
      py3-none-manylinux_2_28_x86_64 from a new wheel-linux job in the
      manylinux image (auditwheel relabels the linux_x86_64 tag PyPI rejects),
      and py3-none-win_amd64 cross-built with mingw alongside the CLI. Wheels
      only, no sdist — an sdist of bindings/python cannot build, since the
      cdylib it compiles lives in the cargo workspace above it. macOS and aarch64
      Linux wheels are not built; see docs/development.md.
    • Release — the workflow is now two build jobs feeding a publish job
      through Forgejo's upload-artifact action, 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.txt covers the wheels as well as the CLI archives; and a
      workflow_dispatch run leaves every asset downloadable from the run page.

    Fixed

    • Python bindings — bindings/python/pyproject.toml still 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.py annotated a helper with a
      PEP 604 union but omitted from __future__ import annotations, so importing
      the module raised TypeError on the 3.9 and 3.10 that requires-python
      claims to support. The suite only ever ran on 3.11+.
    Downloads
  • v0.2.0 810bc844f4

    v0.2.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 45s
    CI / audit (pull_request) Successful in 22s
    CI / stable (pull_request) Successful in 1m17s
    CI / audit (push) Successful in 22s
    CI / stable (push) Successful in 1m16s
    CI / msrv (1.90) (push) Successful in 46s
    Release / build + release (push) Successful in 1m28s
    Stable

    jqueuniet released this 2026-09-04 19:23:59 +02:00 | 179 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Added

    • dm2-wasm — browser bindings exposing the parser crates to JavaScript
      via wasm-bindgen. All parser crates already compile to
      wasm32-unknown-unknown unchanged, so this is a marshalling layer rather
      than a port: a pure fn(&[u8]) -> Result<_, WasmError> core covered by
      native tests, one unified WasmError whose Display is 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 of dm2-wasm (now a re-export plus a
      wasm-bindgen shim). 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 plus dm2_version, and a
      committed cbindgen-generated header guarded by a drift-check test.
    • Python bindings (bindings/python, pip-installable dm2-tools) —
      ctypes over dm2-ffi with a Pythonic dict/bytes API and a Dm2Error
      exception, a hatchling build hook that builds and bundles the dm2-ffi
      cdylib into a platform-tagged wheel, and a pytest suite mirroring the ABI
      round-trip and read proofs.
    • Savegame JSON — dm2 dump now 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-contained to embed the
      full bitstream so the JSON reloads without a dungeon.dat / graphics.dat,
      and --full (with --gdat and --dungeon) for a field-driven dump whose
      record_stream is 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.dat JSON. DungeonDump carries every typed section as editable
      fields plus the tile-data-block tail as a base64 seed, so reconstruct()
      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 lossy skproject dump is
      unchanged.
    • serde Serialize/Deserialize derives across the dm2-saves
      RecordStream graph and every owned section type of the dm2-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.md as a "Platform families" section; the Sega CD
      in-game SFX location documented as resolved (they are cls3=0x02 dtSnd
      records in graphics.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
      into tooling/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 -2 shift drops
      damagesuffered, not bodyflag. 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 in docs/.

    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 (the looks_like_* header fingerprint) is now
      separated from the full parse, so info, verify, dump, raw-extract,
      and the save subcommands 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
  • v0.1.1 486b3f8566

    v0.1.1
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 42s
    CI / stable (pull_request) Successful in 1m1s
    CI / audit (pull_request) Successful in 19s
    CI / msrv (1.90) (push) Successful in 44s
    CI / stable (push) Successful in 1m1s
    CI / audit (push) Successful in 18s
    Release / build + release (push) Successful in 1m28s
    Stable

    jqueuniet released this 2026-07-23 14:10:31 +02:00 | 219 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    Fixed

    • Dependency issue on internal dev crate
    Downloads
  • v0.1.0 7a82edbc6a

    v0.1.0
    All checks were successful
    CI / msrv (1.90) (pull_request) Successful in 44s
    CI / stable (pull_request) Successful in 58s
    CI / audit (pull_request) Successful in 15s
    CI / msrv (1.90) (push) Successful in 42s
    CI / stable (push) Successful in 57s
    CI / audit (push) Successful in 15s
    Release / build + release (push) Successful in 1m26s
    Stable

    jqueuniet released this 2026-07-23 13:34:48 +02:00 | 222 commits to main since this release

    Signed by jqueuniet
    SSH key fingerprint: SHA256:hjUxou9yR5AKBQ8zK2FkTEp12iDlEomvb63VBpXVwN4

    First 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

    • dm2 CLI — inspect, extract, convert, repack, render, and edit game
      assets:
      • info — print format metadata for a single asset file.
      • extract — unpack graphics.dat / dungeon.dat into 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 for graphics.dat (format 3/4/5, LE
      and BE), including image, palette, font, text, and sound-effect payloads.
    • dm2-dungeon — parser and writer for dungeon.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_DATA and nibble-stream HUNK_CODE decompressors and all four
      container checksums.
    • dm2-wav — WAV writing helpers for the audio formats the game shipped.
    • dm2-binrw — workspace-internal binrw glue: trait-bounded
      parse / write / to-bytes helpers shared by the binary parsers.
    • dm2-test-fixtures — workspace-internal test helpers that resolve paths
      against fixtures/ and skip silently when a fixture is absent.
    • Per-crate examples/ demonstrating minimal use of each library crate.
    • Engineering hygiene: CI, cargo-deny supply-chain checks, Kaitai Struct
      format specs, rustdoc pages, and fuzz targets.

    Notes

    • The reusable synth crates opl-audio and sms-audio were split out of this
      workspace and are published separately on crates.io; dm2-tools consumes
      them as external dependencies.
    Downloads