运行报错 ( Can't load entry main.lua )

[fuzi1996]

版本: Nightly Build (2025-10-11T01-40-44)

错误日志:

[2025-10-11 17:07:48.64][INFO ]( root ) startup 1
[2025-10-11 17:07:48.64][INFO ]( timer ) startup 2
[2025-10-11 17:07:48.66][INFO ]( log ) startup 3
[2025-10-11 17:07:48.66][INFO ]( loader ) startup 4
[2025-10-11 17:07:48.66][INFO ]( start ) startup 5                          in pwsh at 17:07:48
[2025-10-11 17:07:48.66][INFO ]( gamepad ) startup 6
[2025-10-11 17:07:48.66][INFO ]( settings ) startup 7
[2025-10-11 17:07:48.66][ERROR]( start ) src/service/start.lua:80: Can't load entry main.lua
[2025-10-11 17:07:48.69][INFO ]( settings ) quit.
[2025-10-11 17:07:48.69][INFO ]( gamepad ) quit.
[2025-10-11 17:07:48.69][INFO ]( loader ) quit.

[cloudwu]

因为 Can't load entry main.lua
翻译过来就是加载时缺少 main.lua ，检查你是否提供了这个文件。

我不认为这个叫出错，它是找不到 main.lua 后的正常退出行为。不然你期待发生什么？

[yuchanns]

这是一个游戏引擎，用来编写游戏的。直接运行它会报错是正常的，你还需要给一个游戏文件。
当然，我认为体验可以做得更好一点，例如什么都没传入时，显示 help，这是一般的 cli 的逻辑。

正确的使用方法如下，你要先创建一个 main.lua:

local soluna = require "soluna"

soluna.set_window_title "Soluna Sample"

local callback = {}

function callback.frame(count)
end

return callback

然后执行这个命令 soluna entry=main.lua 就可以正常启动了。

以上取自该仓库的 test/ 文件夹中的 window.lua, 更多用法可以查看 test 文件夹。

[cloudwu]

补充一下： 命令行传入 entry=main.lua 指将 main.lua 这个字符串赋给引擎的环境 entry ，这个是游戏的启动入口文件名。

引擎的默认环境写在 https://github.com/cloudwu/soluna/blob/master/src/data/settingdefault.dl 这里，可以被覆盖。这里已经写了 entry=main.lua 作为默认值，所以命令行不写也是一致的，即默认就是用 main.lua 做启动入口。

命令行传入的文件名为环境文件，可以在里面改写环境。比如，使用 soluna test/window.game 就可以以 window.game 为环境文件启动游戏，在 test/window.game 里改写了 entry=window.lua ，就会以 test/window.lua 作为入口文件名。因为引擎会根据启动命令行的文件名所在目录切换当前目录，所以这里不需要写成 entry=test/window.lua 。

等价的命令行写法可以是 soluna entry=test/window.lua 。

[cloudwu]

我在 wiki 页面创建了相关说明：https://github.com/cloudwu/soluna/wiki

引擎文档将在 wiki 上逐步完善。