CPCameraStudioReborn - Smooth Cinematic Movement! - CPCameraStudioReborn - 平滑电影运镜

💡简介

CPCameraStudioReborn 插件让你能够通过几个简单的命令，在多个路径点之间创建平滑的电影式镜头移动。使用 /cam p 命令可以在当前位置设置路径点，执行 /cam start 命令后，你将沿着这些点移动。你只需指定移动的总时长，插件便会自动计算点与点之间的距离并平滑地移动你的视角。

🎮命令与权限

路径点管理

• /cam p

- 将当前位置添加到镜头路径中。

- 权限：`camerastudio.point`

• /cam r [pos]

- 从镜头路径中移除指定位置的点。若不指定 `[pos]`，则移除最后一个点。

- 权限：`camerastudio.remove`

• /cam list

- 列出镜头路径中的所有点。

- 权限：`camerastudio.list`

• /cam reset

- 清除镜头路径中的所有点。

- 权限：`camerastudio.reset`

• /cam goto <pos>

- 将玩家传送到指定的路径点。

- 权限：`camerastudio.goto`

镜头移动控制

• /cam start <duration> <arguments>

- 在指定时间内沿镜头路径移动玩家。

- 权限：`camerastudio.start`

- 示例：`/cam start 1m30s` 将耗时1分30秒完成移动。

• /cam preview <arguments>

- 按照配置文件中的预设时间预览镜头路径。

- 权限：`camerastudio.preview`

• /cam stop

- 立即停止镜头移动。

- 权限：`camerastudio.stop`

路径保存与加载

• /cam save

- 将当前的路径点保存到你的个人文件中。

- 权限：`camerastudio.save` (新增！)

• /cam save <filename>

- 将当前的路径点保存到指定名称的文件中。

- 权限：`camerastudio.save.file` (已更新！)

• /cam load

- 从你的个人文件中加载路径点。

- 权限：`camerastudio.load` (新增！)

• /cam load <filename>

- 从指定名称的文件中加载路径点。

- 权限：`camerastudio.load.file` (已更新！)

其他命令

• /cam help

- 显示 CPCameraStudio 的帮助页面。

- 权限：`camerastudio.help`

命令参数

以下参数可用于 /cam start 和 /cam preview 命令：

• silent：移动完成或发生错误时，不在聊天栏显示消息。
• File Name：使用指定路径文件中的镜头路径，不会覆盖当前已加载的路径。
• Player Name：为指定玩家播放镜头路径。若未指定路径，则使用你自己的镜头路径。

🔧配置文件

你可以在 config.yml 中调整以下设置：

• show-join-message：启用或禁用玩家加入服务器时插件发送的消息。默认为 true。
• preview-time：设置使用 /cam preview 命令时，点与点之间的预览时间。默认为 5s。
• maximum-points：设置任何玩家可拥有的最大路径点数量。默认为 100。你可以通过权限节点 camerastudio.point. 来覆盖此限制，星号 也可替换为任意数字来设定具体限制。(新增！)
• allowed-gamemodes：设置允许使用 /cam 命令的游戏模式。默认包含所有模式。(新增！)
• clear-points-on-disconnect：设置玩家退出服务器时，其定义的路径点是否被清除。默认为 false。(新增！)

❓常见问题

问：镜头移动有卡顿！为什么？

• 答：插件的工作原理是每游戏刻（tick）传送你一次。由于一秒只有20刻，传送看起来可能不够平滑。我们正在努力改进！如果你想要更平滑的移动，请确保不要用鼠标转动头部，只使用 WASD 键移动，这样卡顿最少。同时，由于每秒20次传送的限制，最好为移动设置较长的时间。

问：这个插件是 CrushedPixel 制作的！你怎么敢反编译它？

• 答：我拥有发布此插件的完整许可：https://goo.gl/photos/C37kBQxJ1V5Ky7D2A

问：我想禁用加入服务器时的消息。

• 答：你可以在配置文件中禁用它！

问：我有一个想法？可以告诉你吗？

• 答：当然可以！请在讨论区告诉我，我会尝试实现它！

✨开发者 API

首先，创建一个包含你想要传送玩家的所有位置（Location）的列表。

然后调用 CameraStudio.travel 方法。第一个变量是玩家，第二个是你的位置列表，第三个是你希望移动持续的刻数（你也可以调用 CameraStudio.parseTimeString 来像在游戏中那样解析时间字符串），第四个是移动失败时显示的消息，第五个是移动完成时显示的消息。

示例代码：

List<Location> locations = new ArrayList<Location>();
locations.add(new Location(Bukkit.getWorld("WorldName"), 3014.5, 86, 2986.5, 49.5F, 31.3F));
locations.add(new Location(Bukkit.getWorld("WorldName"), 2995.5, 74, 2988.5, -40.8F, -5.0F));
try {
    CameraStudio.travel(player, locations, CameraStudio.parseTimeString("1m20s"), "FAIL", "DONE");
} catch (ParseException e) {
    player.sendMessage("Error with time parsing");
}

其他可用方法：

• CameraStudio#isTravelling()：返回一个布尔值，表示玩家是否正在移动。
• CameraStudio#stop()：如果指定玩家正在移动，此方法将停止他的移动。

⭐其他信息

• 源代码：可在 GitHub 查看：https://github.com/chrismin13/CPCameraStudioReborn/
• 反馈须知：如果你发现任何漏洞，请前往讨论区报告，而不是在评论中提出。