Neutrino (自由视角)

🌀 中微子 (自由视角) v0.8

中微子是一个轻量级的服务端自由视角插件，适用于 Hytale，它允许玩家将相机从角色身上分离，用于探索、电影级截图和世界观察。

该插件设计得尽量简洁可靠，专注于提供干净的自由视角体验，并可选基于权限的访问控制。

---

⚙️ 工作原理

当启用自由视角时，你的玩家相机将切换到服务器相机模式，允许相机独立移动，而你的角色保持原地不动。

自由视角可以随时开启/关闭，并且中微子会在玩家断开连接或服务器关闭时自动清理活动的自由视角状态。

一个可选的倍速设置允许玩家动态调整相机的移动速度。

---

⌨️ 命令

玩家命令

/freecam (别名 /fc)
• 切换自由视角模式的开启/关闭
• 可选参数：speed (浮点数)
• 默认情况下：所有玩家可用

使用示例：

• /freecam → 切换自由视角
• /freecam 2.0 → 将速度倍率设置为 2.0 倍并切换
• /freecam 0.5 → 更慢的电影级移动

速度倍率：

• 最小值：0.25
• 最大值：5.0
• 默认值：1.0

如果速度值超出允许范围，命令将拒绝并显示验证消息。

锚点命令合集 (开发中)

/freecamanchor (别名 /fca)

子命令：

• /fca set <id> → 将当前相机位置和旋转保存为锚点
• /fca remove <id> → 移除已保存的锚点
• /fca use <id> → 进入锚点视角
• /fca quit → 退出锚点视角

锚点配置命令 (开发中)

/freecamanchorconfig enabled <true|false> (别名 /fcac)
• 全局启用/禁用所有锚点功能

---

🔐 权限

中微子 v0.8.5 使用专用的权限节点：

自由视角

• neutrino.command.freecam
• neutrino.command.freecamconfig
• neutrino.command.freecamconfig.usepermissionbehavior

锚点 (开发中)

• neutrino.command.freecamanchor
• neutrino.command.freecamanchor.set
• neutrino.command.freecamanchor.remove
• neutrino.command.freecamanchor.use
• neutrino.command.freecamanchor.quit
• neutrino.command.freecamanchorconfig
• neutrino.command.freecamanchorconfig.enabled

锚点数量限制可通过以下方式控制：

• neutrino.command.anchor.max.<数字>
  (示例：neutrino.command.anchor.max.5)

当启用基于权限的行为时，玩家只能创建与其最高匹配的最大权限节点所允许数量的锚点。

---

⚓ 锚点 (开发中)

锚点允许玩家保存特定的相机位置（包括世界、坐标和旋转角度），并在之后以固定视角重新进入。

当前实现包括：

• 基于玩家的锚点存储
• 持久化保存到配置文件
• 世界验证（锚点只能在创建它的世界中使用）
• 安全的世界存在性检查
• 锚点 ID 验证（1-32 个字符，允许字母/数字/_/-）
• 基于权限的锚点数量限制
• 全局启用/禁用开关

使用锚点时：

• 相机进入锚点模式
• 玩家的角色保持原地不动
• 速度倍率仍然生效
• 玩家可以通过 /fca quit 退出锚点模式

锚点目前被认为是实验性功能。

该功能在设计清晰度、用户体验一致性以及长期可靠性方面仍在评估中。其行为、权限或结构在未来的版本中可能会发生重大变化。

---

🎥 典型用例

• 检查大型建筑
• 录制视频
• 拍摄电影级截图
• 创建固定的电影摄影机角度
• 控制场景构图

中微子旨在成为一个视觉和探索导向的工具。

---

✨ 功能特性

• 轻量级、极简实现
• 简单的切换命令 (/freecam, /fc)
• 可选的速度倍率参数
• 可选的权限控制自由视角行为
• 基于玩家的锚点保存位置系统 (开发中)
• 运行时配置开关
• 断开连接/关闭时自动清理

---

如果您遇到问题或有建议，请在项目页面报告。