All Mods Resource Packs Data Packs Shaders Modpacks Plugins
HexDebug
Projects / Mods

HexDebug

by object-Object • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

HexDebug

CurseForge | GitHub

A Hex Casting addon for debugging and editing hexes. The Debugger runs a debug server using the Debug Adapter Protocol, allowing you to use real debugging tools like VSCode to find bugs in your hexes; and the Splicing Table provides an easy-to-use GUI for finding and fixing mistakes.

Features

  • Debugging: Step through your hexes pattern-by-pattern with vscode-hex-casting or any other DAP-compatible editor!
  • Editing: Use the Splicing Table to edit hexes just like in a text editor, with buttons and keyboard shortcuts to select, move, duplicate, delete, and copy/paste iotas, and even draw patterns in a mini staff grid.
  • Step Modes: Use any of the well-known step modes (step in/out/over, continue, restart, stop) with the ingame item and/or through VSCode.
  • Variables: See the stack, ravenmind, and even some internal values like the evaluated pattern count.
  • Call Stack: Debug complex meta-evaluating hexes with the call stack, generated from the next continuation to be executed. Learn how Hex Casting's internals work!
  • Breakpoints: Set breakpoints on specific patterns, or use the Uncaught Mishaps option to pause the debugger when a mishap occurs and see what went wrong.
  • Multiplayer: Debug your hexes in multiplayer! The debug client connects to a port opened by the game client (configurable, defaults to 4444), and each player can have up to one active debugger instance at a time.

Attribution


A badge for hexdoc in the style of Devins Badges

How to Install HexDebug (Mod)

HexDebug by object-Object is verified for Fabric, Forge, Quilt across Minecraft versions 1.19.2, 1.20.1 (latest release: 0.9.1+1.20.1, file size: 3.1 MB). Follow the steps below to install it safely from ModCraft.tv:

  1. Click the Download button above and select your Minecraft version (1.19.2, 1.20.1) and platform (Fabric, Forge, Quilt).
  2. Make sure you have the compatible loader or environment installed for Fabric, Forge, Quilt.
  3. Move the downloaded HexDebug file into your Minecraft .minecraft/mods folder and launch the game.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.20.1
Forge
4d ago 1
1.20.1
Fabric Quilt
4d ago 1
1.20.1
Fabric Quilt
2mo ago 1
1.20.1
Forge
2mo ago 1
1.20.1
Fabric Quilt
4mo ago 1
1.20.1
Forge
4mo ago 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.19.2
Fabric Quilt
last yr. 1
1.19.2
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.19.2
Fabric Quilt
last yr. 1
1.19.2
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.19.2
Fabric Quilt
last yr. 1
1.19.2
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.19.2
Forge
last yr. 1
1.19.2
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
1.20.1
Forge
last yr. 1
1.20.1
Fabric Quilt
last yr. 1
[0.9.1+1.20.1] v0.9.1+1.20.1 [Forge] by object-Object on Oct 25, 2026
Download
## 0.9.1+1.20.1 - 2026-10-25

### Added

  • Added support for other addons to override the iotas that are loaded from slates when debugging spell circles.

### Changed

  • When debugging spell circles, the active slate now continuously produces particles.
  • Updated translations from Weblate.

### Fixed

  • Fixed a bug where slates would fail to execute more than once when debugging a spell circle with loops.
## 0.9.1+1.20.1 - 2026-10-25

### Added

  • Added support for other addons to override the iotas that are loaded from slates when debugging spell circles.

### Changed

  • When debugging spell circles, the active slate now continuously produces particles.
  • Updated translations from Weblate.

### Fixed

  • Fixed a bug where slates would fail to execute more than once when debugging a spell circle with loops.
## 0.9.0+1.20.1 - 2026-09-05

### Changed

  • Updated to Hex Casting 0.11.4.
  • Updated the minimum IoticBlocks version to 1.0.2.
  • Documented the ability to debug spell circles.
[0.9.0+1.20.1] v0.9.0+1.20.1 [Forge] by object-Object on Sep 05, 2026
Download
## 0.9.0+1.20.1 - 2026-09-05

### Changed

  • Updated to Hex Casting 0.11.4.
  • Updated the minimum IoticBlocks version to 1.0.2.
  • Documented the ability to debug spell circles.
## 0.8.1+1.20.1 - 2026-07-08

### Changed

  • Updated the minimum Kotlin version to 2.2.21.

### Fixed

  • Updated the bundled version of Ktor to 3.3.3 to fix an incompatibility with Kotlin 2.4.0 that caused VSCode to fail to connect to HexDebug's debug server.
[0.8.1+1.20.1] v0.8.1+1.20.1 [Forge] by object-Object on Jul 08, 2026
Download
## 0.8.1+1.20.1 - 2026-07-08

### Changed

  • Updated the minimum Kotlin version to 2.2.21.

### Fixed

  • Updated the bundled version of Ktor to 3.3.3 to fix an incompatibility with Kotlin 2.4.0 that caused VSCode to fail to connect to HexDebug's debug server.
[0.8.0+1.20.1] v0.8.0+1.20.1 [Forge] by object-Object on Nov 07, 2025
Download
## 0.8.0+1.20.1 - 2025-11-07

### Added

  • Added support for debugging spell circles! Right-click (or sneak-right-click, for toolsmiths) on an impetus with a Debugger to start a debug session.
  • New items: Quenched Debugger and Quenched Evaluator! These post-enlightenment debug tools allow up to 4 hexes to be debugged at once. Scroll while holding sneak and sprint in order to switch between the available "debug thread" slots.
  • API: Added API documentation to the web book! The API docs from the latest commit pushed to main are available [here](https://hexdebug.hexxy.media/v/latest/main/api/), and there is a link to the API docs for each version in the header of the corresponding web book.
  • API: Added support for implementing debug support in casting devices/environments other than the Debugger item (eg. circles, wisps, cassettes). See the API documentation for more details, especially the sequence diagrams in the hexdebug-core-common module.
  • API: Added a new mini-mod called HexDebug Core (hexdebug-core-*). This is a minimal, Java-only mod containing only the API classes required to implement debug support. The intention is for HexDebug Core to be included in other addons via Jar-in-Jar, allowing addons to implement optional debugging support in their casting environments while minimizing the amount of overhead and added complexity from checking whether HexDebug is loaded or not.
  • API: Added Mojmap-remapped common jars (hexdebug-common-mojmap and hexdebug-core-common-mojmap) for use in VanillaGradle-based xplat projects.

### Changed

  • Update zh_cn translations, by ChuijkYahus in [#60](https://github.com/object-Object/HexDebug/pull/60) and [#63](https://github.com/object-Object/HexDebug/pull/63).
  • Source files can now be viewed after the hex that created them finishes debugging.
  • Removed the random prefix from source filenames.
  • Active debug sessions are now terminated on death.
  • API: The SplicingTableIotaRenderer tooltip is now stored in a field on the renderer, allowing it to be updated in render if HexDebug isn't updating it frequently enough for your use case.

### Fixed

## 0.8.0+1.20.1 - 2025-11-07

### Added

  • Added support for debugging spell circles! Right-click (or sneak-right-click, for toolsmiths) on an impetus with a Debugger to start a debug session.
  • New items: Quenched Debugger and Quenched Evaluator! These post-enlightenment debug tools allow up to 4 hexes to be debugged at once. Scroll while holding sneak and sprint in order to switch between the available "debug thread" slots.
  • API: Added API documentation to the web book! The API docs from the latest commit pushed to main are available [here](https://hexdebug.hexxy.media/v/latest/main/api/), and there is a link to the API docs for each version in the header of the corresponding web book.
  • API: Added support for implementing debug support in casting devices/environments other than the Debugger item (eg. circles, wisps, cassettes). See the API documentation for more details, especially the sequence diagrams in the hexdebug-core-common module.
  • API: Added a new mini-mod called HexDebug Core (hexdebug-core-*). This is a minimal, Java-only mod containing only the API classes required to implement debug support. The intention is for HexDebug Core to be included in other addons via Jar-in-Jar, allowing addons to implement optional debugging support in their casting environments while minimizing the amount of overhead and added complexity from checking whether HexDebug is loaded or not.
  • API: Added Mojmap-remapped common jars (hexdebug-common-mojmap and hexdebug-core-common-mojmap) for use in VanillaGradle-based xplat projects.

### Changed

  • Update zh_cn translations, by ChuijkYahus in [#60](https://github.com/object-Object/HexDebug/pull/60) and [#63](https://github.com/object-Object/HexDebug/pull/63).
  • Source files can now be viewed after the hex that created them finishes debugging.
  • Removed the random prefix from source filenames.
  • Active debug sessions are now terminated on death.
  • API: The SplicingTableIotaRenderer tooltip is now stored in a field on the renderer, allowing it to be updated in render if HexDebug isn't updating it frequently enough for your use case.

### Fixed

[0.7.0+1.20.1] v0.7.0+1.20.1 [Forge] by object-Object on Oct 03, 2025
Download
## 0.7.0+1.20.1 - 2025-10-02

### Added

  • Added a tag (hexdebug:focus_holder/blacklist) to prevent specific items from being inserted into the Focal Frame.
  • Added new methods to the SplicingTableIotaRenderers class to allow iota renderers to contain or reference other renderers.
  • New Splicing Table iota renderer types:
  • hexdebug:conditional/if_path_exists
  • hexdebug:layers
  • hexdebug:sub_iota
  • New built-in iota icons:
  • hexdebug:builtin/wide/list
  • hexdebug:builtin/wide/type

### Changed

  • ⚠️ Breaking: The hexdebug:list renderer type now has a required field renderer to render the iota; the list renderer now only provides the tooltip.
  • ⚠️ Breaking: Changed all Splicing Table iota renderer JSON fields from camelCase to snake_case.
  • List iotas now render their first iota (if any) in the Splicing Table ([#48](https://github.com/object-Object/HexDebug/issues/48)).
  • MoreIotas' item type iotas now render brackets around the item to distinguish them from item stack iotas.
  • Added (official) support for inserting iota-holding items other than foci into the Focal Frame ([#52](https://github.com/object-Object/HexDebug/issues/52)).
  • A single Focal Frame item can now be used like a bundle to insert/remove items in your inventory ([#49](https://github.com/object-Object/HexDebug/issues/49)).
  • The Focal Frame now gives comparator output and can be broken by pushing it with a piston.
  • Splicing Table iota renderers are now cached to improve performance.
  • Projectionist's Purification, Projectionist's Gambit, and Shutter's Purification (but not the II variants) now work on Focal Frames in addition to Splicing Tables.

### Fixed


### Removed

  • Removed most recipes related to filling/emptying Focal Frames, other than the recipe to fill empty frames with new foci using stackable ingredients.
## 0.7.0+1.20.1 - 2025-10-02

### Added

  • Added a tag (hexdebug:focus_holder/blacklist) to prevent specific items from being inserted into the Focal Frame.
  • Added new methods to the SplicingTableIotaRenderers class to allow iota renderers to contain or reference other renderers.
  • New Splicing Table iota renderer types:
  • hexdebug:conditional/if_path_exists
  • hexdebug:layers
  • hexdebug:sub_iota
  • New built-in iota icons:
  • hexdebug:builtin/wide/list
  • hexdebug:builtin/wide/type

### Changed

  • ⚠️ Breaking: The hexdebug:list renderer type now has a required field renderer to render the iota; the list renderer now only provides the tooltip.
  • ⚠️ Breaking: Changed all Splicing Table iota renderer JSON fields from camelCase to snake_case.
  • List iotas now render their first iota (if any) in the Splicing Table ([#48](https://github.com/object-Object/HexDebug/issues/48)).
  • MoreIotas' item type iotas now render brackets around the item to distinguish them from item stack iotas.
  • Added (official) support for inserting iota-holding items other than foci into the Focal Frame ([#52](https://github.com/object-Object/HexDebug/issues/52)).
  • A single Focal Frame item can now be used like a bundle to insert/remove items in your inventory ([#49](https://github.com/object-Object/HexDebug/issues/49)).
  • The Focal Frame now gives comparator output and can be broken by pushing it with a piston.
  • Splicing Table iota renderers are now cached to improve performance.
  • Projectionist's Purification, Projectionist's Gambit, and Shutter's Purification (but not the II variants) now work on Focal Frames in addition to Splicing Tables.

### Fixed


### Removed

  • Removed most recipes related to filling/emptying Focal Frames, other than the recipe to fill empty frames with new foci using stackable ingredients.
## 0.6.0+1.20.1 - 2025-09-29

### Added

  • Added a new resource-pack-based data-driven system for addon devs to customize how their iotas are rendered in the Splicing Table. ([Docs](https://github.com/object-Object/HexDebug/wiki/Splicing-Table-Iota-Rendering))
  • Added Hexical interop to make the telepathy and notebook keys work in the Splicing/Mindsplice Table GUI.
  • Added support for "rainbow brackets" (also known as bracket pair colorization) to the Splicing Table. Introspection and Retrospection are now tinted rainbow colors based on their depth. The list of colors is configurable in HexDebug's client settings, and there's also an option to disable the feature entirely.
  • Added a config option to disable showing pattern names in embedded lists.

### Changed

  • ⚠️ Rearranged the client config. In particular, the invertSplicingTableScrollDirection option has been moved to splicingTable.invertScrollDirection, so you'll have to set this option again after updating if you've changed it from the default.
  • Updated zh_cn translations, by ChuijkYahus in [#43](https://github.com/object-Object/HexDebug/pull/43)
  • The Mindsplice Table casting button tooltip now includes the block's name (eg. from renaming it in an anvil).
  • Item Type and Item Stack iotas from MoreIotas now render as the item they represent in the Splicing Table.

### Fixed

[0.6.0+1.20.1] v0.6.0+1.20.1 [Forge] by object-Object on Sep 30, 2025
Download
## 0.6.0+1.20.1 - 2025-09-29

### Added

  • Added a new resource-pack-based data-driven system for addon devs to customize how their iotas are rendered in the Splicing Table. ([Docs](https://github.com/object-Object/HexDebug/wiki/Splicing-Table-Iota-Rendering))
  • Added Hexical interop to make the telepathy and notebook keys work in the Splicing/Mindsplice Table GUI.
  • Added support for "rainbow brackets" (also known as bracket pair colorization) to the Splicing Table. Introspection and Retrospection are now tinted rainbow colors based on their depth. The list of colors is configurable in HexDebug's client settings, and there's also an option to disable the feature entirely.
  • Added a config option to disable showing pattern names in embedded lists.

### Changed

  • ⚠️ Rearranged the client config. In particular, the invertSplicingTableScrollDirection option has been moved to splicingTable.invertScrollDirection, so you'll have to set this option again after updating if you've changed it from the default.
  • Updated zh_cn translations, by ChuijkYahus in [#43](https://github.com/object-Object/HexDebug/pull/43)
  • The Mindsplice Table casting button tooltip now includes the block's name (eg. from renaming it in an anvil).
  • Item Type and Item Stack iotas from MoreIotas now render as the item they represent in the Splicing Table.

### Fixed

## 0.5.0+1.20.1 - 2025-09-22

### Added

  • Added keyboard shortcuts for almost all of the buttons in the Splicing Table, configurable in HexDebug's client config menu.
  • Added several new keyboard-only actions to the Splicing Table, mostly related to manipulating the active selection:
  • Move Cursor Left/Right
  • Expand Selection Left/Right
  • Move Selection Left/Right
  • Backspace
  • Added a tag (hexdebug:splicing_table/media_blacklist) to prevent specific items from being used to refill the Splicing Table's media buffer (eg. [Oneironaut](https://oneironaut.hexxy.media)'s Inexhaustible Phial).

### Changed


### Fixed

[0.5.0+1.20.1] v0.5.0+1.20.1 [Forge] by object-Object on Sep 22, 2025
Download
## 0.5.0+1.20.1 - 2025-09-22

### Added

  • Added keyboard shortcuts for almost all of the buttons in the Splicing Table, configurable in HexDebug's client config menu.
  • Added several new keyboard-only actions to the Splicing Table, mostly related to manipulating the active selection:
  • Move Cursor Left/Right
  • Expand Selection Left/Right
  • Move Selection Left/Right
  • Backspace
  • Added a tag (hexdebug:splicing_table/media_blacklist) to prevent specific items from being used to refill the Splicing Table's media buffer (eg. [Oneironaut](https://oneironaut.hexxy.media)'s Inexhaustible Phial).

### Changed


### Fixed

## 0.4.0+1.20.1 - 2025-09-21

### Added

  • New blocks:
  • Mindsplice Table: An upgraded variant of the Splicing Table, adding a GUI button to cast a hex imbued into the table (suggested by cc-aaron in [#34](https://github.com/object-Object/HexDebug/pull/34)).
  • Focal Frame: A cheap and lag-friendly way to store and manipulate iotas in the world. (This used to be an undocumented block called the Focus Holder, but now it's craftable and has a better name.)
  • Added support for manipulating the main item in the Splicing Table via [IoticBlocks](https://ioticblocks.hexxy.media).
  • Added several new patterns for manipulating various aspects of the Splicing Table.
  • Added several new config options related to the Splicing Table.

### Changed


### Fixed

  • Added [EMI](https://modrinth.com/mod/emi) interop to fix an issue where EMI's item index would render on top of the Splicing Table GUI.
  • Fixed an issue where the casting grid ambience sound would sometimes play for a fraction of a second when opening the Splicing Table.
  • Fixed Splicing Table buttons that require media still being clickable when the table is out of media.
  • Added missing localizations for a few config options.

🌟 Related Projects

Similar modifications and resources you might like

View all →
woodwalkers
w

woodwalkers

by ToCraft

Transform into a mob!

650
mod
Geckolib
G

Geckolib

by Gecko

A 3D animation library for entities, blocks, items, armor, and more!

620
mod
Joban Client Mod
J

Joban Client Mod

by AmberFrost

Railway Facilities addon and Enhancement mod for the Minecraft Transit Railway (MTR) Mod

470
mod
Building Wands
B

Building Wands

by nicguzzo

Building wands with different modes

179
mod
HexDebug Icon
Download HexDebug
Select game version
Select platform