MaidsConstruct

Maid’s Construct 女仆匠魂

Maid’s Construct is a Minecraft 1.20.1 Forge mod that bridges
Touhou Little Maid and
Tinkers’ Construct.

Image

Features

This mod adds a “Smeltery” task for maids, enabling them to autonomously manage the full TiC smeltery/foundry workflow:

• Auto Pathfinding — BFS search for nearby smelteries/foundries with position caching
• Fuel Management — Detects low fuel and refills using fluid containers from inventory (compatible with all mod implementing Forge fluid capability)
• Ore Insertion — Inserts allowlisted items into the smeltery for melting, automatically skipping items that require higher temperature
• Fluid Pouring — After melting, automatically activates faucets to pour fluid into casting tables/basins; supports ingot casts, gem casts, nugget casts, and basins with priority-based target selection; checks for valid casting recipes before pouring
• Item Collection — Collects finished items from casting tables/basins after cooling
• Alloy Avoidance — Checks alloy recipes before inserting ores, only inserts when the new fluid won’t form a new alloy with existing fluids (smeltery only, not foundry)
• Fluid Sorting — Automatically moves the largest fluid volume to the bottom before pouring, ensuring priority export
• Fuel Protection — Won’t insert ores when fuel is completely depleted, preventing items from getting stuck
• Non-Meltable Extraction — Automatically extracts items that can’t be melted (no recipe or insufficient temperature) from the smeltery
• Auto Compacting — Auto-craft 9 nuggets into ingots, 9 ingots/gems into blocks (can be disabled)
• Inventory Sorting — Auto-sort inventory by Blocks > Ingots > Gems > Nuggets > Other (can be disabled)
• Status Bubbles — Maids display chat bubbles based on current work state, including no fuel, no ores, no casts, inventory full, etc.

Configuration

Mod Config (Global, affects all maids)

| Option | Description | Default |
|:———————-:|:——————————————-:|:——————-:|
| Maid Smeltery Immunity | Maids are immune to smeltery melting damage | Enabled |
| Allowed Fuels | List of fluid IDs maids can use as fuel | Lava, Blazing Blood |

Per-Maid Task Config (Individual per maid)

Configurable per maid in the maid GUI:

| Option | Description | Default |
|:——————–:|:—————————————————–:|:——–:|
| Auto-craft Ingots | Auto-compact 9 nuggets into ingots | Enabled |
| Auto-craft Blocks | Auto-compact 9 ingots or gems into blocks | Enabled |
| Auto-sort Inventory | Sort inventory by type after crafting | Enabled |
| Ignore Allowlist Tag | Ignore the allowlist tag and insert any meltable item | Disabled |

Item Allowlist Tag

The #maidsconstruct:smeltery_allowlist item tag controls which items maids can insert into the smeltery. By default it
includes:

• forge:ores (ores)
• forge:raw_materials (raw materials)
• forge:dusts (dusts)
• forge:raw_nuggets (raw nuggets, optional)
• Tinkers’ grout and nether grout

You can customize this tag via datapacks to add or remove allowed items.

Dependencies

| Mod | Version |
|:——————:|:——-:|
| Minecraft | 1.20.1 |
| Forge | 47.2+ |
| Touhou Little Maid | 1.3.7+ |
| Tinkers’ Construct | 3.10+ |

Debugging

This mod supports Touhou Little Maid’s debug system. With debug mode enabled, use the debug stick on a maid performing
smeltery work to see:

• Green marker — Smeltery position and current state (IDLE / FUELING / INSERTING / WAITING_MELT / POURING / WAITING_CAST / COLLECTING)

About This Repository

The initial commit of this repository was generated by Claude Opus 4.6, then fully reviewed and corrected by humans.

License

BSD-3-Clause