Maid Builder

Let your maids build it for you.

Maid Builder is an add-on for Touhou Little Maid. Place a blueprint in your world, give your maid the materials, and she will build the whole thing block by block. She fetches missing materials from chests, puts up scaffolding to reach high places, and works together with other maids.

🎉 Version 1.0.0 is out! This release adds a material list screen, vanilla .nbt structure support, an in-game settings screen and shader support, and makes the Blueprint Quill much easier to use. We still recommend backing up large worlds before you start.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.219 or newer
• Touhou Little Maid 1.5.3 or newer (the only required dependency)

Litematica / Forgematica are not required. Maid Builder reads .litematic files and vanilla structure block .nbt files on its own, so you can use blueprints you already have.

Features

🏗️ Builder maid task

• Adds a new maid task: Builder.
• Maids place blocks in a sensible order: solid blocks first, then attached blocks (torches, doors, beds, redstone, plants…), and gravity blocks last. Each pass goes from the bottom up.
• Rotation and mirroring are handled correctly, including stairs, doors, beds and redstone components.

👻 Blueprint preview

• The Blueprint Wand shows a semi-transparent ghost preview of the blueprint in the world.
• Move, rotate and mirror the blueprint with hotkeys before you confirm.
• Wrong blocks are outlined in red. Blocks that can't be previewed as a model (chests, beds…) are outlined in light blue.
• Shader support: with an Iris shader pack, the preview stays clearly see-through instead of being lit like real blocks. Tested with BSL and Complementary Unbound.

📋 Material list NEW

• Right-click the air with the wand (or press B) to open the material list: every material the blueprint needs.
• It checks your inventory, material chests and the maids' inventories for you:
  • ✔ Enough: ticked and dimmed
  • Partly there: yellow, e.g. 32 / 64
  • None: red
• Hover a row to see how much each source has. You can search the list and change the sort order.
• Works before you start: open it right after placing the blueprint to see what to gather. Blocks already in place are not counted.

📦 Material chests

• Link any chest or container to a build job. When the maid runs out of blocks, she walks over and takes what she needs.
• A double chest counts as one container.

🪜 Building high places with scaffolding

• For blocks she can't reach, the maid first looks for a path she can walk up.
• If there isn't one, she stacks scaffolding from her inventory, climbs up, builds, and takes all the scaffolding back when the job is done.
• When she needs to go higher, she extends the column from the top instead of climbing down and back up. Tall builds finish up to 33% faster.
• If she has no scaffolding at all, she lets you know and builds other blocks in the meantime.

👭 Multiple maids

• Several maids can work on the same build job. They share the materials evenly, spread out across each layer, and put up their own scaffolding columns without getting in each other's way.
• In our tests, 3 maids finished about 2.4–3.2 times faster than 1 maid.
• A maid who joins late can take a share of the materials from a teammate who has more.

🏠 Large buildings

• In Home Mode, the maid can leave her normal TLM work area while she builds, so she won't be teleported back to her work point. Her original work area comes back automatically when the job is done. You don't need to change any TLM settings.

✒️ Create blueprints in-game IMPROVED

• Use the Blueprint Quill to select an area and save it as a .litematic file. You can then place it right away with the Blueprint Wand.
• One click selects a whole building: connected building blocks are found automatically, overhangs included. Terrain such as grass, dirt, natural stone and leaves is left out.
• Corners in the air: mark a corner a few blocks in front of you where there is no block to click.
• Resize the selection: PgUp / PgDn push out or pull in the face you are pointing at.
• Only blocks are saved. Chest contents, sign text and entities are not saved.

🌐 Multiplayer

• On a dedicated server, blueprints are uploaded from your client automatically. You don't need to copy files to the server.
• Build jobs are saved with the world and keep going after a server restart.
• Maids place blocks through the normal block placement event, so land-claim and protection mods can block them.

Getting Started

1. Get the items

2. Place a blueprint

1. Put your .litematic or .nbt files in the schematics/ folder of your game directory (the same folder Litematica uses).
   • Structure block saves are in <world>/generated/minecraft/structures/. Just copy them over.
2. Hold the Blueprint Wand:
   • Right-click the air: open the file list and choose a blueprint. A preview appears.
   • Right-click a block: move the origin onto that block face.
   • R rotate, M mirror, arrow keys move, PgUp / PgDn move up and down (you can change these in Controls).
   • B: material list, so you know what to gather.
   • Sneak + right-click: confirm and create the build job.

3. Start building

With a linked wand:

• Right-click your maid: she takes the job and switches to the Builder task.
• Right-click a chest or other container: add it as a material chest, or remove it.
• Right-click the air (or press B): open the material list to see what is still missing.
• Sneak + right-click twice: cancel the job. The maid stops and takes down her scaffolding. For a finished job, one click is enough to unlink the wand.

4. Make your own blueprints (Blueprint Quill)

• Right-click a building: select all of it. A gold box means it is not confirmed yet.
  • Resize it, or right-click the air → confirm (right-clicking the air opens the save screen right away)
  • Sneak + right-click → pick corners by hand: the clicked block becomes the first corner, then choose the second
• Right-click terrain or the air: mark a corner.
• PgUp / PgDn: push out / pull in the face you are pointing at (hold Shift for 5 blocks).
• Right-click the air: name and save the blueprint. Sneak + right-click: clear.

Tips:

• Turn on the maid's Home Mode, and keep the material chests inside her work area (TLM's default radius is 12). Without Home Mode, she only builds blocks within 16 blocks of you.
• Give her some scaffolding if the building is tall.

Commands

Settings NEW

Open Main menu or pause menu → Mods → Maid Builder → Config. Every option has a description.

• Client settings: HUD on/off, preview opacity, preview distance, red outlines for wrong blocks, bounding box, and shader overlay mode. These also work on multiplayer servers.
• Server settings: placement reach, fluid placement, retry count, material chest distance, pathfinding margin, scaffolding on/off and maximum scaffolding height, and the upload and capture size limits.
  • In single player, change them right in the settings screen.
  • On a multiplayer server, the server admin edits <world>/serverconfig/maidbuilder-server.toml.

Current Limitations

• Maids do not break blocks that are already there and wrong. These are only marked red for you to fix.
• Block entity data (such as sign text) is not applied. Chests are placed empty. Container contents are never copied, so this can't be used to duplicate items.
• The Blueprint Quill tells terrain apart by block type. Parts built from natural stone or dirt may be left out, and a connected tree trunk or neighboring building may be included. Resize the selection to fix it.

Planned

• Removing wrong blocks
• Applying safe block entity data (signs, banners)

License & Credits

• All Rights Reserved.
• Maid Builder is an unofficial add-on. It is not affiliated with Touhou Little Maid or Litematica.
• Touhou Little Maid is by TartaricAcid and contributors. Its art assets are licensed under CC BY-NC-SA 4.0.
• This mod contains no code from Litematica or Forgematica. It only reads their file format.

Found a bug or have a suggestion? Please leave a comment or open an issue. Thank you to everyone who sent feedback!

Maid Builder（女僕建造）

蓋房子這種事，交給女僕就好。

Maid Builder 是 Touhou Little Maid（車萬女僕） 的附屬模組。在世界中放好藍圖、把材料交給女僕，她就會一格一格把整棟建築蓋出來。缺料時她會自己去箱子拿，太高搆不到就自己搭鷹架，還能和其他女僕一起分工合作。

🎉 正式版 1.0.0 推出！ 新增材料清單畫面、原版 .nbt 結構檔支援、遊戲內設定畫面、光影相容，並大幅改良藍圖羽毛筆的框選方式。在大型存檔中使用前，仍建議先備份世界。

需求

• Minecraft 1.21.1
• NeoForge 21.1.219 以上
• Touhou Little Maid 1.5.3 以上（唯一必要的前置模組）

不需要安裝 Litematica / Forgematica。本模組自己讀取 .litematic 和原版結構方塊的 .nbt 檔案，你手邊現有的藍圖都可以直接使用。

功能特色

🏗️ 「建築師」女僕任務

• 新增女僕任務：建築師。
• 依合理的順序放置方塊：先放實心方塊，再放需要依附的方塊（火把、門、床、紅石、植物等），最後放重力方塊；每一輪都由下往上蓋。
• 支援旋轉與鏡像，樓梯、門、床、紅石元件的方向都會正確轉換。

👻 藍圖預覽

• 手持藍圖魔杖時，世界中會顯示半透明的藍圖預覽。
• 確認前可以用快捷鍵移動、旋轉、鏡像藍圖。
• 放錯的方塊以紅框標示；箱子、床等無法顯示模型的方塊以淺藍框標示。
• 支援光影：使用 Iris 光影包時，預覽依然清楚、維持半透明，不會被光影照得像真的方塊。已用 BSL 與 Complementary Unbound 測試。

📋 材料清單 新

• 魔杖對空處右鍵（或按 B）打開材料清單，列出整個藍圖需要的所有材料。
• 自動比對背包、材料箱、女僕身上的材料：
  • ✔ 足夠：打勾並變暗
  • 部分足夠：黃色顯示，例如 32 / 64
  • 完全沒有：紅色顯示
• 滑鼠移到某一列上，可以看到各個來源分別有多少；清單可以搜尋，也可以切換排序。
• 開工前也能看：藍圖放好、還沒確認時就能打開，先知道要準備多少材料，已經放好的方塊不會重複計算。

📦 材料箱

• 可以把任何箱子或容器連結到建造工作，女僕材料用完時會自己走過去拿需要的方塊。
• 大箱子只算一個容器。

🪜 搭鷹架蓋高處

• 遇到搆不到的方塊，女僕會先找能走上去的路。
• 找不到路時，她會用背包裡的鷹架往上搭、爬上去蓋，完工後把鷹架全部收回。
• 需要更高時，她會直接在鷹架頂端往上接，不用先爬下來再爬上去。蓋高樓時最多快 33%。
• 完全沒有鷹架時，她會通知你，並先去蓋其他方塊。

👭 多女僕協作

• 多隻女僕可以一起做同一份建造工作：材料平均分配、在同一層各自分散，各自搭鷹架也不會互相卡住。
• 實測 3 隻女僕的速度約為 1 隻的 2.4～3.2 倍。
• 後來才加入的女僕，可以向身上材料較多的隊友分一些材料。

🏠 大型建築

• 開啟家模式時，女僕在建造期間可以離開 TLM 原本的工作範圍，不會被傳送回工作點；完工後自動恢復原本的工作範圍，不需要調整任何 TLM 設定。

✒️ 在遊戲中建立藍圖 改良

• 用藍圖羽毛筆框選區域，存成 .litematic 檔，存好後可以直接用藍圖魔杖放置。
• 對建築點一下就框選整棟：自動找出相連的建築方塊，突出的部分也會包含；草、泥土、天然石頭、樹葉等地形不會算進去。
• 在空中標記角落：沒有方塊可以點的位置，也能在視線前方標記角落。
• 推拉選區：用 PgUp / PgDn 把指著的那一面往外推、往內拉，微調範圍。
• 只保存方塊，不保存箱子內容、告示牌文字與實體。

🌐 多人連線

• 在專用伺服器上，藍圖會自動從你的客戶端上傳，不需要手動把檔案放到伺服器。
• 建造工作會跟著世界存檔，伺服器重啟後可以繼續。
• 女僕放置方塊時會觸發一般的放置事件，領地保護類模組可以正常阻擋。

快速上手

1. 取得道具

2. 放置藍圖

1. 把 .litematic 或 .nbt 檔放到遊戲目錄的 schematics/ 資料夾（和 Litematica 使用同一個資料夾）。
   • 結構方塊存的 .nbt 檔在 <世界>/generated/minecraft/structures/，複製過來即可。
2. 手持藍圖魔杖：
   • 對空氣右鍵：開啟選檔畫面，選擇藍圖後會出現預覽。
   • 對方塊右鍵：把原點移到該方塊的表面上。
   • R 旋轉、M 鏡像、方向鍵前後左右移動、PgUp / PgDn 上下移動（可在「控制」設定中修改）。
   • B：材料清單，先確認要準備多少材料。
   • 潛行 + 右鍵：確認並建立建造工作。

3. 開始建造

使用已連結工作的魔杖：

• 右鍵自己的女僕：她會接下這份工作，並切換成「建築師」任務。
• 右鍵箱子等容器：加入或移除材料箱。
• 對空處右鍵（或按 B）：打開材料清單，看看還缺什麼。
• 潛行 + 右鍵兩次：取消工作，女僕會停工並拆掉已搭的鷹架。已完成的工作按一次即可解除連結。

4. 建立自己的藍圖（藍圖羽毛筆）

• 對建築右鍵：自動框選整棟，以金色框表示待確認。
  • 推拉選區，或對空氣右鍵 → 確認（對空氣右鍵會直接打開存檔畫面）
  • 潛行 + 右鍵 → 改為手動：剛才點的方塊當第一個角落，再選第二個角落
• 對地形或空氣右鍵：標記角落。
• PgUp / PgDn：推拉指著的那一面（按住 Shift 一次 5 格）。
• 對空氣右鍵：輸入檔名並儲存。　潛行 + 右鍵：清除。

小提示：

• 建議開啟女僕的家模式，並把材料箱放在她的工作範圍內（TLM 預設半徑 12 格）。沒開家模式時，她只會蓋你身邊 16 格內的方塊。
• 建築比較高時，記得給她一些鷹架。

指令

設定 新

在主選單或暫停選單 →「模組」→ Maid Builder →「設定」就能調整，每個選項都有說明。

• 客戶端設定：HUD 開關、預覽不透明度、預覽顯示距離、錯誤方塊紅框、範圍框、光影相容模式。多人伺服器上也能改。
• 伺服器設定：放置距離、是否放置流體、重試次數、材料箱距離、找路範圍、是否使用鷹架與鷹架最高高度，以及上傳和擷取的大小上限。
  • 單人世界可以直接在設定畫面修改。
  • 多人伺服器請由管理員編輯 <world>/serverconfig/maidbuilder-server.toml。

目前的限制

• 女僕不會拆除原本就在、但放錯的方塊，只會用紅框標出來讓你處理。
• 不套用方塊實體資料（例如告示牌文字），箱子會放成空的。容器內容永遠不會被複製，所以不能用來複製物品。
• 藍圖羽毛筆的自動框選是依方塊種類判斷地形：用天然石頭或泥土蓋的部分可能被漏掉，相連的樹幹或其他建築可能被框進來，可以用推拉選區調整。

未來計畫

• 拆除放錯的方塊
• 套用安全的方塊實體資料（告示牌、旗幟）

授權與致謝

• 保留所有權利（All Rights Reserved）。
• 本模組為非官方附屬模組，與 Touhou Little Maid、Litematica 沒有關聯。
• Touhou Little Maid 由 TartaricAcid 及其貢獻者製作，其美術資源採用 CC BY-NC-SA 4.0 授權。
• 本模組不包含任何 Litematica / Forgematica 的程式碼，只讀取它們的檔案格式。

發現錯誤或有建議嗎？歡迎留言或回報 issue，感謝大家的回饋！