Installation

Home › Getting started › Installation

Which file to download, what else you need, and how to update, move or remove the mod without losing anything. Written for players; if you run a server, read this and then the Server Guide.

On this page: Which file? · What you need · Where to download · Installing · Recipe viewers · The update notice · Updating from 2.0.x · Moving a world to a newer Minecraft · Switching loaders · Uninstalling

Which file?

Pick the file for your Minecraft version and your mod loader. The eight Fabric and NeoForge files have the same features, with the exceptions in the notes below. Minecraft 1.18.2 and 1.16.5 each have a Forge file of their own, under the table.

Minecraft	Fabric	NeoForge
26.3	hempdustry-fabric-2.1.0+26.3.jar	hempdustry-neoforge-2.1.0+26.3.jar
26.2	hempdustry-fabric-2.1.0+26.2.jar	hempdustry-neoforge-2.1.0+26.2.jar
1.21.11	hempdustry-fabric-2.1.0+1.21.11.jar	hempdustry-neoforge-2.1.0+1.21.11.jar
1.21.1	hempdustry-fabric-2.1.0+1.21.1.jar	hempdustry-neoforge-2.1.0+1.21.1.jar

A file name reads hempdustry-<loader>-<mod version>+<Minecraft version>.jar.

Minecraft 1.18.2, on Forge: hempdustry-forge-2.1.0+1.18.2.jar. It is made so a Hemp-Craft or GanjaCraft world can be kept: it opens one and converts it. It runs on Java 17 and goes without the few things Minecraft 1.18.2 cannot hold. Everything about it: Minecraft 1.18.2 and Hemp-Craft.

Minecraft 1.16.5, on Forge: hempdustry-forge-2.1.0+1.16.5.jar. It is made so a GanjaCraft world can be kept: it opens one and converts it. It runs on Java 8 and goes without the few things Minecraft 1.16.5 cannot hold. Everything about it: Minecraft 1.16.5 and GanjaCraft.

Each jar loads only on its own Minecraft version: the 1.21.11 file will not start on 1.21.10 or 1.21.12, nor the 26.2 file on 26.3, and there is no build for 26.1, for 1.21.2 to 1.21.10, for 1.17 to 1.18.1, for 1.19 to 1.20, for 1.16.4 or older, for Forge on any version but 1.18.2 and 1.16.5, or for Bedrock. If you are on one of those, see the FAQ.

Minecraft 26.2 and 26.3. The 26.x builds run on Java 25 and have a few things the older versions cannot: a footbag, jelly legs, powdery mildew and more. Both have all of them. What is different there.

Not on 1.21.1. The Hemp Shelf (vanilla has no shelves before 1.21.9), the Hemp Harness (the happy ghast arrived in 1.21.6) and bundles made from canvas (on 1.21.1 the bundle is still an experiment). A 1.21.1 world moved up to 1.21.11 gains them.

What you need

	Java	Fabric	NeoForge
Minecraft 26.3	25 or newer	Fabric Loader 0.20.1 or newer, and Fabric API 0.165.0+26.3 or newer	NeoForge 26.3.0.101 or newer
Minecraft 26.2	25 or newer	Fabric Loader 0.20.1 or newer, and Fabric API 0.161.0+26.2 or newer	NeoForge 26.2.0.93 or newer
Minecraft 1.21.11	21 or newer	Fabric Loader 0.18.2 or newer, and Fabric API 0.139.4+1.21.11 or newer	NeoForge 21.11.45 or newer
Minecraft 1.21.1	21 or newer	Fabric Loader 0.16.5 or newer, and Fabric API 0.105.0+1.21.1 or newer	NeoForge 21.1.209 or newer
Minecraft 1.18.2	17 or newer	no Fabric build	no NeoForge on 1.18.2: Forge 40.3.12 or newer
Minecraft 1.16.5	8 or newer	no Fabric build	no NeoForge on 1.16.5: Forge 36.2.39 or newer

• On NeoForge the mod needs nothing else. On Fabric it needs Fabric API, which is a separate download.
• Java 21 is what Minecraft 1.21 runs on anyway, Java 25 what 26.x runs on, Java 17 what 1.18.2 runs on, and Java 8 what 1.16.5 runs on. The official launcher, and most others, bring their own; you only need to think about it on a server you set up by hand.
• Install it on both sides. In single player, your game is both, so one copy in your mods folder is all it takes. On a server, the server needs it and so does every player who joins.

If your loader or Fabric API is too old, the loader says so when the game starts, naming the version it wants.

Where to download

The same files are posted everywhere:

• GitHub releases
• CurseForge (the listing still carries the mod's old name in its address)
• NexusMods
• Modrinth: the listing is still in review, so it is coming but not there yet.

The website and the source code are public too.

Installing

1. Install Fabric Loader or NeoForge (Forge on 1.18.2 and 1.16.5) for your Minecraft version, using its own installer or your launcher's.
2. On Fabric, put the Fabric API jar in your mods folder.
3. Put the Hempdustry jar for your loader and version in the same mods folder.
4. Start the game. A Hempdustry tab in the creative inventory is the quickest sign that it loaded. (Its advancement tab appears only once you pick up your first hemp seed, the way vanilla's tabs wait for their first advancement.)

On a server the same jar goes in the server's mods folder; there is no separate server file. Each player needs the same jar in their own game.

Recipe viewers

Optional, but they are the easiest way to learn the mod. Install one alongside it:

Viewer	Minecraft 26.3	Minecraft 26.2	Minecraft 1.21.11	Minecraft 1.21.1	Minecraft 1.16.5
JEI	yes, both loaders	yes, both loaders	yes, both loaders	yes, both loaders	yes (JEI 7)
REI	yes, both loaders (on NeoForge with Architectury API 22.0.5 or newer)	Fabric only: REI does not run on NeoForge 26.2	yes, both loaders	yes, both loaders	no
EMI	no	no	no: EMI has never been released past 1.21.1	yes, both loaders	no

On Minecraft 1.18.2 the viewers are JEI 10 and REI 8 (REI needs Architectury and Cloth Config beside it); there is no EMI.

With a viewer you get more than the crafting recipes. Hempdustry adds pages for its machines (the Decarboxylator, the Infuser, the Hemp Press and the Sifting Box), for packing a pipe or a bong, for the cauldron steps, and an In the World page for the things that have no recipe at all: trimming a plant, rubbing it for charas, cutting a hash bar, and so on. The Grow Pot, Hydro Tray, Grow Lamp and every bong get an information page. None of this is in the vanilla recipe book.

On a dedicated server (Minecraft 1.21.11 and 26.x): since Minecraft 1.21.2 a server no longer sends players its recipes, so JEI shows Hempdustry's crafting recipes only if JEI is installed on the server too. The machine and packing pages show either way. On Minecraft 1.21.1 and older the server still sends its recipes, so this does not come up.

The update notice

When a newer Hempdustry exists, the first world you join after starting the game shows one line in chat:

Hempdustry 2.1.0+1.21.11 is available. You have 2.0.3+1.21.11. Download it

Click Download it to open the download page. It appears once each time you start the game, never more, and only when there really is something newer.

Where it looks. Two places, and it believes whichever offers the newer version:

1. a small file kept in the mod's own GitHub repository, which is the only way to reach players who got the mod from CurseForge or NexusMods (neither site lets a mod ask them, because their APIs need a private key that cannot be shipped inside a jar);
2. Modrinth's public listing, once it is live.

It asks about your Minecraft version and announces only what the project has published for everyone: a beta is not pushed to players on a stable release, but a player on a beta is told when the full release lands. The requests say which version of the mod, which Minecraft version and which loader you run, and nothing else. If neither place answers within five seconds (you are offline, say), it says nothing and tries again next time. A dedicated server never asks: the check runs only in a player's game.

Turning it off. Open config/hempdustry.json in your game folder and set updateCheck in the client section to false:

"client": {
  "updateCheck": false
}

It takes effect the next time you start the game. Modpacks usually want this off, since the pack decides when the mod updates. (The file holds other settings too; leave them as they are. See Configuration.)

Updating from 2.0.x

Swap the jar and open your world. There is nothing else to do. Since 2.0.2, a world made with any version of Hempdustry 2 opens on every later one, betas included, and so do the datapacks and resource packs that worked with it (Stability Promise). Keeping a backup before any update is still good sense, with this mod or any other. Your config/hempdustry.json keeps your settings; new settings appear in it at their defaults the first time 2.1 starts.

2.1 is mostly new things: hash and the extraction bench, the Redstone Vaporizer, Beldía, indoor growing, bongs in every colour of glass, schwag, the Hemp Bed and more, and eighteen new advancements. A few things you already know now behave differently. Three hemp wool over three planks makes a Hemp Bed, not a white bed (dye it white for the white bed). A bong hit is drawn: hold right-click instead of clicking. Level III effects are back, but only when a bud is smoked with a concentrate. Creepers now and then wander into a grown hemp field under open sky. A flowering plant on bone-dry farmland can stress, and now and then a ripe plant gives one of its buds as schwag. The Hemp Harem Pants are undyed hemp now (dye them with green and light grey dye together for the old olive), the Hemp Beanie and Flip Flops no longer take armour trims (a trim already on one stays on the item but is not drawn), and the outfit lasts as long as leather armour. When an edible kicks in depends more on how good the butter was, and Purple Kush is a brighter violet. Everything is in the changelog.

Known issues in 2.1.0: Russian shows some of 2.1's new text in English for now. A hash spliff's name reads one level low: a spliff of two buds and a pinch of hash says II and gives III. A Redstone Vaporizer on a full inventory loses the Scorched Hemp its bowl leaves, and on Minecraft 1.21.1 a standing bong shows only its outline (FAQ).

Moving a world to a newer Minecraft

Supported, one step up at a time: 1.21.1 to 1.21.11, 1.21.11 to 26.2, 26.2 to 26.3. Each of these steps has been played through on both loaders. Back the world up, install the newer version's jar for the same loader (and on Fabric, Fabric API for that version), and open the world in that Minecraft. Minecraft upgrades the world as it always does between versions, and Hempdustry's things come through whole:

• the Decarboxylator, Infuser and Hemp Press keep what is inside them and the name you gave them on an anvil;
• a Hemp Boat with Chest keeps its cargo, and a bong you set down stays packed;
• everything else, from crops to bricks, is simply there.

Coming from 1.21.1, the world gains the three things listed above; reaching 26.x, it gains the 26.x extras. Minecraft can jump several versions at once, but opening the world once at each step is the route that has been tested. A 1.16.5 world, on Forge, moves up to NeoForge 1.21.1 or any newer version, straight there or one version at a time; what to know first, including which Hempdustry version that needs, is on Minecraft 1.16.5 and GanjaCraft.

Going the other way, to an older Minecraft, is not something Minecraft supports for any world, with or without mods.

Switching loaders

Moving a world between Fabric and NeoForge is not promised. Hempdustry saves its own data the same way on both, but the loaders themselves, and the other mods in your game, may not. If you want to try, back the world up first and keep the same Minecraft version and the same Hempdustry version on both sides. Addons are built for one loader or the other, so they do not move with you.

Uninstalling

Watch out: back up your world before you remove the mod. Removing it is not reversible for that world.

Minecraft drops what it no longer recognises. When a world is opened without Hempdustry:

• every Hempdustry block turns to air: crops, machines, bricks, planks, hempcrete, beds. A house built from hemp loses those walls;
• every Hempdustry item disappears from inventories, chests and item frames, along with anything stored inside the mod's machines and boats;
• your progress in the Hempdustry advancement tab is forgotten.

Anything the mod turned into a vanilla item stays, because it is vanilla now: paper, books, string, bundles, and a Hemp Bed or Hemp Harness you dyed into a vanilla one. Effects already running wear off as usual.

Putting the mod back later does not bring back what was lost in any part of the world that was loaded and saved without it. Your config/hempdustry.json stays in the config folder and does nothing; delete it if you like.

---

See also: Getting Started · FAQ · Server Guide · Stability Promise