高级内存卡

高级存储卡

一个应用能源2（AE2）的附属模组，通过两大主要功能强力增强AE2存储卡：批量配置复制和高级P2P隧道管理。

🌟 功能特性

🔧 两种工作模式

该模组将其状态以“模式”形式存储在物品的NBT中，您可以随时在两种模式间切换：

模式	描述
复制模式	选择一个区域，将复制的AE2设备配置一次性粘贴到区域内的所有AE2方块和部件上
配置模式（P2P隧道配置）	右键点击P2P隧道部件，打开图形界面，集中管理和配置网络中的P2P隧道

📋 复制模式

• 批量区域复制：先复制单个AE2设备的配置，然后选择两个对角方块定义区域，再对空气右键即可批量应用配置。
• 支持AE2方块和部件：区域内的所有AEBaseBlockEntity（ME控制器、接口、存储总线等）以及IPartHost上的所有部件都会被处理。
• 体积上限保护：如果区域体积超过服务器配置项maxCopyVolume（默认2048个方块），粘贴操作将被拒绝并显示提示信息，以防止意外的大范围选择导致卡顿。
• 可视化选择框：选择框实时显示颜色编码（红色 = 选择第一点 / 白色 = 选择第二点 / 绿色 = 就绪可粘贴），并对目标方块和范围外的方块显示不同颜色。
• 实时反馈：物品提示框和聊天栏会显示标记坐标、区域尺寸和已粘贴的方块数量。

🕸 配置模式（P2P隧道配置）

右键点击任意P2P隧道部件即可打开配置界面，以可视化方式管理当前AE网络中的所有P2P设备：

• P2P树状列表：自动扫描网络并按类型/频道分组显示所有P2P设备，支持展开/折叠和搜索过滤。
• 详细信息面板：选中节点后显示其类型、频率、输入/输出角色、连接状态等信息。
• 重命名 / 别名：可以为单个P2P设备设置自定义名称，或为整个频道（该频道的输入端）设置别名，方便识别。
• 绑定频率：将选中的P2P绑定到特定的4位十六进制频率（例如0A1B）。非ME P2P会自动智能判断其输入/输出角色。
• 分配新频道：为选中的非ME P2P分配一个全新的空闲频率，并一键将其设置为输入端。
• 自动配置输入/输出（仅限ME P2P）：根据ME P2P的外部网络是否连接到ME控制器，自动决定其应作为输入端还是输出端，并自动分配频率。
• 高亮与定位：在世界中高亮显示P2P隧道（自身/输入端/输出端以不同颜色渲染），可选择自动将视角转向目标，并在聊天栏发送位置信息和传送链接。
• 跨维度连接：修复了原版仅发送坐标导致跨维度P2P无法定位的问题。现在编码携带维度信息，使P2P设备能够跨维度正确定位和高亮显示。

⌨️ 模式切换

• V键（默认，可在游戏的控制设置中重新绑定）——手持高级存储卡时按下可切换模式。
• Shift + 右键——快速切换两种模式（在复制模式下，Shift + 右键执行的是原版AE2的复制操作，而非切换模式）。

📦 安装

环境要求

依赖	版本
Minecraft	1.20.1
Forge	47.4.10 或更高（加载器范围 [47,)）
应用能源2（AE2）	15.4.10 或更高（[15.4.10,)）
mixinextras	1.0.0+（可选，用于Mixin增强）

该模组在运行时还依赖Jade、GuideME和JEI（均为常见的AE2生态附属模组；建议安装以获得最佳体验）。

安装步骤

1. 从发布页面下载最新的advanced_memory_card-<版本号>.jar文件。
2. 将.jar文件放入您的Minecraft mods文件夹中。
3. 确保已安装上述必需模组。
4. 启动游戏，在“高级存储卡”创造模式标签页中找到该物品。

🛠 配置

该模组提供客户端和服务端配置文件（位于config/目录下）：

服务端配置（advanced_memory_card-server.toml）

选项	默认值	描述
maxCopyVolume	2048	复制模式允许的最大区域体积（方块数量）；超过此值的选择将被拒绝
sendHighlightToChat	true	高亮显示P2P设备时，是否在聊天栏发送位置信息和传送链接

客户端配置（advanced_memory_card-client.toml）

主要用于个性化UI和渲染外观。您可以调整：

• 高亮行为：rotateHeadOnHighlight（高亮时自动转向头部）、p2pHighlightDurationSec（高亮持续时间，1–60秒）。
• P2P树状列表组件：背景/选中/悬停颜色、缩进、行高、图标间距、频道警告阈值、最大名称长度等。
• 详细信息面板：背景、标题、标签、数值和状态（未激活 / 未连接 / 已连接）的颜色及布局尺寸。
• 通用按钮（FlatButton）：默认/悬停/按下/文字颜色。
• 复制模式选择框：起点、终点、目标点、范围外以及三种选择状态的颜色。
• P2P高亮渲染：自身/输入端/输出端颜色。
• 物品颜色：物品基础颜色和色调颜色。

所有颜色均为十六进制值（GUI类使用ARGB，渲染类使用RGB），可直接在配置文件中编辑。

📖 快速使用指南

复制模式

1. 在复制模式下手持高级存储卡，Shift + 右键点击源AE2设备以复制其配置。
2. 右键点击第一个角方块以标记起点（红色）。
3. 右键点击对角方块以标记终点（白色）；此时进入就绪可粘贴状态（绿色）。
4. 对空气右键，即可将配置批量应用到区域内的所有AE2设备上。

配置模式

1. 切换到配置模式，右键点击任意P2P隧道部件以打开配置界面。
2. 在左侧树状列表中浏览/搜索网络中的P2P设备，选中节点后在右侧查看其详细信息。
3. 使用详细信息面板中的按钮进行重命名、绑定频率、分配新频道、自动配置输入/输出、高亮与定位等操作。

🔧 开发与构建（面向开发者）

# 运行客户端（开发环境）
./gradlew runClient

# 构建发布jar包
./gradlew build

# 生成数据包 / 语言文件
./gradlew runData

• 基于Forge Gradle 6.x构建，使用Java 17工具链。
• 使用Mixin（advanced_memory_card.mixins.json）扩展AE2的P2PTunnelPart。
• 资源文件由src/main/java/.../datagen下的数据生成器生成到src/generated/resources/目录。

📄 许可证

本项目基于GNU GPL-3.0许可证开源发布。