NPCFrame Recorder v1.0.3

NPCFrame Recorder​

NpcFrame Recorder is a frame-based recording system that captures player movements and world interactions to replay them through NPCs. Perfect for creating cinematic cutscenes, scripted sequences, or Roleplay scenarios without the need for external editing tools.


This plugin is designed for servers that want to create dynamic cutscenes, scripted sequences, roleplay scenarios, or replay systems without requiring external editing tools.

No ProtocolLib Required

---

Features​

• Record player movement per tick
• Replay recordings through FancyNPCs
• Support for equipment (main hand, off hand, armor)
• Block interactions (doors and block placement/break)
• Sound playback support
• Loop, pause and resume playback
• Optional global or player-only playback
• Automatic world rollback after recording
• GUI-based recording management
• JSON-based frame system for flexible expansion

---

Use Cases​

• RPG cutscenes
• Story-driven servers
• Quest systems
• Roleplay sequences
• Cinematic NPC interactions
• Adventure maps

---

Compatibility​

• Minecraft 1.21.11 (Paper recommended)
• Spigot may work, but Paper is recommended
• Requires FancyNPCs (dependency)

---

Permissions​

• npcframe.admin — Full access to the main command and all plugin settings.
• npcframe.walk.record — Start recording a new path.
• npcframe.walk.stop — Stop and save the current recording.
• npcframe.walk.gui — Open the interactive recordings menu (GUI).
• npcframe.walk.start — Play a recording once.
• npcframe.walk.loop — Enable infinite loop mode for an NPC.
• npcframe.walk.pause — Pause the NPC's current movement.
• npcframe.walk.resume — Resume a paused NPC's movement.
• npcframe.walk.reverse — Toggle the walking direction (forward/backward) using the toggle system.
• npcframe.walk.stoploop — Stop and remove an NPC's loop.
• npcframe.walk.reload — Reload the configuration and the active loops file.
  
  
  
• npcframe.particula — Allows usage of the particle command

Default: OP (recommended). You can grant these permissions to non-OP ranks via LuckPerms / PEX.

---

Notes​

• In individual playback mode, container lid animations are limited by vanilla client behavior.
• No license system required.
• No external web downloads.
• No automatic remote connections.
• This plugin does not collect data and does not connect to any external services.

---

Commands​

/npcframe record <id>
Starts recording player movement and interactions.

/npcframe stop
Stops the current recording and saves it.

/npcframe gui
Opens the recording management GUI.

/npcframe start <id> <npc> [-all | -player]
Plays a recording once on the specified NPC.
-all = visible to everyone (default)
-player = visible only to the player who executed the command

/npcframe loop <id> <npc> [-all | -player]
Plays a recording in loop mode on the specified NPC.
-all = visible to everyone (default)
-player = visible only to the player who executed the command

/npcframe pause <npc>
Pauses playback for the specified NPC.

/npcframe resume <npc>
Resumes playback for the specified NPC.

/npcframe stoploop <npc>
Stops playback for the specified NPC.

/npcframe reload
Reloads plugin configuration.

Particle Command​

/particula <player> <world> <type> <x> <y> <z> <amount>
Spawns particles at the specified location.

• <player> — Target player
• <world> — World name
• <type> — Particle type
• <x> <y> <z> — Coordinates
• <amount> — Particle amount

RECORDED SEQUENCE​

PLAYBACK SEQUENCE​

LOOP SEQUENCE​

REVERSE SEQUENCE​

PAUSE AND RESUME SEQUENCE​

---

Support​

Discord: skripter0_