Celestia 中文文档 下载 App

LuaHook 配置：让 Celestia 启动时自动加载 Lua 环境

什么是 celestia.cfg

celestia.cfg 是 Celestia 的全局配置文件——所有渲染选项、添加件搜索路径、LuaHook 入口都在这里定义。

位置：

备份再改

编辑前一定要先复制一份备份。Celestia 对配置错误不会友好提示——写坏了直接启动崩溃或渲染异常。

最常用的三项配置

1. LuaHook 入口

告诉 Celestia 启动时加载哪个 Lua 初始化文件。Celestia 自带了一个默认空钩子，Motherlode 上的 LUT（Lua Universal Tools）会要求改成它自己的入口：

# 找这一行，改成：
LuaHook "luahookinit.lua"

LUT 的 README 会告诉你具体要改成什么路径。改完后把对应的 .lua 文件放进 Celestia 根目录。

2. 添加件搜索路径

Celestia 默认只在 extras/ 目录下搜索添加件。可以手动指定多个目录：

ExtrasDirectories ["extras" "my-custom-addons" "D:/CelestiaAddons"]

多个路径用空格分开，Celestia 会按顺序扫描。最后一个路径优先级最高（同名文件后扫的覆盖先扫的）。

3. 快捷键绑定

Celestia 的快捷键全在配置里：

Action ["SelectBody" "H"]          -- H 键执行 SelectBody
Action ["FollowSelected" "F"]      -- F 键执行 FollowSelected
Action ["Quit" "Escape"]           -- Esc 键执行 Quit

改完后重启 Celestia 生效。

常见配置示例

加星空照片作为背景

BackgroundImage "D:/space-background.jpg"
BackgroundImageOpacity 0.8

启用 HDR 渲染

HDRRendering true
Exposure 0.5
Bloom true
BloomStrength 0.3

限制最大 GPU 内存使用（老显卡有用）

MaxTextureSize 2048          -- 限制贴图最大尺寸
CacheSize 1024               -- 贴图缓存 MB

配置错误排查

Celestia 读取配置失败时，常见症状：