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.