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` 中配置：

```yaml 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!