Myriad Armory

Your equipment, organized into loadouts and ready with a hotkey.

Myriad Armory (万象武库) adds a personal equipment vault, inventory-based loadout recording, quick switching, and optional administrator-defined equipment set bonuses. It is a standalone mod for Minecraft 1.21.1 with NeoForge 21.1.251 or newer in the 21.1 series, using Java 21.

What you can do

• Keep a personal armory: open a chest-style vault from the management screen or a configurable hotkey. Store and retrieve real items, retain faded out-of-stock records, and refill matching records.
• Record the inventory you arranged: use the vanilla inventory with a green slot overlay. Right-click slots to include or exclude them; left-click moves real items normally. Confirm saves the layout. Closing only cancels recording; inventory movements already made remain.
• Switch loadouts quickly: tap R for the next loadout, or hold it for 1 second to open the radial selector. The default is 5 loadouts, 54 vault records, and a shared 1-second switching cooldown. Independent hotkeys for the first five loadouts are available and unbound by default.
• Reuse your actual equipment: multiple loadouts can reference the same original item. Renaming, enchanting, or repairing it does not create a copy. Missing items are skipped; items in external chests cannot be retrieved remotely. If returning displaced items would exceed vault capacity, the switch is cancelled.
• Create optional equipment sets: administrators can select item templates, customize matching details such as enchantments and armor trims, and define piece-count bonuses. Sets work on matching equipped items independently of loadout records. Direct attribute bonuses (such as +1 attack damage) and potion effects are supported, with compact hover information and Shift details.

Getting started

1. Install the matching version on both the server and every client, or in your single-player instance.
2. Press G to open management, then record a loadout or open the vault.
3. Arrange your inventory, right-click the slots you want recorded, and confirm.
4. Store equipment through the vault or the loadout deposit action, then use R to switch.

Right-click is reserved for the recording/retention overlay in these two interfaces; normal right-click splitting and distribution are temporarily disabled there. An included empty slot requests an empty slot when switching; an excluded slot keeps its current item.

Configuration and permissions

Open Mods → Equipment Vault → Config for client preferences, server rules, and set bonuses. The current in-game name is Equipment Vault / 装备投影库 and the mod ID is equipment_vault.

Client preferences and key bindings are freely configurable. Changes affecting capacity, restrictions, or abilities require permission level 2; single-player worlds must have cheats enabled. Set bonuses are disabled by default, with no predefined sets. Optional blank-equipment carrier integration is provided for pack/mod authors and is also disabled by default; no blank equipment is included.

The vault is personal storage saved with the world, not an online cloud service. Standard player inventory slots are supported; expanded slots from third-party inventory mods are not generally supported. No dependency on the original Sun/Moon project is required.

Release notes

This initial public 1.3.0 Beta includes inventory-overlay recording, chest-style storage, loadout switching, and independent server-wide set definitions. Automated gameplay tests and the build have passed; the newest configuration/editor screens have not yet completed manual gameplay acceptance testing. English and Simplified Chinese are included.

Development disclosure: AI tools assisted development and documentation. The project logo is original symbolic artwork, not a gameplay screenshot. License: All Rights Reserved.

万象武库 · 中文介绍

个人装备库、物品栏方案记录与按键换装系统，支持管理员自定义独立套装效果。适用于 Minecraft 1.21.1 / NeoForge 21.1.251 及以上的 21.1 系列 / Java 21，多人客户端与服务端均需安装同一版本。

主要功能

• 个人装备库：像箱子一样存取真实物品，保留缺货图标与库存记录，可补充库存。这里的“云端”是存档内的个人容器，不是联网云服务。
• 物品栏记录：在原版物品栏上加绿色蒙版，右键选择记录格，左键正常整理实物，确认后保存。关闭仅结束记录，已经移动的物品不会回滚。记录空格表示调用时留空，未选择的格子保持原物品。
• 快捷换装：G 打开管理，R 单击下一套，长按 1 秒打开轮盘。默认 5 套、54 个库存记录格、共享 1 秒冷却；前五套独立快捷键默认不绑定。
• 真实装备引用：同一原件能供多套方案使用，不复制物品。缺货部分跳过，不能隔空取外部箱子物品；换装需要回库而容量不足时，整次操作不执行。
• 独立套装效果：管理员从物品栏选择模板，可细分附魔、纹饰等匹配条件，设置穿戴件数对应的属性加值或药水效果。匹配的装备无需加入换装方案就能生效，悬停显示进度，Shift 查看简短详情。

设置与说明

入口为 模组 → 装备投影库 → 配置，分客户端、服务端与套装效果。资源、限制、能力相关设置需要权限等级 2；单人也需开启作弊。套装效果默认关闭且没有预设套装，空白载体门槛默认关闭且不自带空白装备。

记录与库存界面中，右键优先操作蒙版，暂时禁用右键拆分和拖动分组。支持标准玩家槽位，尚未提供第三方扩展背包槽位的通用兼容。

首次公开版本为 1.3.0 Beta。自动化玩法测试与构建已通过，最新配置和编辑界面尚未完成手动游戏验收。提供英文和简体中文。项目使用 AI 工具辅助开发与文档编写；图标为原创示意图，不是游戏截图。许可证：All Rights Reserved。