
About this Mod
About
HexJS is a mod integrating Hexcasting and KubeJS for modpack makers and server owners.
Features
Whitelists and Blacklists
The server and each player has their own list of patterns they can cast, this list can either be a whitelist, or a blacklist. (Default is an empty blacklist)
The per-player lists are persistent, while the global list is not.
If there is a conflict, the per-player list takes priority.
Tip: Blocking the base number literal (0) for either positive or negative numbers will block all numbers of that type
Redirects
The server and each player has their own list of redirects which redirect a drawn pattern to another pattern, this is handled after the whitelists and blacklists.
Only 1 pass is done so it is easily possible to swap the effects of 2 patterns.
If there is a conflict, the per-player redirect takes priority.
Custom Patterns
This is probably what most of you are here for, the ability to make your own patterns and spells, all from inside KubeJS!
This happens in 2 parts, first you register the pattern with a name and such, and then you check if the pattern in question was the one cast in the registeredPatternCastEvent to do your logic. This can be used to override existing patterns.
Pre-Imbued Casting Items
Create cyphers, trinkets, and artifacts with pre-imbued spells and media!
This can be used for loot chests, mob drops, and more!
Force Casting
Cast any list of patterns as any player from KubeJS!
This can be used for proxies as well as making fake players from CarpetMod cast spells!
Misc
Ability to create custom ancient scrolls.
Ability to get the angle signature of Great Spells from KubeJS.
Ability to set a max length for Bookkeeper's Gambit. (Global and/or Per-Player, as per Whitelists and Blacklists)
Disclaimer
Due to most of my testing happening on Fabric, there may be a lot more bugs on the Forge version of this mod.
Please do report any bugs you find on the Github. Thank you in advance!
Available Versions
How to Install HexJS on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.19.4).
Install Mod
Open the mod browser in the dashboard and search for "HexJS". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.19.4, 1.19.3, 1.19.2
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
HexJS 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.19.4). You can switch loaders with one click in the panel.
Is HexJS compatible with fabric and forge and quilt?
HexJS officially supports fabric, forge, quilt for Minecraft 1.19.4, 1.19.3, 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 HexJS – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if HexJS 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 HexJS with just one click on your server.