该项目是一个基于OpenComputers的GTNH-AE2的远程控制系统,主要用于监控AE2网络、物品、流体、CPU、任务等信息,以及支持远程下单、查看任务等功能。
该项目基于RemoteOC框架开发,需要一台可公网访问的主机作为服务器,以及一台或多台OpenComputers电脑作为客户端。
- 支持查看AE2网络内的物品、流体信息
- 支持查看CPU状态
- 支持远程下单
- 支持自动化流程
- 支持监控兰波顿电容的电量和无线电网电量(需配置)
- 支持监控物品和流体存储元件的状态(需配置)
- 支持多个OC客户端
- 移动端适配
- 支持自定义任务
- 暗色模式
- 高度可定制化
client/ # OC客户端
server/ # 服务端
website/ # 网页前端
-
准备工作
- 安装
Docker
和Docker Compose
- 下载仓库中的
docker-compose.yml
和server/.env
文件
- 安装
-
修改配置
- 根据想要修改
docker-compose.yml
文件中的环境变量 - 修改
.env
文件中的环境变量
- 根据想要修改
-
启动服务
docker-compose up -d
默认前端端口为
80
,可直接访问,后端端口为8080
,可在docker-compose.yml
中修改 -
查看日志
docker-compose logs -f
-
停止服务
docker-compose down
-
准备工作
- 安装
Docker
- 安装
-
克隆源码
- 使用 Git 克隆项目到本地:
git clone https://github.com/z5882852/RemoteOC-GTNH-AE2.git
- 进入项目目录:
cd RemoteOC-GTNH-AE2/server
- 使用 Git 克隆项目到本地:
-
构建镜像
docker build -t roc-gtnh-backend .
-
运行容器
docker run -d --name roc-gtnh-backend -p 8080:8080 roc-gtnh-backend
-
查看日志
docker logs -f roc-gtnh-backend
服务器端需要安装在可公网访问的服务器上
-
准备工作
- 安装
Python3
和pip
- 安装
-
克隆源码
- 使用 Git 克隆项目到本地:
git clone https://github.com/z5882852/RemoteOC-GTNH-AE2.git
- 进入项目目录:
cd RemoteOC-GTNH-AE2/server
- 使用 Git 克隆项目到本地:
-
安装依赖
pip install -r requirements.txt
-
修改配置
- 根据需要修改
.env
文件中的环境变量 - 根据需要修改
config.py
文件中的配置
- 根据需要修改
-
运行服务
python run.py
指定端口运行服务
python run.py --port 8080
OC客户端需要安装在游戏内的OC电脑上
-
注意事项
配置要求:
- CPU:
T3 CPU
或T3 APU
- 内存:
2 x T3.5内存
(推荐使用T4服务器
安装4 x T3.5内存
) - 扩展卡:
因特网卡
- 扩展:
适配器
- 其他: 根据实际情况调整
当AE终端物品种类超过1000种时请使用
4 x T3.5内存
,超过2000种时请使用创造模式内存
,否则会内存溢出导致无法获取物品数据。具体多少种没进行测试,能跑起来就行
- CPU:
-
准备工作
- 组装好 OC 电脑
- 安装 OpenOS 操作系统
- 安装因特网卡
- 连接适配器
- 将ME接口或ME控制器紧邻适配器
- 使用分析器获取ME接口或ME控制器的地址
-
安装程序安装
- 下载安装程序
wget https://raw.githubusercontent.com/z5882852/RemoteOC-GTNH-AE2/main/client/setup.lua
- 安装客户端
setup.lua
-
直接安装(当raw.githubusercontent.com无法访问时)
- 下载或克隆项目至本地
- 将
client
目录内所有文件上传至你的 OC 电脑
-
修改
env.lua
文件- 将
env.lua
中的baseUrl
修改为你的后端地址 - 将
env.lua
中的serverToken
修改为你的服务端令牌 - 将
env.lua
中的address
修改为你的ME接口或ME控制器的地址
- 将
-
选择扩展插件(可选)
- 可选插件目录为
client/optional_plugins/{插件名}
- 该目录下会有
lib
和plugins
两个文件夹,分别对应插件依赖库和插件本体 - 将插件目录下的
lib
内的文件上传至client/lib
目录 - 将插件目录下的
plugins
内的文件上传至client/plugins
目录 - 根据插件的说明修改插件本体文件
- 可选插件目录为
-
运行客户端
输入以下命令运行客户端
run.lua
DEBUG模式运行
run.lua --debug
如果您希望快速部署前端,可直接使用打包好的文件,无需进行源码构建。
-
下载 Releases 文件
- 访问项目的 Releases 页面:🔗 GitHub Releases
- 下载最新版本的
RemoteOC_frontend-x.x.x_GTNH-2.x.0.tar.gz
文件(或类似文件名的构建包)。
-
上传到服务器
- 将压缩包文件上传到您的服务器(如 Nginx、Apache、或者其他静态资源服务器)。
- 解压文件。
-
配置服务器
-
访问网页
- 使用浏览器访问部署的域名。
-
环境要求
- Node.js: 推荐版本 16.x 或以上
- npm 或 yarn: 用于安装依赖
- Git: 用于克隆项目
-
克隆源码
- 使用 Git 克隆项目到本地:
git clone https://github.com/z5882852/RemoteOC-GTNH-AE2.git
- 进入项目目录:
cd RemoteOC-GTNH-AE2/website
- 使用 Git 克隆项目到本地:
-
安装依赖
- 使用 npm:
npm install
- 或使用 yarn:
yarn install
- 使用 npm:
-
构建项目
- 运行以下命令以生成静态文件:
npm run build
- 构建完成后,静态资源将位于
dist/
目录中。
- 运行以下命令以生成静态文件:
-
部署静态资源
- 将
dist/
文件夹中的文件上传到您的服务器(如 Nginx、Apache 或其他静态资源服务器)。 - 配置服务器。
- 重启服务器后,访问您的域名即可。
- 将
- 由于项目是单页面应用程序(SPA),请确保服务器配置了路径重写规则(如 Nginx 中的
try_files $uri /index.html
)。
- 监控兰波顿电容的电量和无线电网电量
- 统计物品和流体存储元件的状态
- ME驱动器需要使用存储总线组成SSD阵列, 且物品元件与流体元件需要分开(即2个子网络)
- 将适配器连接到2个子网的ME控制器/ME接口上
- 将适配器连接到兰波顿库电容上
- 修改
AE2StorageUsage.lua
文件中代理地址分别为物品、流体的ME控制器/ME接口地址 - 修改
powerMonitor.lua
文件中代理地址为兰波顿电容库地址 - 在网页前端的
设置
中启用监控页面
https://github.com/z5882852/RemoteOC