AnkiCamera

A cinematic camera cutscene plugin for Minecraft servers. Supports Paper, Folia, and Spigot, covering 1.21 and above. 一个服务端过场动画摄像机插件，支持 Paper、Folia 和 Spigot，覆盖 1.21 及以上版本。

---

Features / 特点

• Smooth spline camera paths with 4 interpolation modes (Catmull-Rom, B-Spline, Hermite, Linear) 平滑样条摄像机路径，4 种插值模式（Catmull-Rom、B-Spline、Hermite、线性）

• Visual hotbar editing tools with clickable chat UI 可视化快捷栏编辑工具 + 可点击聊天 UI

• Point events: trigger titles, sounds, commands, scripts at any camera point 点位事件：在任意摄像机点位触发标题、音效、指令、脚本

• AC Script system for chaining scenes, delays, dialogues, and rewards AC 脚本系统，串联场景、延迟、对话和奖励

• Trigger system: auto-play on region enter, block click, or command 触发器系统：区域进入、方块点击或指令自动播放

• Recording mode: walk to auto-capture camera points 录制模式：行走自动捕获摄像机点位

• Packet-based camera: no entity flicker, smooth spectator-mode playback 基于数据包的摄像机：无实体闪烁，流畅旁观者模式播放

---

Requirements / 依赖

• Paper 1.21+ / Folia 1.21+ / Spigot 1.21+
• Java 21
• PacketEvents (place in plugins folder)

---

Installation / 安装

1. Install Paper, Folia, or Spigot 1.21+. 安装 Paper、Folia 或 Spigot 1.21+

2. Place packetevents.jar into plugins/. 将 packetevents.jar 放入 plugins/ 目录

3. Place AnkiCamera.jar into plugins/. 将 AnkiCamera.jar 放入 plugins/ 目录

4. Start the server. 启动服务器

---

Usage / 使用方法

1. Create a scene: /acam new <id> 创建场景：/acam new <id>

2. Enter edit mode: /acam edit <id> 进入编辑模式：/acam edit <id>

3. Use hotbar tools to add points, preview, record, and toggle path particles. 使用快捷栏工具添加点位、预览、录制、开关路径粒子

4. Play the scene: /acam play <id> 播放场景：/acam play <id>

5. Hold Shift to exit playback. 长按 Shift 退出播放

---

Commands / 指令

Command / 指令	Description / 说明
/acam new <id>	Create a new scene / 创建新场景
/acam del <id>	Delete a scene / 删除场景
/acam list	List all scenes / 列出所有场景
/acam edit <id>	Enter edit mode / 进入编辑模式
/acam exit	Exit edit mode / 退出编辑模式
/acam add	Add point at current position / 在当前位置添加点位
/acam insert <idx>	Insert point at index / 在指定位置插入点位
/acam rm <idx>	Remove a point / 删除点位
/acam set <idx> <param> [val]	Set point parameter / 设置点位参数
/acam points [id]	View point list / 查看点位列表
/acam pt <idx>	View point detail (clickable UI) / 查看点位详情（可点击 UI）
/acam play <id> [player|all]	Play a scene / 播放场景
/acam stop [player|all]	Stop playback / 停止播放
/acam pause	Pause/resume playback / 暂停/恢复播放
/acam rec start|stop	Start/stop recording / 开始/停止录制
/acam setting <param> <val>	Modify scene settings / 修改场景设置
/acam path [on|off]	Toggle path particles / 开关路径粒子
/acam smooth <id>	Smooth path / 平滑路径
/acam reverse <id>	Reverse point order / 反转点位顺序
/acam copy <src> <dst>	Copy a scene / 复制场景
/acam tp <idx>	Teleport to point / 传送到点位
/acam export <id>	Export scene / 导出场景
/acam import <file>	Import scene / 导入场景
/acam trigger <sub>	Trigger management / 触发器管理
/acam action <idx> <sub>	Point event management / 点位事件管理
/acam script <name>	Run AC script / 执行 AC 脚本
/acam reload	Reload config and lang / 重载配置和语言

---

Permissions / 权限

Permission / 权限	Description / 说明
ankicamera.admin	Full access to all commands / 所有指令完整权限
ankicamera.play	Play scenes / 播放场景
ankicamera.play.other	Play scenes for other players / 为其他玩家播放场景

---

Languages / 语言

Configure in config.yml: 在 config.yml 中配置：

language: en_US

Available / 可用语言: zh_CN, en_US, ja_JP, ko_KR, ru_RU, de_DE, fr_FR, es_ES, pt_BR

---

AC Script / AC 脚本

Place .ac files in plugins/AnkiCamera/scripts/. Example: 将 .ac 文件放入 plugins/AnkiCamera/scripts/。示例：

@scene intro
  title "<gold>Welcome!</gold>" "<gray>Enjoy the tour</gray>"
  sound entity.experience_orb.pickup 1.0 1.2
  delay 40
  play my_scene
  wait 0
  msg "<green>Tour complete!</green>"

See plugins/AnkiCamera/scripts/ for more examples after first launch. 首次启动后查看 plugins/AnkiCamera/scripts/ 获取更多示例。

---

Configuration / 配置

plugins/AnkiCamera/config.yml — main config with speed, recording interval, particles, edit tools, etc. plugins/AnkiCamera/config.yml — 主配置文件，包含速度、录制间隔、粒子、编辑工具等设置。

plugins/AnkiCamera/lang/ — language files, editable for customization. plugins/AnkiCamera/lang/ — 语言文件，可自定义编辑。

---

A wiki page is coming soon!