A cinematic camera cutscene plugin for Minecraft servers. Supports Paper, Folia, and Spigot, covering 1.21 and above. 一个服务端过场动画摄像机插件，支持 Paper、Folia 和 Spigot，覆盖 1.21 及以上版本。 --- ![EASY](https://cdn.modrinth.com/data/cached_images/99e930e01a3051f9749e2fad5c53031b9e0100c7.png) ## 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](https://github.com/retrooper/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 ` 创建场景：`/acam new ` 2. Enter edit mode: `/acam edit ` 进入编辑模式：`/acam edit ` 3. Use hotbar tools to add points, preview, record, and toggle path particles. 使用快捷栏工具添加点位、预览、录制、开关路径粒子 4. Play the scene: `/acam play ` 播放场景：`/acam play ` 5. Hold Shift to exit playback. 长按 Shift 退出播放 --- ## Commands / 指令 | Command / 指令 | Description / 说明 | |:---|:---| | `/acam new ` | Create a new scene / 创建新场景 | | `/acam del ` | Delete a scene / 删除场景 | | `/acam list` | List all scenes / 列出所有场景 | | `/acam edit ` | Enter edit mode / 进入编辑模式 | | `/acam exit` | Exit edit mode / 退出编辑模式 | | `/acam add` | Add point at current position / 在当前位置添加点位 | | `/acam insert ` | Insert point at index / 在指定位置插入点位 | | `/acam rm ` | Remove a point / 删除点位 | | `/acam set [val]` | Set point parameter / 设置点位参数 | | `/acam points [id]` | View point list / 查看点位列表 | | `/acam pt ` | View point detail (clickable UI) / 查看点位详情（可点击 UI） | | `/acam play [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 ` | Modify scene settings / 修改场景设置 | | `/acam path [on\|off]` | Toggle path particles / 开关路径粒子 | | `/acam smooth ` | Smooth path / 平滑路径 | | `/acam reverse ` | Reverse point order / 反转点位顺序 | | `/acam copy ` | Copy a scene / 复制场景 | | `/acam tp ` | Teleport to point / 传送到点位 | | `/acam export ` | Export scene / 导出场景 | | `/acam import ` | Import scene / 导入场景 | | `/acam trigger _{` | Trigger management / 触发器管理 |
| `/acam action _{` | Point event management / 点位事件管理 |
| `/acam script ` | 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 "Welcome!" "Enjoy the tour"
sound entity.experience_orb.pickup 1.0 1.2
delay 40
play my_scene
wait 0
msg "Tour complete!"
```

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!}}

Ankiw