# Overview Recap is a server-side motion capture plugin that records player gameplay and replays it using packet-based NPCs. It's designed for mass recording scenarios — up to 1000+ concurrent players — with an optimized binary storage format that keeps file sizes small. --- ## What is Recap? Recap captures per-tick player state (position, rotation, equipment, actions, entity flags) and serializes it to compressed binary files. Recordings can be played back as fake player entities visible to all online players, or composed into scenes with multiple recordings playing simultaneously with time and position offsets. --- ## Features - **Per-tick recording** — captures position, rotation, velocity, equipment, arm swings, block interactions, item usage, and entity state every server tick - **Packet-based playback** — replays recordings as client-side NPCs via PacketEvents, no server-side entities created - **Mass recording** — designed for 1000+ concurrent players with optimized storage - **Scene composition** — combine multiple recordings into scenes with per-recording time delays and position offsets - **Compressed binary format** — delta encoding, bit-flag packing, skip-tick optimization, and GZIP compression for minimal disk usage - **Loop playback** — optionally loop individual recording playbacks - **Equipment tracking** — records main hand, off hand, and armor changes with delta encoding (only stores changes) - **Entity state flags** — sneaking, sprinting, swimming, flying, on fire, invisible, glowing - **Block interactions** — block place and break events with position and material - **Auto-stop on disconnect** — recordings automatically save when a player leaves --- ## Dependencies | Dependency | Version | Type | |---|---|---| | Paper API | 1.21+ | Server platform | | Java | 21 | Runtime | PacketEvents and CommandAPI are shaded into the plugin jar. No external dependencies need to be installed. --- ## Optional Integrations | Plugin | Purpose | |---|---| | Bookshelf | Utility methods and command framework extensions | --- ## Related Pages - [[Recap/Server Owners/Commands]] — complete command reference - [[Recap/Server Owners/Configuration]] — full config.yml breakdown - [[Recap/Developers/Overview]] — developer API documentation