英灵神殿 1.0-1.0.16 摄影引擎：精确镜头定位、无人值守 4K 拍摄、天气控制及凭证回执。

自拍杆

画廊合成与便携式本地截取功能已作为0.3.2候选版本提供。详见 捕获契约、证据及最初的存档隔离事件 和 提取出的运行程序说明画廊和创作者/主持人现在允许用户创作一张存档世界的静态图像，并下载精确的 自拍杆拍摄/v1 包，并从匹配的存档中在本地渲染其PNG。该包会验证存档与依赖项，使用一次性世界/角色副本，测量实际镜头/视场角/尺寸并记录还原情况。本地0.3.2验证覆盖OMEN和AM4；随后将进行干净修订版的发布推广和公开下载。 舰队计划.

《英灵神殿》自动 4K 摄影相机引擎：亚厘米级姿态精度、光照与天气控制，以及用于世界存档的加密证明回执。

---

兼容性： 英灵神殿 1.0.0-1.0.16；最新构建、反射面及隔离启动验证已在 1.0.16 上完成。请参阅 舰队兼容性证据.

---

---

---

📑 目录

• 🎯 起源与这个模组存在的原因
  • 🌐 实时公开展示画廊
  • 📖 摄影随笔（背景与设计）
• 🏗️ 视觉系统架构（Archify）
• ⚡ 核心特色
  • 1. 无人值守无头摄影
  • 2. 亚厘米级相机装置与光学系统
  • 3. 氛围、太阳角度与闪光扫掠
  • 4. 稳定与物理沉降引擎
  • 5. 英灵神殿 1.0 无头盾
  • 6. 连续进料模式（热循环）
  • 7. 密码学证明收据
  • 8. 交互式控制台命令行套件
• 🎮 快捷键与命令行速查
• ⚙️ 配置与接入参考
• 💻 游戏内控制台命令（F5)
• 🔬 硬件验证（OMEN 装备）
• 📋 更新日志
• 📦 安装指南
• 🛠️ 从源码构建
• 📄 许可证

---

🎯 起源与制作这个模组的原因

英灵神殿社区服务器生成庞大的世界，跨越多年承载数百万个物体。要以照片级精度记录并保存这些建筑成就，需要将摄像机定位到亚厘米级精度，锁定统一的太阳角度和天气状态，等待地形LOD和物理效果稳定下来，并通过加密方式证明每一帧的确切坐标。

自拍杆 （由底层技术支持 CameraProof.dll 插件引擎）是开发的自动捕获和遥测工具，用于拍摄瓦尔海姆时代档案馆。

🌐 实时公开展示画廊

查看这款摄影引擎的实时运行效果：

• 维京纪元档案公共画廊：数千张4K照片，附带可点击的3D场景相机链接、俯仰/偏航遥测数据以及精确的镜头参数记录。
• 创作者与建造者数据：空间构建聚类、贡献者亲缘关系，以及全面的构建者目录归属。

📖 摄影随笔（背景与设计）

阅读三部分随笔系列，了解引擎背后的技术与艺术历史：

1. 第1部分： 拍摄一个无人驻足观看的世界 — 在数百万物体的存档中自动运行摄像机。
2. 第二部分： 站在建造者曾站过的地方 ——逆向分析优势点位、玩家路径和建筑视线。
3. 第三部分： 他们为之点亮的 ——控制天气、太阳方位和光照扫描，以创作者原本设想的方式捕捉建筑。

---

🏗️ 视觉系统架构（Archify）

Archify 验证展示图，说明无人值守启动、相机装置机制、天气同步和加密回执流程：

👉 打开实时交互式 Archify 图表 （深色/浅色主题、引导式视图检查和节点可达性）

---

⚡ 核心特色

1. 无人值守无头摄影

将运行器指向世界存档和角色。SelfieStick 会接入 菲德启动，在无人干预的情况下加载指定的世界和角色，放置相机，等待世界稳定，捕获帧，并在完成后干净地关闭。

2. 亚厘米级摄像装置与光学系统

将镜头定位到精确的空间坐标 (西, 歪, 贼) 明确地 偏航 （从+Z轴顺时针方向）， 音高 （向下为正），以及视野。传统的以英尺为单位的行使用其历史上的1.7米眼高偏移；画廊合成器捕获携带绝对镜头，并将游戏渲染摄像机精确放置在那里一次。在曝光期间完全隐藏角色网格（隐藏玩家以截图) 因此架构保持畅通无阻。

3. 氛围、太阳角度与闪光扫掠

• 天气管制：锁定环境状态（清除, 迷雾, 雨, 雷霆风暴等）通过 环境管理 以保证光照一致。
• 太阳角度：设置精确的每日时间分数（0.0 至 1.0，例如 0.64 （用于午后阳光）。
• 光影闪烁扫掠：自动照亮周围80米半径内的光源预制体，并维持模拟的闪电打击（闪光持续秒数 = 1.2秒) 以正确展示地下或暗影中的建筑。

4. 稳定与物理沉降引擎

绝不会提前拍摄。在释放快门前，自拍杆会将相机固定到位（保持）并等待地形区块生成、植被放置、动态光照和刚体达到平衡。

5. 英灵神殿 1.0 无头盾牌

• 电影式跳过跳过英灵神殿1.0的强制开场动画。
• 布艺防撞护角在初始生成期间抑制MagicaCloth物理评估，消除已知的Linux/Wine/Proton驱动崩溃问题。
• 角色存档隔离：该精确图库运行器需要独特的本地角色/世界副本，并在前后检查客户端的实际存档发现和Steam角色镜像。旧版套件/馈送工作流有其自己的生命周期；请使用 已验证画廊跑者 用于作曲家下载。最初的0.3.0测试在之后保存了一个仅捕获的云配置文件 -存档目录 被忽略了； 事件与纠正 保持记录在案。

6. 连续进料模式（热循环）

加载一个数GB大小、包含700多万个对象的世界需要几分钟时间。SelfieStick的 喂食模式 (0.2.3+) 将世界常驻内存，并持续轮询指定的订阅目录。将新的拍摄计划放入该文件夹即可立即执行，无需重启游戏。

7. 密码学证明收据

每一帧输出都附带一份不可变的加密凭证， shotplan-receipts.jsonl 和 receipt.json:

• 客户端版本号（例如 25253764）。
• 所有活动插件和输出图像的SHA-256哈希值。
• 精确镜头坐标、瞄准点、偏航角、俯仰角、天气环境及沉降间隙。

8. 交互式控制台命令行套件

游戏内完整控制台命令如下 翻译为中文：camproof_* 用于实时场景编排、传送、光照转储和手动捕获的命名空间。

---

🎮 快捷键与命令行速查

指令／按键	动作	描述
验证状态	摄像机遥测	转储当前摄像机位置、偏航角、俯仰角和稳定状态。
camproof_tp <x> <y> <z>	传送镜头	将镜头传送至精确坐标并写入移动回执。
镜头校对移动	相对位移	沿坐标逐步调整镜头位置。
摄像头校验环境 <name>	锁定环境	部队天气（清除, 雨, 雷暴或 强制关闭）。
镜头验证时间 <0..1>	锁定时间	设置一天中的时间（0.25 早上， 0.5 正午， 0.64 下午， 关）。
camproof_hideplayer <开/关>	隐藏玩家	切换本地角色模型可见性以获得干净的构图。
截图 <N> <sec>	批量蒸馏	在航点之间以稳定延迟连续进行静置拍摄。
变体静止画面证明	情绪扫荡	在4种光照和天气预设下捕获活动画面。
截图证明采集 <label>	手动快门	捕获高分辨率截图并写入回执文件。
天空证明	天空倾倒	将一天中不同时段的太阳和月亮向量角度导出为JSON。
灯光证据	光之倾倒	导出所有光照预制体和环境定义。

---

⚙️ 配置与数据接收参考

拍摄计划录入（射击计划.tsv)

以制表符分隔的相机姿态（每行一帧）：

104 001 -420.5 85.2 1250.3 45.0 15.0 晴朗 0.64 -400.0 80.0 1270.0 保留 拍照 是 否

轨道请求接收（轨道请求.json)

{ "world": "我的世界", "character": "我的维京套装", "quit_when_done": true }

---

🔬 硬件验证（OMEN 主机）

自拍杆 已在自主硬件上测试并验证（预兆：Intel Core Ultra 9 285K，双 Intel Arc Pro B70 GPU，Steam《英灵神殿》1.0.12 版本 25253764）：

========================================================== 深北测试 :: 英灵神殿 1.0 自动启动器 ========================================================== [正常] 英灵神殿正在运行，进程ID：41280（进入交互式菜单用时不到8秒） [通过] 检测到0个错误、0个异常、0个补丁失败。 [通过] CameraProof 0.2.5 已加载并正常就绪。 [通过] 截图往返验证：镜头、偏航角、俯仰角与AM4存档完全一致，精确到厘米。

已验证的 BepInEx 链式加载器日志：

[信息：BepInEx] 正在加载 [Camera Proof 0.2.5] [信息：Camera Proof] Camera Proof 已加载。dev.djc.camera-proof v0.2.5。[信息：Camera Proof] 装置已就绪。馈送模式已激活。

---

📋 更新日志

v0.2.7 (2026-09-15)

• GitHub Pages 上的交互式图表已上线： 直接链接到托管于 https://djcdevelopment.github.io/SelfieStick/.
• 绝对CDN图片嵌入：已将图表预览图切换至 GitHub Pages CDN，以便在 Thunderstore 上即时、无错误地渲染。
• 已移除明文代码块：已清除未解析的原始mermaid代码框。

v0.2.6 (2026-09-15)

• Thunderstore媒体修复：已将相对图片链接替换为绝对仓库URL。
• 官方仓库上线源代码和 Archify 视觉检查发布于 自拍杆.

v0.2.5 (2026-09-12)

• 本地角色隔离：自动引导播放本地副本 <名称>-套装 按文件主干名，消除 Steam Cloud 覆盖冲突。
• 英灵神殿 1.0 兼容性: 已根据客户端构建验证 25253764 (1.0.12) 和 25185596 （1.0.7）
• 公共fx99画廊集成： 完整的溯源追踪，将捕获内容直接关联到公共档案库。

---

📦 安装指南

通过模组管理器（推荐）

使用以下方式安装 雷霆商店模组管理器 或 r2modman:

1. 搜索 自拍杆 在“在线”标签页中。
2. 点击 下载 随附依赖项（BepInExPack 英灵神殿）。

手动安装

1. 确保 BepInExPack Valheim 已安装在你的游戏目录中（Valheim/BepInEx/核心 存在）。
2. 下载 自拍杆-0.2.7.zip.
3. 提取 CameraProof.dll 直接进入你的 瓦尔海姆/BepInEx/插件/ 目录。

---

🛠️ 从源码构建

git clone https://github.com/djcdevelopment/SelfieStick.git cd SelfieStick dotnet build -c Release -p:ValheimDir="C:\Program Files (x86)\Steam\steamapps\common\Valheim"

编译后的二进制文件位于 bin/Release/net472/CameraProof.dll.

---

📄 许可证

MIT许可证。参见 许可证 详情请见。