Current public guidanceVerified 2026-09-02

Release metadata from the Hexis dashboard is authoritative for installation and Lua bundle availability.

Install Hexis

Hexis is a Fabric mod. Use Prism Launcher: it installs Fabric and Fabric API for you, so the whole setup is a download, three clicks, and a sign-in. The official launcher works too; see the end of this page.

1. Download the loader

Open the Hexis dashboard and press Download Hexis in the sidebar. It needs an active license and saves one .jar file. Note the Minecraft version printed under the button; every version choice below follows from it. Do not rely on version numbers copied from an older guide.

2. Create a Fabric instance in Prism

1. Press Add Instance.
2. Type a name, pick the Minecraft version from step 1, and under Mod loader choose Fabric. Keep the suggested loader version.
3. Press OK. Prism downloads Minecraft, Fabric, and a matching Java.

3. Add the mods

1. Select the instance and press Edit, then open the Mods page.
2. Press Download mods, search for Fabric API, select it, and press Review and confirm. Prism picks the release for your Minecraft version.
3. Press Add file and choose the Hexis .jar from step 1.

Both mods now show in the list with a tick beside them.

4. Launch and sign in

Press Launch. On the first start Hexis opens a browser window to link the game to your dashboard account. Once linked, the loader fetches the current Hexis module for your license and finishes loading.

The Minecraft account Prism launches with must be one of the accounts on your dashboard, under Minecraft accounts on the Home page.

5. Open Hexis

Press H in a world to open the Hexis menu. Change the key under Settings in that menu.

caution

Download Hexis only from your dashboard. Do not share your license, activation data, private configuration, or authenticated download URL.

Official launcher instead

1. Run the Fabric installer, choose the Minecraft version from step 1, and press Install. A "fabric-loader" profile appears in the launcher.
2. Download Fabric API for that Minecraft version.
3. Put the Fabric API .jar and the Hexis .jar in the mods folder: %APPDATA%\.minecraft\mods on Windows, ~/Library/Application Support/minecraft/mods on macOS, ~/.minecraft/mods on Linux.
4. Launch the "fabric-loader" profile and continue from step 4 above.

Something failed

• The game says the mod needs another Minecraft version: the instance does not match step 1. Make a new instance for the printed version.
• Hexis is missing from the mods list: the .jar went to the wrong instance or folder, or the profile is the vanilla one instead of Fabric.
• Fabric API is missing: the game stops before the title screen and names fabric-api in the error. Repeat step 3.
• Sign-in never completes: finish the browser step with the same account you use on the dashboard, then relaunch.

Lua API 4 bundles

An API 4 script is a bundle with static bundle.json metadata and a Lua entrypoint. A loose .lua file is not a complete Hexis bundle.

The current public documentation does not claim that arbitrary user bundles can be installed in every distributed build. Check the release details for your dashboard build. If it does not name API 4 user-bundle loading, use these pages to design and review a bundle, not to infer an install location.

The default Hexis menu key is H. Maintained scripts that are present in your build appear there.

Continue with build your first script.