GlobalReplay

# Recommended Companion Plugin For the best replay NPC experience, it is recommended to install (https://modrinth.com/plugin/globalreplay) together with (https://modrinth.com/plugin/packetevents). (https://modrinth.com/plugin/packetevents) enables client-side fake-player replay NPCs with UUID/name/skin restoration. Without (https://modrinth.com/plugin/packetevents), (https://modrinth.com/plugin/globalreplay) still runs, but replay NPCs use ArmorStand fallback markers. # GlobalReplay !(https://cdn.modrinth.com/data/cached_images/d3334d933dc9af862e69d30e47c6d1f86d60ccba.png) ## Introduction GlobalReplay is a Paper API Minecraft server plugin that silently records real player activity in the background and lets administrators replay historical moments inside isolated parallel worlds. - Plugin name: `GlobalReplay` - Author: `bentianjia` - Command prefix: `/replay` - Java version: Java 21 - Target server: Paper `1.20-1.21.11` - Required time format: `yyyy-MM-dd_HH:mm` Example time-based commands: ```text /replay enter overworld 2024-01-15_23:00 /replay goto 2024-01-15_23:47 ``` ## Features ### Continuous Background Recording GlobalReplay continuously records all real players without requiring administrators to start a manual session. - Player position and rotation with dynamic sampling: - Idle players: one frame every 10 seconds - Moving players: one frame every second - Players in combat: one frame every tick - Block changes, including breaking, placing, and explosions - Player interaction actions, including left-click swings, right-click interactions, food consumption, item pickup/drop, hotbar switching, inventory clicks, and container open/close actions - Container and inventory changes, stored as item snapshots when changes happen - Player death and respawn events - Dimension transfer events, including source dimension, target dimension, and before/after locations - Player join and quit events - Server start and stop timestamps, used as offline breakpoints during replay ### Automatic Message Language Player-facing messages follow the player's Minecraft client language when possible. Supported languages: - Arabic - Chinese - English - French - Russian - Spanish Other client languages fall back to English. Console messages use English. ### LZ4 Storage and Automatic Cleanup Replay data is split by world or dimension, then stored as hourly `.replay.lz4` shards: ```text plugins/GlobalReplay/recordings/ overworld/ 2024-01-15_22.replay.lz4 2024-01-15_23.replay.lz4 nether/ the_end/ <custom-world-name>/ ``` - Replay data is written to an in-memory buffer first. - Buffered data is batch-compressed with LZ4 and flushed to disk every configurable interval. - Remaining buffered data is force-flushed during server shutdown. - Old recordings are managed by a configurable automatic cleanup policy. - Each `.replay.lz4` shard covers one hour, or 60 minutes, of replay data. - When a replay is opened, decompressed cache files may be written under `plugins/GlobalReplay/temp/`. - The original `.replay.lz4` recording file is kept; only the temporary decompressed cache is deleted after it has been unused for 5 minutes after replay exit. ### Smart Fake Player and NPC Exclusion GlobalReplay is designed to record real players only. It scans loaded plugins on startup and enables supported exclusion modules automatically. Excluded entities and accounts include: - Citizens2 NPCs detected by `NPC` metadata - Shopkeepers entities detected through Shopkeepers API markers - MythicMobs entities detected by MythicMobs entity tags - Carpet fake players detected by special entity name prefixes - NPCLib entities detected by plugin metadata - Accounts with the `globalreplay.exempt` permission - Replay NPCs marked with `globalreplay_npc=true` - Manual exclusions from `recording.excluded-entity-names` - Manual exclusions from `recording.excluded-entity-uuids` Newly spawned entities are checked through `EntitySpawnEvent` so runtime-generated NPCs and fake entities are skipped as well. ### Isolated Parallel Worlds Administrators can enter replay sessions without affecting the live server world. - Each administrator receives a separate temporary parallel world instance. - Multiple administrators can replay the same recording at the same time with independent timelines. - Decompression and replay loading run asynchronously. - Player teleportation and game-state changes are performed back on the main server thread. - The administrator enters the parallel world at the same coordinates and rotation they had in the original world instead of being sent to world spawn. - The administrator's original location, game mode, and inventory are saved on entry and restored on exit. - Playback starts automatically after entering the replay world. ### Read-Only Replay Protection Parallel worlds are read-only by design. - `BlockBreakE