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