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:

- Status Bubbles — BFS search for nearby smelteries/foundries with position caching - Status Bubbles — Detects low fuel and refills using fluid containers from inventory (compatible with all mod implementing Forge fluid capability) - Status Bubbles — Inserts allowlisted items into the smeltery for melting, automatically skipping items that require higher temperature - Status Bubbles — 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 - Status Bubbles — Collects finished items from casting tables/basins after cooling - Status Bubbles — 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) - Status Bubbles — Automatically moves the largest fluid volume to the bottom before pouring, ensuring priority export - Status Bubbles — Won't insert ores when fuel is completely depleted, preventing items from getting stuck - Status Bubbles — Automatically extracts items that can't be melted (no recipe or insufficient temperature) from the smeltery - Status Bubbles — Auto-craft 9 nuggets into ingots, 9 ingots/gems into blocks (can be disabled) - Status Bubbles — 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