Sawmill & Incubator

Here is the English version of the README:

Sawmill

Two machines for Minecraft: the Sawmill processes logs into planks, and the Forest Incubator grows logs from saplings. With fuel, upgrades, maintenance, and full hopper automation.

An original mod, not an “infinite farm”: the machines have fuel consumption, a hard speed limit, and random breakdowns that must be repaired.

---

Contents

• Features
• Installation
• Sawmill
• Forest Incubator
• Wrench and Maintenance
• Upgrades
• Recipes
• Progression
• Fuel
• Balance Configuration
• Building from Source
• Compatibility
• Project Structure
• License

---

Features

• Two machines with their own GUIs, inventories of 6 and 8 slots, and state animations (working / clogged).
• 5 upgrades inserted into slots: speed, efficiency, two automation tiers, and a self-diagnostics module.
• Hard speed limit — no more than 10 operations per minute. Speed upgrades make processing a single item faster, but they do not remove the limit, so the machine does not turn into an infinite farm.
• Maintenance — a 5% chance to clog after each batch. A clogged machine must be repaired with a wrench.
• Hopper automation — accepts input and fuel, pushes finished products into adjacent containers.
• Fully automatic — Automation II plus the Self-Diagnostics module automatically clears clogs by consuming iron.
• Strict species matching — the Incubator outputs logs and saplings of the same type as the input sapling.
• Bilingual interface — Russian and English.
• Multiplayer — all logic runs on the server; state is synchronized through ContainerData and block states.

---

Installation

1. Install Fabric Loader version 0.19.3 or newer for Minecraft 26.2.
2. Download Fabric API for 26.2 and place it in the mods folder.
3. Place sawmill-1.5.4.jar in the mods folder.
4. Java 25 is required.

The mod works on both the client and the server ("environment": "*"). For server play, it is needed both on the server and on clients — on a dedicated server, the client part simply does not load.

---

Sawmill

The main machine: log + fuel → 4 planks per batch.

Supports 12 wood types: oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak, bamboo, crimson and warped stem. Output planks always match the input log.

GUI slots:

#	Slot	Purpose
0	Fuel	Coal, charcoal, planks, lava bucket, iron ingot
1	Input	Log of any supported wood type
2	Output	Extraction only
3–5	Upgrades	One item per slot

Recipe: 3 iron ingots + furnace + 3 oak planks.

I I I
I F I
P P P

I — iron ingot, F — furnace, P — oak planks.

---

Forest Incubator

The second machine: sapling + bone meal + fuel → 3–5 logs and 0–2 saplings of the same type.

The Incubator closes the tree loop: some planks can go back as fuel, some saplings can go back as input, and logs return to the Sawmill.

GUI slots:

#	Slot	Purpose
0	Fuel	Same as the Sawmill
1	Input	Any sapling (tag minecraft:saplings)
2	Catalyst	Bone meal, consumes 1–5 per batch
3	Output	Logs — extraction only
4	Output	Saplings — extraction only
5–7	Upgrades	One item per slot

Supports 9 saplings: oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak. Azalea and flowering azalea produce oak logs and oak saplings.

Bone meal is consumed at the start of a batch — 1 to 5 randomly. If there is less bone meal than rolled, the entire remainder is consumed.

Recipe: 4 iron ingots + glass + sapling.

I G I
I S I
I I I

I — iron ingot, G — glass, S — any sapling.

---

Wrench and Maintenance

After each completed batch, there is a 5% chance that the machine will clog. A clogged machine:

• stops and processes nothing;
• changes texture to the clogged=true state;
• shows red text in the GUI;
• accumulates progress from zero after repair.

Repaired by right-clicking the block with a wrench. Repair costs 1 iron ingot from the player’s inventory (free in Creative mode). If there is no iron, the player receives a chat message.

After repair, a 30-second grace period applies, during which the machine cannot clog again.

The wrench has durability 64 and can be enchanted with Unbreaking.

Wrench recipe: 3 iron ingots.

I .
I
I

The wrench is shared by both machines — they implement the Repairable interface.

---

Upgrades

All upgrades occupy one slot, do not stack, and are inserted into the three slots on the left side of the GUI. Multiple identical upgrades in different slots add together.

Upgrade	Effect	Recipe
Speed	Speeds up processing by 25% per upgrade. Base 120 ticks, minimum 40	2 redstone + 2 iron + oak planks
Efficiency	25% chance to double the plank batch per upgrade. For the Incubator, raises the log cap from 5 to 9	2 emeralds + 2 iron + oak planks
Automation I	Hoppers can see the machine’s inventory: input and fuel can be loaded	4 iron + hopper
Automation II	Finished products are pushed into adjacent containers every 2 seconds	4 iron + hopper + 2 comparators
Self-Diagnostics	Only with Automation II: automatically clears clogs every 10 seconds, consuming 1 iron ingot from the fuel slot	4 iron + 3 blocks of redstone

Exact recipe grids:

Speed

. R .
I P I
. R .

Efficiency

. E .
I P I
. E .

Automation I

. I .
I H I
. I .

Automation II

. C .
I H I
. C .

Self-Diagnostics

. R .
I R I
. R .

I — iron ingot, R — redstone, E — emerald, P — oak planks, H — hopper, C — comparator, R in Self-Diagnostics — block of redstone.

---

Progression

The mod is intentionally split into three tiers. Each tier removes some manual work, but not all of it at once.

Tier	Requirements	What it provides
Manual	Sawmill only	The player manually inserts logs and fuel, takes planks, and repairs the machine
Semi-automatic	+ Automation I	Hoppers load input and fuel. Repairs are still manual
Fully automatic	+ Automation II + Self-Diagnostics	The machine pushes out products and clears clogs automatically as long as there is fuel, input, and iron in the fuel slot

At the fully automatic tier, keep an eye on the fuel slot: it must contain both fuel and iron ingots for self-repair. The hopper accepts both.

---

Fuel

Fuel	Burn time
Lava bucket	20000 ticks (≈16.7 min)
Coal	1600 ticks (80 sec)
Charcoal	1600 ticks (80 sec)
Any planks	300 ticks (15 sec)

A lava bucket returns an empty bucket. Planks are determined by the tag minecraft:planks, so planks of all wood types work, including modded ones.

An iron ingot does not burn — it is placed in the fuel slot as a resource for self-diagnostics and is also consumed by the wrench during manual repair.

License

MIT. See the LICENSE file.