NPCFrame Recorder v2.0.0

This new version introduces a complete restructuring of the plugin's internal system. We have focused on making cinematics completely lag-proof, reducing resource consumption to a minimum, and making configuration much easier for server administrators.

Extreme Performance & Stability​

• Lag-Proof Cinematics (Anti-Desync): Previously, if your server experienced a lag spike or a drop in TPS, NPC animations would slow down or desync from the world. That is a thing of the past! Movement is now calculated in real-time; if the server stutters, the NPC will instantly adjust to be exactly where it should be, keeping the cinematic flawless.
• Virtually Zero CPU Usage: The way the plugin reads movement data has been completely rewritten. Animations are now pre-loaded instantly into the server memory. Say goodbye to constant heavy processing—it is now a smooth operation that generates no garbage collection or CPU overload.
• TPS Optimization: We eliminated thousands of hidden background tasks that were generated when handling irregular movements. Everything is now processed in a single clean cycle, saving your machine's valuable resources.
• Safer Internal Engine: We simplified the "brain" of the plugin. Animations are now grouped intelligently. If you stop an NPC, the plugin instantly cleans up after itself, preventing "ghost processes" or memory leaks on your server.

New Features & Ease of Use​

• Automatic Configuration (Plug & Play): You no longer have to create files by hand. When you install this version and start the server, the plugin will automatically generate the sync_groups.yml file with a ready-to-use template.
• NEW COMMAND: Manual Synchronization (/npcframe sync) Make multiple NPCs perform different actions at the exact same time right from the chat or console, without touching the configuration files.
  • Usage: Pair the recording file and the NPC name using a colon.
  • Example: /npcframe sync <recording1:npc1> <recording2:npc2> [-player]
• NEW COMMAND: Group Synchronization (/npcframe syncgroup <group>) Do you have a complex scene saved in your sync_groups.yml? Execute it with a single command. The system will read your configuration and trigger all required NPCs simultaneously. It works both globally and locally (using -player so only a specific player sees it).

General Improvements​

• Console Cleanup: Fixed multiple minor bugs (such as missing permission warnings or command parsing errors) that used to clutter the console.

Update: Performance & Persistence​

Loop Persistence:
NPCs in loop mode now automatically resume their movement after a server restart. A smart retry system ensures they start even if the world or the NPC takes time to load.


Async Processing:
Heavy recording files are now loaded asynchronously. This eliminates server lag during startup or when loading long paths.


Safety Save:
Your recordings are protected. If the server shuts down or crashes while a recording is in progress, the plugin will automatically save the data.


Recording Protection:
The system now includes protection to prevent overwriting existing recordings. If you try to record using a name that already exists, the plugin will prevent the previous file from being accidentally deleted.


Visibility Modes:
We’ve simplified visibility. You can now use:

• -all (default, visible to everyone)
• -player (visible only to the user)

Toggle Reverse:
The walking direction can now be swapped instantly with the new toggle system.


Command Update:
The default command is now /npcframe. The /caminar command has been kept as a subcommand for compatibility.

Permissions Update:
Permissions have been updated and reorganized. Please check the permissions section on the main page for the updated list and usage.​

Important Note:
Do not delete the loop .yml file. This file stores the NPC loops so they can automatically start when the server launches. Deleting it may cause errors or prevent loops from running correctly.

Added console support for caminar.
Improved performance and synchronization.
Fixed minor stability issues.
updates now apply only when changes occur.


Fixed console execution issues and minor playback stability problems.

- Added proper permission checks to all commands