MaidsConstruct

# Maid's Construct 女仆匠魂  Maid's Construct is a Minecraft 1.20.1 Forge mod that bridges [Touhou Little Maid](https://github.com/TartaricAcid/TouhouLittleMaid) and [Tinkers' Construct](https://github.com/SlimeKnights/TinkersConstruct). ### 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