Перейти к содержимому
Mineforgian

Flashback Server

Server-side Flashback replay recording for Paper — zero dependencies, Folia-ready, with a clip system. Record any player and save the last N seconds as a clip, no client mod required for the recorded players.

Загрузки
55
Подписчики
1
Обновлён
4 июня 2026 г.
Лицензия
MIT

Опубликован 4 июня 2026 г.

Исходный код

Flashback Server

Record your Paper/Folia server's gameplay into Flashback-format replays — entirely server-side. The players being recorded need no mods; you view the results with the Flashback client mod.

Features

  • Record any player server-side → .flashback files readable by the Flashback client.
  • Clip system — keep a rolling buffer per player and save the last N seconds on demand, or automatically when a player dies.
  • Folia-ready — works on the regionized Paper fork, no extra config.
  • Zero dependencies — pure Netty packet capture; no ProtocolLib to break on every update.
  • Renderable snapshots — recordings include a synthesized initial state (registries, chunks, player) so the Flashback client renders them from the start.
  • Multi-chunk recordings for long sessions + dimension changes.

Commands (flashbackserver.replay, default op)

Command Description
/replay start players <player> Start recording a player
/replay stop players <player> Stop & save a recording
/replay clip arm/disarm/save <player> Rolling clip buffer controls
/replay verify <file> Decode-check a saved replay (diagnostic)
/replay help Help

Configuration

  • clips.window-seconds (default 30) — rolling clip length.
  • clips.auto-clip-on-death (default true) — auto-save a clip when an armed player dies.
  • telemetry.enabled (default true) — anonymous, no-PII usage telemetry; set false to disable.

Install

  1. Paper or a Paper fork (Purpur/Folia) for Minecraft 1.21.5–1.21.11.
  2. Drop the jar in plugins/, restart. No dependencies.
  3. View replays with the Flashback client mod.

Privacy

Anonymous, opt-out telemetry (server platform/version, recording/clip counts & sizes, error class names). No player names, UUIDs, or IPs are ever collected. Disable with telemetry.enabled: false.

Flashback Server is an independent project, not affiliated with or endorsed by the Flashback mod or its author. It produces files compatible with the Flashback format for interoperability.

Ченджлог

1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 4 июня 2026 г.

Hardening & correctness release (full code audit).

  • Fix: recordings/clips no longer overwrite earlier files (unique, sanitized filenames); player names are sanitized so they can never write outside the replays folder.
  • Fix: metadata now carries the correct Minecraft version_string (was hardcoded 1.21.5).
  • Fix: in-flight recordings are flushed on server stop/reload instead of being lost.
  • Hardening: /replay verify of a crafted/corrupt .flashback can no longer OOM or crash the server (bounded allocations, zip-bomb guard, robust metadata parsing); verify now runs off the main thread.
  • Robustness: atomic file writes (no truncated files), clip window clamped, telemetry timeouts.

No gameplay/format changes.

1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 4 июня 2026 г.

Fix: route anonymous opt-out telemetry to the correct PostHog region (EU) so usage stats are recorded. No gameplay or recording changes — functionally identical to 1.2.0.

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 4 июня 2026 г.

Multi-version support for Minecraft 1.21.5 through 1.21.11. Server-side Flashback recording, clip system, Folia support, zero dependencies.

Комментарии

Загружаем…