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