computer-craft-AEspatial/README.md

# ME空间原件控制器系统

## 项目简介
这是一个用于管理Applied Energistics 2（AE2）ME空间原件的自动化控制系统。通过海龟（ComputerCraft）和红网（Rednet）实现远程控制和监控ME空间原件的切换。

## 系统架构
- **服务器端**：运行在海龟上，负责实际控制ME空间原件的切换
- **客户端**：运行在另一台计算机上，提供图形界面进行远程控制
- **简易控制端**：紧急情况下使用的简单控制程序

## 快速开始

### 1. 环境要求
服务端：
- 基础外围设备：
  - 左侧：红网调制解调器
  - 右侧：扬声器（可选）
  - 前方：AE2空间IO端口
- 海龟（任意型号）

客户端和简易控制端：
- 基础外围设备：
  - 任意：红网调制解调器

### 2. 下载安装

#### 服务器端（海龟）

```shell
wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/server/startup.lua
```

#### 客户端（控制计算机）
```shell
wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/panel/startup.lua
```

#### 简易控制端（备用）
```shell
wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/sospanel/startup.lua
```

### 3. 依赖库自动安装
程序会自动下载所需库文件：
- **utf8ptrint.lua**：UTF-8打印支持
- **basalt.lua**：图形界面库

## 配置文件编写

### 服务器端配置（海龟）

#### 配置文件位置
`config.cfg`（位于海龟的根目录）

#### 配置格式
```lua
{
    -- 当前已放出的原件 默认没有，代表没有已放出
    current_disk = "主世界基地",  -- 当前激活的原件名称
    current_slot = 1,             -- 当前原件所在的槽位
    
    -- 原件映射配置
    disks = {
        ["空间1"] = 1,      -- 格式: ["显示名称"] = 槽位编号
        ["空间2"] = 2,
        ["空间3"] = 3,
    },
    
    -- 红网端口配置
    rednet_ports = {
        listen = 101,   -- 监听端口（接收命令）
        status = 100,   -- 状态发送端口
        response = 102  -- 响应发送端口
    }
}
```

#### 配置步骤
1. 将ME空间原件放入海龟的指定槽位
2. 编辑配置文件，为每个原件设置：
   - 唯一的显示名称
   - 对应的槽位编号

#### 示例配置
假设你有以下原件：
- 槽位1：AE 工作区
- 槽位2：MEK工作区

配置文件示例：
```lua
{
    disks = {
        ["AE 工作区"] = 1,
        ["MEK工作区"] = 2,
    },
    rednet_ports = {
        listen = 101,
        status = 100,
        response = 102
    }
}
```

### 客户端配置（控制计算机）

#### 配置文件位置
`config.cfg`（位于控制计算机的根目录）

#### 配置格式
```lua
{
    -- 红网端口配置（必须与服务器端对应）
    rednet_ports = {
        control = 101,   -- 控制端口（发送命令）
        response = 102,  -- 响应接收端口
        status = 100     -- 状态接收端口
    }
}
```

### 简易控制端配置

#### 配置文件位置
`config.cfg`（位于简易控制端所在计算机的根目录）

#### 配置格式
```lua
{
    rednet_ports = {
        control = 101,   -- 控制端口
        response = 102   -- 响应端口
    },
    name = "空间1"  -- 要切换的原件名称
}
```

## 使用方法

### 服务器端（海龟）
1. 确保海龟正确放置：
   - 前方：连接AE2空间IO端口
   - 左侧：连接红网调制解调器
   - 右侧：连接扬声器

2. 放入所有ME空间原件到海龟的对应槽位

3. 启动服务器：
```shell
startup
```

4. 编辑配置文件，设置原件映射

5. 再次启动服务器：
```shell
startup
```

5. 启动后会自动：
   - 初始化红网连接
   - 加载配置文件
   - 开始监听控制命令
   - 定期发送状态更新

### 客户端（图形界面控制）
1. 确保控制计算机有可用的红网调制解调器

2. 编辑配置文件，设置正确的端口

3. 启动客户端：
```shell
startup
```

4. 界面说明：
   - 选中原件为绿色
   - 当前激活的原件显示为红色
   - 通过上下箭头或W/S键选择
   - 按Enter或空格键切换
   - 通过左右箭头或A/D键翻页

### 简易控制端（紧急使用）
1. 在任意有网卡的计算机上运行
2. 编辑配置文件，设置要切换的原件名称
3. 启动程序：
```lua
startup
```
4. 按下任意键即可切换到配置的原件

## 端口说明
| 端口 | 用途 | 方向 |
|------|------|------|
| 101 | 控制信道 | 客户端 → 服务器 |
| 102 | 响应信道 | 服务器 → 客户端 |
| 100 | 状态信道 | 服务器 → 客户端 |

如果你有多个系统，请确保每个系统的端口独立，且同一系统端口一致


## 高级功能

### 声音提示
服务器在操作时会播放声音：
- 工作中：三次提示音 警告人员离开区域
- 成功：高音提示
- 错误：低音提示

## 注意事项

1. **安全警告**
   - 确保主机处于区块加载内
   - 在切换原件时，原空间内的玩家会被送往原件内
   - 建议在无人时进行原件切换
   - 如果不幸被送入原件，可以使用简易控制端


如需进一步帮助，请提供：
- 错误截图
- 配置文件内容
- 控制台输出信息