Anvil
fangorn/huorn-minecraft public
ref:main
Preview Code

Installing Huorn

Huorn is a Minecraft mod. Mods need a mod loader — a program that patches Minecraft to support mods. There are two loaders, and Huorn works with both.

Pick a Loader

Fabric Forge
Vibe Lightweight, fast, modern Old guard, huge mod ecosystem
Install Tiny installer, downloads in seconds Bigger installer, takes a minute
Compatibility Needs Fabric API + Architectury API as separate mods Needs Architectury API as a separate mod
Recommendation Use this one unless you need Forge-only mods Use if you already have a Forge setup

Install Fabric (Recommended)

  1. Download the Fabric installer from https://fabricmc.net/use/installer/
  2. Run it. Select Minecraft 1.20.1, click Install.
  3. Open the Minecraft Launcher. You’ll see a new profile called fabric-loader-1.20.1. Don’t launch it yet.

Install Dependencies

Huorn needs two library mods. Download both for Minecraft 1.20.1:

Put both .jar files in your mods folder:

  • macOS: ~/Library/Application Support/minecraft/mods/
  • Linux: ~/.minecraft/mods/
  • Windows: %APPDATA%\.minecraft\mods\

Create the mods folder if it doesn’t exist.

Install Huorn

Put huorn-fabric-2026.03.1.jar in the same mods folder.

Your mods folder should look like:

mods/

  fabric-api-0.91.0+1.20.1.jar

  architectury-9.2.14-fabric.jar

  huorn-fabric-2026.03.1.jar

Launch

  1. Open the Minecraft Launcher
  2. Select the fabric-loader-1.20.1 profile
  3. Click Play

In-Game

  1. Create or join a world
  2. Open chat (T) and type: /give @s huorn:terminal_block
  3. Place the block, right-click it
  4. You now have a terminal. Type commands.
  5. ESC to stop typing and move around
  6. F12 for full-screen terminal overlay
  7. Right-click again to resume typing

Server Setup

For dedicated servers:

  1. Install Fabric Server (same installer, check “Server” instead of “Client”)
  2. Put the same three JARs in the server’s mods/ folder
  3. Edit config/huorn.json: 
    {

      "server": {

        "enableOnServers": true

      }

    }
  4. Players need the huorn.use permission (ops have it by default, or use LuckPerms)

Docker Backend (Optional)

To run terminal shells inside Docker containers instead of directly on the server:

  1. Ensure Docker is running on the server
  2. Pull the image: docker pull ubuntu:24.04
  3. Edit config/huorn.json: 
    {

      "backends": {

        "docker": {

          "enabled": true

        }

      },

      "server": {

        "defaultBackend": "docker"

      }

    }
  4. Grant players: huorn.use.docker permission

Admin Commands

/huorn status              — show active terminals and backend availability

/huorn list                — show who has terminals open

/huorn kill <player|all>   — force-close terminals

/huorn reload              — reload config without restart

/huorn audit [player]      — view recent audit log entries

If Using Forge Instead

Same process, but:

  • Download the Forge installer from https://files.minecraftforge.net/ (version 47.2.0+ for 1.20.1)
  • Download the Forge version of Architectury API from Modrinth
  • You don’t need Fabric API
  • Use huorn-forge-2026.03.1.jar instead