个人维度

📖 模组介绍

PersonalDimension（随身空间） 是一个《星露谷物语》模组，为玩家提供了一个无限存储空间，并且会自动将物品按类别分类存放。无论你在游戏世界的哪个角落——农场、矿井、沙漠、海岛，甚至是节日现场，都可以随时打开这个空间，轻松存取物品。

✨ 主要特性

• 无限存储空间：不受容量限制，所有物品均可存放，告别箱子不够用的烦恼。
• 自动分类存放：物品会根据其类型自动归类到对应的分类中，管理更高效。
• 一键存取：左键从空间取出整组物品，右键取出单个物品；点击背包物品即可存入空间，操作直观流畅。
• 随时随地打开：物品随身携带，右键点击即可在任何地点打开空间界面。
• 联机共享：在同一存档中，所有玩家的空间共享——你可以放进去，队友也能取出来，合作更便捷。
• 丰富分类：支持作物（含花、蜂蜜）、种子、鱼（含鱼籽）、工匠、工具、服饰、武器、家具、制造品、资源等，物品一目了然。
• 翻页与悬停：支持滚轮翻页和按钮翻页，悬停物品可查看详细信息。
• 获取方式：在耕种等级 5 后解锁配方，消耗 5 个五彩碎片 + 100 个铱锭 制作。

📦 合成配方

材料	数量
五彩碎片	5
铱锭	100

解锁条件：耕种等级 5

🎮 使用方法

1. 在背包合成界面制作「随身空间」。
2. 在背包中右键点击该物品，打开空间界面。
3. 左侧选择分类，查看对应物品。
4. 左键点击空间物品 → 整组取出；右键 → 取出单个。
5. 点击背包中的物品 → 自动存入空间并归类。
6. 使用滚轮或翻页按钮切换页面。

🌐 多语言支持

• 简体中文
• English

🎉 本次更新内容

1. 界面优化

• 物品格子背景：为空间物品添加了深色半透明背景框，视觉上更清晰，与原版背包风格统一。
• 可调整的格子布局：支持自定义每行显示的物品数量（默认12列），方便不同屏幕尺寸的玩家调整。
• 页码显示与翻页按钮：支持鼠标滚轮翻页和点击按钮翻页，并显示当前页码/总页数。
• 标签文字居中：分类按钮文字居中显示，更美观。

2. 一键操作

• 一键存入：将当前分类下所有背包物品存入空间（黑名单物品除外）。
• 一键取出：将当前分类下所有空间物品取出到背包（直到背包满）。
• 一键操作位置：一键存入按钮位于背包右上角，一键取出按钮位于空间网格右下角，互不干扰。

3. 自动存入功能

• 分类级自动存入：每个分类可独立开启自动存入（勾选框控制）。
• 佩戴戒指也可自动存入：即使不携带随身空间物品，佩戴次元戒指时自动存入功能同样生效。
• 自动存入拦截：从空间取出物品时不会触发自动存入，避免死循环。
• 黑名单拦截：黑名单中的物品不会被自动存入、一键存入或手动存入。

4. 黑名单系统

• 独立标签页：黑名单作为独立分类显示在分类列表最下方。
• 加入黑名单：切换到黑名单标签页，左键点击背包中的物品即可将其加入黑名单（仅记录信息，不消耗物品）。
• 移除黑名单：在黑名单标签页中，右键点击黑名单物品即可移除。
• 全局拦截：黑名单中的物品无法通过任何方式存入空间（自动存入、一键存入、手动存入均被拦截）。

5. 次元戒指

• 新增物品：合成配方为 4 个铱环 + 1 个随身空间，耕种等级 5 解锁。
• 佩戴效果：佩戴后可通过热键（默认 Ctrl+V）打开随身空间，无需手持随身空间物品。
• 右键使用：在背包中右键点击戒指可直接打开空间（不会装备戒指）。
• 自动存入支持：佩戴戒指时，自动存入功能同样生效（需开启对应分类的自动存入）。
• 快捷键切换：热键可开关空间菜单（再次按下热键关闭空间）。

6. 可配置热键

• 支持通过 config.json 文件自定义热键和修饰键（Ctrl/Shift/Alt）。
• 默认热键为 Ctrl+V，避免与游戏内置快捷键冲突。

7. 兼容性与优化

• 修复了物品数量重复显示的问题。
• 修复了物品框不完整的问题。
• 修复了自动存入导致物品被循环存入的问题。
• 修复了戒指右键无法打开空间的问题。
• 修复了热键被游戏拦截的问题。
• 优化了物品分类逻辑（新增服饰、资源等分类）。

🎮 按键总览

按键	功能
LB + A（同时按下）	打开个人空间菜单（快捷入口）
左摇杆 / 方向键（↑↓←→）	在当前焦点区域内移动光标
A 键	确认/执行当前高亮的操作（菜单内）
B 键	关闭菜单（返回游戏）
LT（左扳机）	切换到上一个焦点区域（循环）
RT（右扳机）	切换到下一个焦点区域（循环）
LB（左肩键）	物品网格翻页（上一页）
RB（右肩键）	物品网格翻页（下一页）

🍳 烹饪与制造界面的联动机制

在打开 烹饪界面 或 制造界面 时，模组会自动检测您的个人空间中是否有当前配方所需的材料。

• 如果背包中材料不足，系统会自动从个人空间中补充缺失的材料。
• 整个过程无需任何额外按键操作，完全自动完成。
• 您只需像往常一样选择配方并制作，模组会在后台智能处理材料来源。
• 它现在已经连接了建造空间，空间里的物品会自动满足建造要求，虽然显示是红色数字，但是是能够建造的

新增功能

1. 白名单系统

• 新增完整的白名单功能，支持白名单模式开关。
• 白名单独立于黑名单运作，可单独启用/禁用。
• 白名单模式开启时，仅白名单中的物品会被自动存入。

2. 黑白名单独立UI

• 黑名单、白名单从左侧分类列表移至右上角，以独立类别按钮呈现。
• 每个按钮配有独立的启用/禁用复选框。
• 列表操作：左键点击背包物品添加，左键/右键点击列表物品移除。

3. 自定义分类与自定义名单

• 左侧新增“自定义”分类，用于集中存放玩家指定的物品。
• 右上角新增“自定义名单”按钮，用于管理允许存入自定义分类的物品ID列表。
• 只有自定义名单中的物品才能存入“自定义”分类。
• 自定义分类支持独立的自动存入复选框。

4. 搜索功能

• 空间网格左上角新增搜索框。
• 支持按物品名称或ID实时过滤。
• 按 ESC 键清空搜索框。
• 搜索框带装饰边框和占位提示，支持多语言。

5. 一键存取同类物品

• 键盘：按住 Ctrl + 左键点击空间物品 → 取出所有同类物品；点击背包物品 → 存入所有同类物品。
• 手柄：按 X 键执行同类存取（空间网格焦点下取出，背包焦点下存入）。

6. 多语言支持

• 所有新增UI文案均已添加中英文翻译。