如何上手该项目

[zyy329]

请问有类似 Readme 一类简单介绍该如何上手该项目的文档吗? 要想将现有项目跑起来需要准备些什么? 我尝试直接 lua main.lua 或 lua test/test.lua 会提示 报错信息, 无法直接运行

[yuchanns]

这个游戏还在制作中，所以云大应该还没有时间介绍如何上手，构建随时可能变动，维护需要花费额外的精力不值得。
不过我这里可以给你一个可行的方案，有效性截止于我写下这个回复的时刻。

首先我假设你有最基本的计算机知识和搜索能力，否则就不用往下看了。

前置要求

• 较新的 Windows 系统
• 安装了 MSYS2
• 下载了 sokol-bin-tool 的这个版本 并把 sokol-shdc.exe 设置为全局命令(只能是这个版本，新版有 breaking changes 目前此游戏还未适配)

接下来的命令行操作都是以 MSYS2 为前提。

1. 编译 soluna

这个游戏使用的是 soluna 游戏引擎，不能直接用 lua 运行

# 克隆  soluna 仓库极其子仓库依赖
git clone --recurse-submodules https://github.com/cloudwu/soluna
cd soluna

make

这个环节你可能会遇到一些编译报错，例如 git, gcc 不存在之类的，请自行搜索如何安装这些基础依赖。我下面举个例子:

pacman -Syu mingw-w64-clang-x86_64-gcc make git

另外如果你遇到 sokol-shdc 报错说明你要么没下载正确的版本，要么是没设置成全局命令找不到。

2. 运行游戏

编译好 soluna 之后，二进制位于 soluna/bin/soluna.exe

把 C:\msys64\mingw64\bin 添加到你的环境变量的 PATH 中(否则会运行失败)。

接下来把 deepfuture clone 到本地，例如:

git clone https://github.com/cloudwu/deepfuture

假设 deepfuture 和 soluna 在同一个文件夹，那么你可以这样运行游戏:
(注意，这里是 powershell)

cd deepfuture

../soluna/bin/soluna.exe main.game

如果你运行之后没有任何反应，可能是上面说的 mingw64 依赖问题。用鼠标直接点击 soluna.exe 应该会告诉你缺少了什么 dll。

最后，祝你体验成功。

[zyy329]

非常感谢, 目前已成功编译 soluna.exe, 正在努力解决各种派生问题

[zyy329]

启动成功,过程稍有不同,记录一下:
mac机, parallels虚拟机win11(arm64)
1.编译 soluna
安装 msys2
msys2 clangarm64 环境下
i.pacman -S mingw-w64-clang-aarch64-gcc 安装 gcc(clang)
ii.pacman -S make 安装 make
将 C:\msys64\clangarm64\bin 加入 Path 环境变量
在 soluna 目录下执行 make 构建
2. 运行游戏
将soluna/bin/soluna.exe 拷贝到 deepfuture 目录下
执行 soluna.exe main.game 启动游戏

另: 没有安装 sokol-shdc.exe 也可正常游戏

[yuchanns]

sokol-shdc 是编译 soluna 用的，游戏运行阶段不需要了