diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/lang/en_us.json b/projects/1.21/assets/mystian-apiary/mystianapiary/lang/en_us.json
new file mode 100644
index 000000000000..a86558c1b3eb
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/lang/en_us.json
@@ -0,0 +1,22 @@
+{
+  "block.mystianapiary.input_block": "Apiary Bee Box",
+  "block.mystianapiary.output_block": "Apiary Storage",
+  "block.mystianapiary.flower_block": "Apiary Flower Box",
+  "block.mystianapiary.upgrade_block": "Apiary Controller",
+
+  "creativetab.mystianapiary": "Mystian Apiary",
+
+  "jei.mystianapiary.category": "Mystian Apiary",
+
+  "screen.mystianapiary.status.all_present": "All modules present!",
+  "screen.mystianapiary.status.too_many": "Too many modules detected!",
+  "screen.mystianapiary.status.missing": "Missing modules!",
+
+  "tooltip.mystianapiary.only_processing": "Only Processing: %1$s / %2$s",
+  "tooltip.mystianapiary.upgrade.count": "Count: %1$s/%2$s",
+  "tooltip.mystianapiary.upgrade.time_multiplier": "Time multiplier: x%1$s",
+  "tooltip.mystianapiary.upgrade.output_multiplier": "Output multiplier: x%1$s",
+  "tooltip.mystianapiary.upgrade.installed": "Installed: %1$s",
+  "word.mystianapiary.yes": "Yes",
+  "word.mystianapiary.no": "No"
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/lang/zh_cn.json b/projects/1.21/assets/mystian-apiary/mystianapiary/lang/zh_cn.json
new file mode 100644
index 000000000000..f4ff99eee61f
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/lang/zh_cn.json
@@ -0,0 +1,22 @@
+{
+  "block.mystianapiary.input_block": "蜂箱组蜜蜂盒",
+  "block.mystianapiary.output_block": "蜂箱组仓储箱",
+  "block.mystianapiary.flower_block": "蜂箱组采蜜盒",
+  "block.mystianapiary.upgrade_block": "蜂箱组控制器",
+
+  "creativetab.mystianapiary": "Mystian Apiary",
+
+  "jei.mystianapiary.category": "Mystian Apiary",
+
+  "screen.mystianapiary.status.all_present": "模块齐备！",
+  "screen.mystianapiary.status.too_many": "检测到过多模块！",
+  "screen.mystianapiary.status.missing": "缺失模块！",
+
+  "tooltip.mystianapiary.only_processing": "当前处理数量：%1$s / %2$s",
+  "tooltip.mystianapiary.upgrade.count": "数量：%1$s/%2$s",
+  "tooltip.mystianapiary.upgrade.time_multiplier": "速度倍率：x%1$s",
+  "tooltip.mystianapiary.upgrade.output_multiplier": "产量倍率：x%1$s",
+  "tooltip.mystianapiary.upgrade.installed": "已安装：%1$s",
+  "word.mystianapiary.yes": "是",
+  "word.mystianapiary.no": "否"
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/categories/multiblock.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/categories/multiblock.json
new file mode 100644
index 000000000000..c9cc43c81d6d
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/categories/multiblock.json
@@ -0,0 +1,5 @@
+{
+  "name": "Apiary Essentials",
+  "description": "How to build and use the Mystian Apiary multiblock structure.",
+  "icon": "minecraft:beehive"
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/modules.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/modules.json
new file mode 100644
index 000000000000..51f18bd00619
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/modules.json
@@ -0,0 +1,36 @@
+{
+  "name": "Modules",
+  "icon": "mystianapiary:input_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:input_block",
+      "title": "Input Module",
+      "anchor": "input",
+      "text": "Place filled Productive Bees bee cages here to run bees inside the apiary. Each input slot processes against a matching flower from the Flower Module."
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:flower_block",
+      "title": "Flower Module",
+      "anchor": "flower",
+      "text": "Provide flowers or valid blocks for your bees. Different bees require different flowers or blocks (same rules as Productive Bees). The apiary pairs each input slot with a flower slot when producing."
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:output_block",
+      "title": "Output Module",
+      "anchor": "output",
+      "text": "Collect the produced items here. The apiary distributes results across available output slots and stacks, respecting space."
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:upgrade_block",
+      "title": "Upgrade Module",
+      "anchor": "upgrade",
+      "text": "Accepts Productive Bees upgrades (e.g., base time, productivity, comb block upgrades). Effects are applied to apiary processing while keeping PB rules."
+    }
+  ]
+}
+
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/multiblock_structure.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/multiblock_structure.json
new file mode 100644
index 000000000000..12b5c89205da
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/multiblock_structure.json
@@ -0,0 +1,61 @@
+{
+  "name": "Apiary Structure",
+  "icon": "minecraft:honeycomb_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:text",
+      "title": "Overview",
+      "text": "The Mystian Apiary is a 3x3x3 multiblock that extends Productive Bees hives. Build a sturdy frame, place a honeycomb-based core at the center, and attach the four side modules: Input, Flower, Output, and Upgrade."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Core",
+      "text": "Use any item from the tag mystianapiary:apiary_core as the Apiary core."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Frame",
+      "text": "Build the frame from any block in the tag mystianapiary:apiary_frame."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Modules",
+      "text": "Learn more about each module: $(l:mystianapiary:modules#input)Input$(), $(l:mystianapiary:modules#flower)Flower$(), $(l:mystianapiary:modules#output)Output$(), $(l:mystianapiary:modules#upgrade)Upgrade$()."
+    },
+    {
+      "type": "patchouli:multiblock",
+      "name": "Apiary Multiblock",
+      "visualize": true,
+      "multiblock": {
+        "pattern": [
+          [
+            "LLL",
+            "LLL",
+            "LLL"
+          ],
+          [
+            "LIL",
+            "FCU",
+            "LOL"
+          ],
+          [
+            "LLL",
+            "LLL",
+            "L0L"
+          ]
+        ],
+        "mapping": {
+          "L": "#mystianapiary:apiary_frame",
+          "0": "#mystianapiary:apiary_frame",
+          "C": "#mystianapiary:apiary_core",
+          "I": "mystianapiary:input_block",
+          "F": "mystianapiary:upgrade_block",
+          "O": "mystianapiary:flower_block",
+          "U": "mystianapiary:output_block"
+        },
+        "symmetrical": false
+      }
+    }
+  ]
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/operation.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/operation.json
new file mode 100644
index 000000000000..02b8b3251782
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/operation.json
@@ -0,0 +1,34 @@
+{
+  "name": "Apiary Operation",
+  "icon": "mystianapiary:input_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:spotlight",
+      "item": "productivebees:bee_cage",
+      "title": "Bee Cages",
+      "text": "The Mystian Apiary runs bees directly from Productive Bees cages. Place a filled bee cage in the Input Module. The apiary processes that bee against a matching flower or block in the Flower Module."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Per-Slot Pairing",
+      "text": "Each Input slot pairs with a Flower slot to determine outputs. If the flower/block matches the bee's requirements (same rules as Productive Bees), that slot progresses and produces items into the Output Module."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Special Bees",
+      "text": "Certain bees (like lumber, quarry, dye, and wanna) select from valid flowers/blocks dynamically. If no valid flower is available, that slot will briefly pause and retry automatically."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Automation",
+      "text": "Outputs are distributed across Output slots and will stack when possible. Use any inventory automation mod to extract from the Output Module."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Upgrades",
+      "text": "Place Productive Bees upgrades in the Upgrade Module to adjust speed and productivity. See the Upgrades entry for details."
+    }
+  ]
+}
+
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/upgrades.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/upgrades.json
new file mode 100644
index 000000000000..7257c59b74b6
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/en_us/entries/upgrades.json
@@ -0,0 +1,33 @@
+{
+  "name": "Upgrades",
+  "icon": "mystianapiary:upgrade_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:text",
+      "title": "Upgrade Module",
+      "text": "The Upgrade Module accepts Productive Bees upgrades. These apply to apiary processing while keeping PB's balance."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Speed (Base Time)",
+      "text": "Reduces the effective time per operation according to Productive Bees rules. Place in the Upgrade Module's dedicated slot."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Productivity",
+      "text": "Increases the total outputs per completion. Productivity scales in tiers following Productive Bees' upgrade levels."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Comb Block",
+      "text": "Allows producing comb blocks when applicable. The apiary recognizes these upgrades in the same way Productive Bees hives do."
+    },
+    {
+      "type": "patchouli:text",
+      "title": "Notes",
+      "text": "Exact upgrade items are provided by Productive Bees/Productive Lib. The apiary checks and applies them using the same logic as PB."
+    }
+  ]
+}
+
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/categories/multiblock.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/categories/multiblock.json
new file mode 100644
index 000000000000..1ab4b2c8269f
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/categories/multiblock.json
@@ -0,0 +1,5 @@
+{
+  "name": "蜂箱组必备知识",
+  "description": "如何搭建与使用 Mystian Apiary 蜂箱组多方块结构。",
+  "icon": "minecraft:beehive"
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/modules.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/modules.json
new file mode 100644
index 000000000000..bd88ae31d130
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/modules.json
@@ -0,0 +1,36 @@
+{
+  "name": "模块",
+  "icon": "mystianapiary:input_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:input_block",
+      "title": "输入模块",
+      "anchor": "input",
+      "text": "在此处放置装有蜜蜂的 Productive Bees 蜜蜂笼，以将蜜蜂送入蜂箱组。生产时蜜蜂盒会和采蜜盒一一配对。"
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:flower_block",
+      "title": "采蜜模块",
+      "anchor": "flower",
+      "text": "用于为蜜蜂提供有效的花卉和采蜜方块。不同蜜蜂的需求不同（与 Productive Bees 一致）。生产时，蜂箱组会将蜜蜂盒和采蜜盒一一配对。"
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:output_block",
+      "title": "输出模块",
+      "anchor": "output",
+      "text": "产物会汇集至此。蜂房组会将产物均分到各仓储箱和物品堆叠中，但过量产出会被销毁。"
+    },
+    {
+      "type": "patchouli:spotlight",
+      "item": "mystianapiary:upgrade_block",
+      "title": "升级模块",
+      "anchor": "upgrade",
+      "text": "接受 Productive Bees 的升级（如速度、产量、蜜脾块升级等）。其效果和限制均与 Productive Bees 高级蜂箱一致。"
+    }
+  ]
+}
+
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/multiblock_structure.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/multiblock_structure.json
new file mode 100644
index 000000000000..e6a6192d16e0
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/multiblock_structure.json
@@ -0,0 +1,61 @@
+{
+  "name": "蜂箱组结构",
+  "icon": "minecraft:honeycomb_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:text",
+      "title": "概览",
+      "text": "Mystian Apiary 蜂箱组是 3x3x3 的多方块结构，拓展了 Productive Bees 蜂箱的功能。先建起一个牢固的框架，再在中央放置一个以蜜脾为基底的核心，最后在四边放置模块：输入、采蜜、输出、升级。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "核心",
+      "text": "可使用带有 mystianapiary:apiary_core 标签的物品作为蜂箱组核心。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "框架",
+      "text": "可使用带有 mystianapiary:apiary_frame 标签的方块搭建框架。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "模块",
+      "text": "各模块的详细信息见此：$(l:mystianapiary:modules#input)输入$()、$(l:mystianapiary:modules#flower)采蜜$()、$(l:mystianapiary:modules#output)输出$()、$(l:mystianapiary:modules#upgrade)升级$()。"
+    },
+    {
+      "type": "patchouli:multiblock",
+      "name": "蜂箱组多方块",
+      "visualize": true,
+      "multiblock": {
+        "pattern": [
+          [
+            "LLL",
+            "LLL",
+            "LLL"
+          ],
+          [
+            "LIL",
+            "FCU",
+            "LOL"
+          ],
+          [
+            "LLL",
+            "LLL",
+            "L0L"
+          ]
+        ],
+        "mapping": {
+          "L": "#mystianapiary:apiary_frame",
+          "0": "#mystianapiary:apiary_frame",
+          "C": "#mystianapiary:apiary_core",
+          "I": "mystianapiary:input_block",
+          "F": "mystianapiary:upgrade_block",
+          "O": "mystianapiary:flower_block",
+          "U": "mystianapiary:output_block"
+        },
+        "symmetrical": false
+      }
+    }
+  ]
+}
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/operation.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/operation.json
new file mode 100644
index 000000000000..30fb3067ba20
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/operation.json
@@ -0,0 +1,34 @@
+{
+  "name": "蜂箱组操作",
+  "icon": "mystianapiary:input_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:spotlight",
+      "item": "productivebees:bee_cage",
+      "title": "蜜蜂笼",
+      "text": "如需为 Mystian Apiary 蜂箱组供应蜜蜂，可使用 Productive Bees 的蜜蜂笼。在蜜蜂盒中放入装有蜜蜂的蜜蜂笼即可。蜂箱组会根据采蜜盒中的花卉和采蜜用方块进行生产。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "槽位对应",
+      "text": "每个输入槽都会与一个采蜜槽对应，以决定实际产出。如果花卉/方块符合蜜蜂的需求（与 Productive Bees 一致），即会使用该槽位进行生产，并将产物送至仓储箱。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "特殊蜜蜂",
+      "text": "部分蜜蜂（如木场蜜蜂、石料蜜蜂、染料蜜蜂、抽蜂等）会动态选择有效的花朵/方块。如果没有有效花朵，蜜蜂对应槽位会短暂暂停，而后自动重新检测。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "自动化",
+      "text": "输出会均分到各输出槽中，且会优先合并堆叠。可使用容器自动化模组从仓储箱中抽出物品。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "升级",
+      "text": "在控制器中放置 Productive Bees 升级可修改蜂箱组的速度和产量。细节请参阅升级条目。"
+    }
+  ]
+}
+
diff --git a/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/upgrades.json b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/upgrades.json
new file mode 100644
index 000000000000..093b258b2264
--- /dev/null
+++ b/projects/1.21/assets/mystian-apiary/mystianapiary/patchouli_books/apiary_book/zh_cn/entries/upgrades.json
@@ -0,0 +1,33 @@
+{
+  "name": "升级",
+  "icon": "mystianapiary:upgrade_block",
+  "category": "mystianapiary:multiblock",
+  "pages": [
+    {
+      "type": "patchouli:text",
+      "title": "升级模块",
+      "text": "控制器接受 Productive Bees 的升级。升级效果作用于蜂箱组的生产流程，也同时保留了 Productive Bees 的平衡限制。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "速度",
+      "text": "按照 Productive Bees 的规则缩短每次产出的耗时。应放在控制器的升级专用槽位中。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "产量",
+      "text": "增加每次产出的总产量。各等级升级的产量倍率与 Productive Bees 一致。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "蜜脾块",
+      "text": "若可行，则直接产出蜜脾块。和 Productive Bees 的蜂箱一样，蜂箱组也接受此升级。"
+    },
+    {
+      "type": "patchouli:text",
+      "title": "注意事项",
+      "text": "升级本身由 Productive Bees/Productive Lib 提供。蜂箱组检查升级的方式与 Productive Bees 一致。"
+    }
+  ]
+}
+