Technical wiki for creators and addon developers.
Recording
How gameplay capture works, Normal/Rolling/Hybrid modes, event markers and server recording policy.
Free downloadAll Rights ReservedNeoForge 1.21.1
01
What is recorded
A recording saves a replay session that can be reopened in the editor. During gameplay the mod captures packets, world state, entities, local-player motion and optional data such as hotbar or voice chat when compatible.
The output is not a video. It is a replay session that you can reopen, trim, direct with cameras, edit with actors and export later.
02
Capture modes
| Mode | Best for | Behavior |
|---|---|---|
| Normal | Planned full recordings | Keeps the whole session until you save or finish it. |
| Rolling | DVR-style clips | Keeps a recent time window and prunes older material. |
| Hybrid | Long sessions | Combines a time window and disk budget to prevent uncontrolled growth. |
03
Important settings
Chunk length seconds: recording segment length.Rolling retained seconds: how much recent time Rolling keeps.Mark dimension changes: creates markers when you change dimension.Local player updates per second: increases local-player movement fidelity.Record voice chat: shown only when a compatible voice chat mod is loaded.
04
Automation profiles
| Profile | Use |
|---|---|
| Safe | Only auto-finish on maximum duration. |
| Highlights | Combat, death and big falls save clips or highlights. |
| Hazards | Fire, freezing, wither and darkness create markers or Save Last clips. |
| Movement | Dimension changes, elytra and major falls. |
| Manual Locked | Starts and locks on critical events, then requires manual finish. |