[TACZ] Report Replay Actions

ReplayActions

  ReplayActions is a server-side Forge mod for Minecraft 1.20.1 designed for PvP/PvE servers. It provides a complete
  system for automatic death replays, player reporting, bug reports, inventory tracking, and combat disconnect detection
   — all with a built-in administration interface.

  ---
  Key Features

  Automatic Death Replays

  - Continuous recording via circular buffer (configurable from 5 to 60 seconds, default 15s)
  - Post-death recording: continues capturing after a player's death (configurable up to 15s) for full context
  - Client-side playback using ghost entities (victim, attacker, nearby players and mobs)
  - Playback controls: pause, variable speed (0.25x to 2.0x), tick-by-tick seeking
  - Automatic teleportation to the death location
  - Visual MORT (dead) / DECO (disconnected) indicators on nametags
  - TACZ (Timeless and Classics Zero) compatible: gun rendering, bullet trails, and prone positions in replays

  Player Report System

  - Players can report others for: Insults, Hate Speech, Cheating, Teaming, Combat Disconnect
  - Evidence automatically attached (chat logs, replay sessions)
  - Admin ticket interface: list, details, resolution
  - Apply sanctions directly from the UI: Mute, Temp Ban, Kick
  - Fully configurable sanction commands with placeholders ({player}, {duration}, {reason})
  - Customizable sanction durations

  Bug Report System

  - Players can report: Item Disappearance, Unfair Mob Death
  - Automatic evidence: inventory history, PvE replays
  - Resolution types: Bug Confirmed, Items Restored, No Bug Found, Insufficient Evidence, User Error, False Report,
  Abuse Warning
  - Dedicated resolution interface with item restoration support

  Combat Disconnect Detection

  - Automatic combat state tracking (configurable timeout, default 30s)
  - Instant admin notification when a player disconnects during combat
  - Replay sessions automatically generated for combat disconnects
  - Listed as a report reason with replay evidence

  Inventory Tracking

  - 5-minute rolling buffer of all container interactions
  - Every action detected: click, shift-click, hotbar swap, split, drop, pickup
  - Item vanish detection: automatic item count comparison before/after
  - Inventory replay for admins

  Permission System

  - Configurable JSON file (replayactions_permissions.json)
  - Roles: Admin and Moderator with granular permissions
  - Permissions: view/resolve tickets, view/resolve bugs, restore items, view stats, apply sanctions, start replays
  - Native Minecraft OP level support

  Administration Statistics

  - Per-admin and global statistics
  - Moderation activity tracking
  - Full sanction history

  ---
  Configuration

  Two server-side config files:
  - replayactions-server.toml — Tracking, storage, replay, combat, permissions
  - replayactions-reports.toml — Sanction commands, durations

  Key options:

  ┌───────────────────┬────────────┬─────────────────────────────────────────┐
  │      Option       │  Default   │               Description               │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Replay buffer     │ 15s        │ Recording duration before death (5–60s) │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Post-death        │ 5s         │ Recording duration after death (0–15s)  │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Session retention │ 24h        │ How long replays are kept (1–168h)      │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Max sessions      │ 1000       │ Maximum number of stored sessions       │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Player radius     │ 200 blocks │ Tracking radius for nearby players      │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Entity radius     │ 20 blocks  │ Tracking radius for mobs                │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Combat timeout    │ 30s        │ Duration of "in combat" state           │
  ├───────────────────┼────────────┼─────────────────────────────────────────┤
  │ Report retention  │ 30 days    │ How long resolved reports are kept      │
  └───────────────────┴────────────┴─────────────────────────────────────────┘

  ---
  Commands

  ┌─────────┬──────────────────────────────────────┐
  │ Command │             Description              │
  ├─────────┼──────────────────────────────────────┤
  │ /replay │ Replay management                    │
  ├─────────┼──────────────────────────────────────┤
  │ /report │ Player reports and ticket management │
  ├─────────┼──────────────────────────────────────┤
  │ /bug    │ Bug reports                          │
  ├─────────┼──────────────────────────────────────┤
  │ /perm   │ Permission management                │
  └─────────┴──────────────────────────────────────┘

  ---
  Storage

  Data is saved in the world folder (world/replayactions/):
  - Replay sessions: NBT-compressed .dat files
  - Reports and bugs: persistent server-side storage
  - Automatic periodic cleanup of old sessions

  ---
  Requirements

  - Minecraft 1.20.1
  - Forge 47.2.0+
  - Java 17+
  - Server + Client mod (clients receive replays and UI screens)

  ---
  Compatibility

  - TACZ (Timeless and Classics Zero): full support for gun rendering, firing, reloading, and prone positions in replays

  ---
  Built for PvP/PvE servers that need advanced moderation tools with visual evidence.