Configuration

Home › Servers & modpacks › Configuration

Every setting in config/hempdustry.json: what it does, its default and range, and when a change takes effect. For server owners and pack makers. Ready-made presets and what a broken file does are on Server Guide; the balance data the settings sit on top of is on Datapacks.

Tip: rather click than type? The config builder on the website has every key on this page with its range, the presets from Server Guide, and a file that holds just what you changed, ready to copy or download. Paste your current file into it to pick up where you left off.

On this page: The file · Three kinds of setting · client · effects · world · infuser · loot · The config and the datapack data · The default file

The file

• Where: config/hempdustry.json, in the server's folder — or, in single player, in the game's own config/ folder, where it applies to every world.
• When it is read: once when the game or server starts, and again by /hempdustry reload (permission level 2). It is the same file and the same keys on every loader and every Minecraft version, from 26.3 down to 1.16.5, except world.mildew, which only 26.2 and 26.3 have.
• It is rewritten every time it is read successfully: complete, every key present, the keys in alphabetical order with a _comment line first in each section. A setting added in a later version appears in your file at its default; there is never a migration step. Your own comments and unknown keys are dropped when it is rewritten.
• Server-side, except client. A player's own effects, world, infuser and loot sections do nothing on someone else's server, and the machine screens are sent the server's timings, so their progress bars are always right.
• Values out of range are pulled into range and logged as a warning (Config effects.maxLevel was 99, clamped to 10), and the corrected value is written back. A file the mod cannot read at all — broken JSON, a word where a number goes — is left untouched and nothing in it is applied; see Server Guide.
• Types: switch is true or false; whole number is an integer; number takes decimals (1.5).

Three kinds of setting

• Switches turn a mechanic off outright: greenOut: false and there are no green-outs.
• Multipliers scale a number that the mod or its data sets. 1.0 is as shipped, 2.0 twice as much — twice as long, twice as fast or twice as likely, as the key says — and 0.5 half.
• Caps (maxLevel, maxBuffLevel) are ceilings on effect levels. They can only lower a level; they never raise one above what a strain or edible asks for.

The infuser section is the exception: two absolute times in ticks rather than a multiplier, because the Infuser's grading reads both and one has to stay above the other.

Note: nothing here can give an effect that a strain or an edible does not have, or make a raw plant do anything. A few rules are the mod's own and have no setting on purpose: a single bud never greens you out, and a bigger dose never shortens a high.

client

Read by each player's game, from their own file, and sent nowhere. A dedicated server writes this section and ignores it.

Key	Type	Default	Range	What it does
updateCheck	switch	true	—	On start-up the game asks the project's update file on GitHub, and Modrinth, whether a newer Hempdustry exists for the Minecraft version and loader you are running, and says so once in chat when you join a world, with a download link. false stops it asking at all. Any failure is silent. Turn it off in a modpack, where the update it announces cannot be taken anyway
biomeTintStrength	number	0.35	0–1	How far Purple Kush and Lemon Haze — growing, wild and potted — are pulled towards the local grass colour, so a plant does not clash with its biome. 0 draws them exactly as painted, 1 is the full tint vanilla gives grass (and makes the two strains the same green). Beldía keeps its own colours
ripeAroma	switch	true	—	The faint wisps that curl off a ripe plant. false hides just these; vanilla's Particles setting already thins them (Decreased) or hides them (Minimal) with every other particle

Applies: when the player restarts their game. In single player, /hempdustry reload re-reads it too; a new biomeTintStrength shows once the chunks are redrawn (F3 + A).

effects

What smoking and edibles do to a player. All of it applies at once on /hempdustry reload.

Key	Type	Default	Range	What it does
enabled	switch	true	—	The master switch. false is "hemp only": smoking and edibles apply no effects at all, and there are no green-outs either (see the preset on Server Guide)
maxLevel	whole number	4	1–10	The highest level any effect from the mod can reach, costs included: Weakness, Mining Fatigue, Hunger and Poison as well as the buffs. The PvP setting
maxBuffLevel	whole number	2	1–10	The highest level a helpful effect can reach — level II, where a beacon stops. A bud smoked together with a concentrate (a hash spliff, a moon rock) goes one level past it, so III by default. A bud beyond the cap buys time instead: each one adds half the device's duration. Never above maxLevel. Raise it for a stronger mod in a kitchen-sink pack
durationMultiplier	number	1.0	0.05–10	Scales how long every effect lasts, smoking and edibles alike
cooldownMultiplier	number	1.0	0–10	Scales every smokeable's use cooldown, and the minute a full green-out locks you out of smoking. 0 means no cooldown
greenOutChanceMultiplier	number	1.0	0–100	Scales the chance of a green-out: 2.0 makes one twice as likely, 0.5 half as likely, 0 never. A single bud still never greens you out
onsetMultiplier	number	1.0	0.05–10	Scales when an edible kicks in — each quality's earliest, likeliest and latest moment together. At 0.5 a Perfect edible hits after about 45 seconds instead of a minute and a half
greenOut	switch	true	—	false: no green-outs, ever
nausea	switch	true	—	false: the mod never applies Nausea — not from a harsh hit, a green-out or any strain. An accessibility switch; the green-out keeps its other effects
munchies	switch	true	—	false: the mod never applies Hunger
debuffs	switch	true	—	false: the mod applies no harmful effect at all — Hunger, Nausea, Slowness, Weakness, Mining Fatigue, Blindness, Poison, and any a datapack strain adds — and so no green-outs, which are made of nothing else

Coughing is only a sound, so no setting changes it; the odds are in the device data (Datapacks).

world

Key	Type	Default	Range	What it does	Applies
cropGrowthMultiplier	number	1.0	0.05–20	How fast all three strains grow, in fields, Grow Pots and Hydro Trays alike. It scales the chance that a random tick grows the plant, so 2.0 really is twice as fast — up to the point where every random tick grows it. Dry ground still never grows anything, and wild plants do not grow	/hempdustry reload, at once
machineSpeedMultiplier	number	1.0	0.05–20	How fast the Decarboxylator (25 s a tray at 1.0) and the Hemp Press (10 s an item) work; 2.0 is twice as fast. The Infuser has its own section below	/hempdustry reload, at once
creepersSeekHemp	switch	true	—	Whether creepers now and then wander into grown, open-sky hemp fields and lurk there. false makes them ordinary creepers again	/hempdustry reload, at once — on creepers already in the world too
mildew	switch	true	—	Minecraft 26.2 and 26.3 only. Whether hemp under a roof can catch powdery mildew. false: no plant catches it, and a plant that has it is clean again on its next random tick	/hempdustry reload, at once

Note: with machineSpeedMultiplier changed on a server, a player's game still uses its own file for two cosmetic things: the rhythm of the Hemp Press's moving screw, and the times printed on the JEI and REI pages. What the machines actually do, and their progress bars, follow the server.

Whether bees pollinate hemp is not a setting: it is the vanilla tag #minecraft:bee_growables, which takes hemp in through #minecraft:crops. See Tags.

infuser

The simmer's two clocks, in ticks (20 ticks = 1 second). Both apply at once on /hempdustry reload, to batches already simmering as well.

Key	Type	Default	Range	What it does
minTimeTicks	whole number	6000 (5 min)	20–31980	The earliest a batch can be taken out. It is also the loading window: hemp dissolves into the batch one item every minTimeTicks ÷ 24 ticks until then, so a batch holds up to 24 whatever you set
fullTimeTicks	whole number	18000 (15 min)	minTimeTicks + 20 to 32000	A full simmer, which Perfect cannabutter needs (along with nothing but washed hemp). If it is not above minTimeTicks, it is raised to minTimeTicks + 20

The ceiling of 32000 ticks (26 min 40 s) is the longest simmer the Infuser's screen can be told about; past it the bar would show nonsense. A batch only simmers while its chunk is loaded.

loot

The mod's additions to vanilla's loot tables: hemp seeds in tall grass and chests, Beldía in the desert, music discs in dungeons and mansions, hemp in shipwrecks, the fisher's chest and fishing junk. The full list is on Modpack Guide.

Key	Type	Default	Range	What it does
enabled	switch	true	—	false: the mod adds nothing to vanilla's loot tables
chanceMultiplier	number	1.0	0–10	Scales every added chance — 1% from tall grass becomes 2% at 2.0 — each still capped at 100%. 0 removes everything chance-based. The few additions that go into vanilla's own pools as a weight (Beldía from desert brushing, toasted hemp seeds in the fisher's chest, hemp fibre in fishing junk) are not scaled; enabled: false removes them

Applies: loot tables are built when the world loads and on /reload, so run /hempdustry reload and then /reload — or restart. A chest that has already been opened keeps what it had.

Note: creepers dropping the two music discs is not part of this. It comes from the discs being in vanilla's #minecraft:creeper_drop_music_discs tag, and enabled: false leaves it alone.

The config and the datapack data

The balance has two layers. The data — strains, the four device files, the edible bundle and the green-out table, all datapack files read when the world opens — says what each thing does. The config sits on top, server-wide, and has the last word.

The data says	The config then
a device's duration_ticks; an edible quality's duration_ticks	multiplies it by durationMultiplier
a device's cooldown_ticks; the green-out's lockout_ticks	multiplies it by cooldownMultiplier
the green-out's odds per dose; a device's or strain's green_out_factor	divides the odds by greenOutChanceMultiplier; greenOut: false, debuffs: false or enabled: false makes them never
a device's nausea_one_in	nausea: false makes it never
an edible quality's onset_ticks	multiplies them by onsetMultiplier
any effect's level, from a strain, an edible or a green-out	caps it at maxLevel, and a helpful one at maxBuffLevel
any effect at all	drops it if enabled, munchies, nausea or debuffs says so

An example: the shipped edible data gives Absorption up to level IV at the top dose, and maxBuffLevel holds it at II. Raise maxBuffLevel to 4 and the data's IV comes through.

Some numbers are in neither layer's reach: the base growth speed of each strain and the machines' base times are the mod's own (the config's multipliers scale them), recipes decide yields, and tags decide what the Sifting Box takes, what heats the Infuser and the Hemp Press, and what feeds a Grow Pot or Hydro Tray (Tags). Datapacks and Custom Strains cover the data side; data changes need a restart.

The default file

What the mod writes on first start (2.1.0 on Minecraft 1.21.11, every line as written):

{
  "client": {
    "_comment": "Read by a client, sent to nobody. updateCheck=false stops this client checking for a newer release on start-up; a dedicated server never asks. Turn it off in a modpack, where the update it would announce cannot be taken anyway. biomeTintStrength is 0-1: how far hemp growing in the world is pulled towards the local grass colour, so a plant does not clash with the biome around it. 0 paints the crops exactly as drawn, 1 is the full tint vanilla gives grass. ripeAroma=false stops the wisps that drift off ripe plants; vanilla's Particles setting thins or hides them along with every other particle.",
    "biomeTintStrength": 0.35,
    "ripeAroma": true,
    "updateCheck": true
  },
  "effects": {
    "_comment": "enabled=false is 'industrial hemp only': no drug effects anywhere. maxLevel caps every effect the mod applies; maxBuffLevel caps only the helpful ones (Speed, Resistance, Absorption...), so a big dose still costs its full Hunger. Raise maxBuffLevel for a stronger mod in a modded pack. The multipliers are 0.05-10, except cooldownMultiplier, 0-10 (0 is no cooldown), and greenOutChanceMultiplier, 0-100. greenOutChanceMultiplier 0 disables green-outs, as do greenOut=false and enabled=false.",
    "cooldownMultiplier": 1.0,
    "debuffs": true,
    "durationMultiplier": 1.0,
    "enabled": true,
    "greenOut": true,
    "greenOutChanceMultiplier": 1.0,
    "maxBuffLevel": 2,
    "maxLevel": 4,
    "munchies": true,
    "nausea": true,
    "onsetMultiplier": 1.0
  },
  "world": {
    "_comment": "cropGrowthMultiplier and machineSpeedMultiplier are speeds: 2.0 is twice as fast. machineSpeed drives the Decarboxylator and the Hemp Press; the Infuser has its own section. Whether bees pollinate hemp is the #minecraft:bee_growables tag, not a setting here. creepersSeekHemp=false stops creepers now and then wandering into grown, open-sky hemp fields; the goal is still added to them, it simply never starts, so it takes effect on the next /hempdustry reload.",
    "creepersSeekHemp": true,
    "cropGrowthMultiplier": 1.0,
    "machineSpeedMultiplier": 1.0
  },
  "infuser": {
    "_comment": "Ticks. minTime is the earliest a batch can be pulled, fullTime a full simmer. 20 ticks = 1 second. Defaults are 5 and 15 minutes; the ceiling is 32000 (about 26 minutes), which is as long a simmer as the screen can be told about.",
    "fullTimeTicks": 18000,
    "minTimeTicks": 6000
  },
  "loot": {
    "_comment": "The mod's additions to vanilla loot tables: hemp seeds in grass and chests, music discs in chests, shipwreck fibre. enabled=false removes all of them. Creepers dropping the two discs is the #minecraft:creeper_drop_music_discs tag, not a setting here.",
    "chanceMultiplier": 1.0,
    "enabled": true
  }
}

On 26.2 and 26.3 the world section also has "mildew": true, and its comment one more sentence about it. On 1.21.1 and the Forge builds the five sections come out in another order (world, infuser, loot, client, effects); the order means nothing, and the keys inside each are the same.

The comments are short on purpose; where they and this page differ in detail (the exact ranges, say), this page follows the mod's code.

---

See also: Server Guide · Commands · Datapacks · Smoking