# BetterReplay<\/p>\n
BetterReplay is a server-side replay plugin for Paper and Folia-style scheduling.
\nIt records player and nearby entity activity on the server, saves the timeline, and replays it for viewers in-game.<\/p>\n
## What this project is<\/p>\n
– Server plugin written in Java
\n– Targets modern Paper APIs
\n– Uses PacketEvents and FoliaLib for packet handling and scheduling
\n– Supports two storage backends:
\n – local JSON files
\n – MySQL<\/p>\n
## How this differs from client-side replay mods<\/p>\n
BetterReplay is not a client recording mod.<\/p>\n
Server-side approach (this project):
\n– Runs entirely on the server
\n– No replay mod required on player clients
\n– Captures server-observed gameplay state and events
\n– Plays back by spawning and updating replay entities for a viewer
\n– Good for moderation, event review, and server-side tooling<\/p>\n
Typical client-side replay mod approach:
\n– Records from a specific client perspective
\n– Usually requires modded client setup
\n– Often includes advanced free-camera\/cinematic editing features
\n– Playback is usually local to the client recording<\/p>\n
In short: BetterReplay focuses on server-managed replay workflows and API-driven integration.<\/p>\n
## Features<\/p>\n
– Start and stop recordings
\n– Save recordings to file or MySQL
\n– List and delete stored replays
\n– Replay sessions for viewers
\n– API-first integration support for other plugins
\n– Optional Floodgate soft dependency support<\/p>\n
Base command:
\n– \/replay<\/p>\n
Subcommands:
\n– start
\n– stop
\n– play
\n– list
\n– delete<\/p>\n
Permissions:
\n– replay.start
\n– replay.stop
\n– replay.play
\n– replay.list
\n– replay.delete
\n– replay.*<\/p>\n
### Storage-Type options<\/p>\n
Valid values for `General.Storage-Type` are:<\/p>\n
– `file`
\n – Stores replay data as JSON files under the plugin data folder.
\n– `mysql`
\n – Stores replay data in a MySQL table (`replays`) using the configured `General.MySQL.*` values.<\/p>\n
These values should be lowercase as shown above.<\/p>\n
### File storage example<\/p>\n
“`yaml
\nGeneral:
\n Check-Update: true
\n Storage-Type: file
\n“`<\/p>\n
### MySQL storage example<\/p>\n
“`yaml
\nGeneral:
\n Check-Update: true
\n Storage-Type: mysql
\n MySQL:
\n host: 127.0.0.1
\n port: 3306
\n database: betterreplay
\n user: replay_user
\n password: change-me
\n“`<\/p>\n
Additional key used by command pagination:<\/p>\n
“`yaml
\nlist-page-size: 10
\n“`<\/p>\n
Notes:
\n– If Storage-Type is invalid, plugin falls back to file storage.
\n– MySQL replay names are stored in a VARCHAR(64) primary key column.<\/p>\n
## API<\/p>\n
BetterReplay provides a public API for other plugins to start\/stop recordings, manage replays, and listen for lifecycle events.<\/p>\n
Quick example:<\/p>\n
“`java
\nReplayManager manager = ReplayAPI.get();
\nmanager.startRecording(“demo-session”, List.of(player), 120);
\nmanager.stopRecording(“demo-session”, true);
\nmanager.startReplay(“demo-session”, viewerPlayer);
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
Packet Based Player Recorder.
\nBetterReplay is a server-side replay plugin for Paper and Folia-style scheduling. It records player and nearby entity activity on the server, saves the timeline, and replays it for viewers in-game.<\/p>\n","protected":false},"featured_media":30288,"template":"","meta":{"_minecraft_slug":"betterreplay","_minecraft_project_id":"Q9s9vyrt","_minecraft_author":"JustinDevB","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":45,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"betterreplay.zip","_minecraft_size_bytes":15967963,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-15T21:46:22.380718Z","_minecraft_date_created":"2026-05-11T01:30:35.358401Z","_minecraft_date_modified":"2026-05-14T18:54:17.175592Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/betterreplay","_minecraft_icon_attachment_id":30288,"_minecraft_imported_at":"2026-06-01T12:51:35+00:00","_minecraft_import_hash":"11d458f478c0dea591bc885072416df4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,167,163],"class_list":["post-30287","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n