HexDebug

HexDebug

A Hex Casting addon for debugging and editing hexes.

by
23.2K Downloads
fabricforgequiltmagicutility
Rent Server with this Mod

Screenshots

Debugging with VSCode
Editing hexes with the Splicing Table
Starting a debug session

About this Mod

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 A badge for addons.hexxy.media in the style of Devins Badges

Available Versions

v0.8.0+1.20.1 [Forge]beta
MC 1.20.1forge
November 7, 2025
v0.8.0+1.20.1 [Fabric, Quilt]beta
MC 1.20.1fabric, quilt
November 7, 2025
v0.7.0+1.20.1 [Forge]beta
MC 1.20.1forge
October 3, 2025
v0.7.0+1.20.1 [Fabric, Quilt]beta
MC 1.20.1fabric, quilt
October 3, 2025
v0.6.0+1.20.1 [Fabric, Quilt]beta
MC 1.20.1fabric, quilt
September 30, 2025

How to Install HexDebug on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.1).

3

Install Mod

Open the mod browser in the dashboard and search for "HexDebug". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforgequilt

Minecraft Versions

1.20.1, 1.19.2

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

HexDebug server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.

Is HexDebug compatible with fabric and forge and quilt?

HexDebug officially supports fabric, forge, quilt for Minecraft 1.20.1, 1.19.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with HexDebug – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if HexDebug consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install HexDebug with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.20.11.19.2