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)

Per-Maid Task Config (Individual per maid)

Configurable per maid in the maid GUI:

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

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