MaidsConstruct

Maid's Construct 女仆匠魂

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

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