CinematicTools includes an integrated NPC System that allows you to summon, control, and animate NPCs in your cinematics. This system is essential for adding life and movement to your cutscenes. NPCs are managed using the /cinematic-server npc subcommands.

✅ Summon static or animated NPCs
✅ Make NPCs walk, run, or jump
✅ Play, resume or stop custom animations
✅ Full position, yaw, and pitch control
✅ Server-side synced for multiplayer compatibility

All NPC commands are available under:

/cinematic-server npc <action> <args...>

/cinematic-server npc summon <name> <x> <y> <z> <yaw> <pitch>

🚀 Example:

/cinematic-server npc summon Bob 100 65 -23 90 0

🧾 Description:

Summons an NPC named Bob at the specified location and rotation. If the name is already in use, it will override the previous NPC.

/cinematic-server npc walk <name> <x> <y> <z>

🚀 Example:

/cinematic-server npc walk Bob 110 65 -30

🧾 Description:

Makes the NPC walk to the given location at a standard walking speed.

/cinematic-server npc run <name> <x> <y> <z>

🚀 Example:

/cinematic-server npc run Bob 120 65 -40

🧾 Description:

Commands the NPC to run to the given coordinates at a faster speed.

/cinematic-server npc jump <name>

🚀 Example:

/cinematic-server npc jump Bob

🧾 Description:

Makes the NPC jump in place. Useful for adding character or reactions during cinematics.

/cinematic-server npc animation <play|resume|stop> <animationName>

🚀 Example:

/cinematic-server npc animation play run

🧾 Description:

Plays, resumes or stops a specific animation on all NPCs (or specific ones depending on setup).
Animations must be pre-defined in your resource pack or mod.

• play <animation> — Starts the animation.
• resume <animation> — Resumes a paused animation.
• stop <animation> — Stops the animation.

ℹ️ If you need to target specific NPCs for animations, this might require expansion in your system later.

• Use unique names for each NPC to prevent conflicts.
• For cleaner transitions, use a mix of walk/run + animation.
• Combine NPC control with camera movement to create immersive scenes.

Here’s a quick setup for a cinematic with one actor:

/cinematic-server npc summon Alice 100 65 -20 180 0
/cinematic-server npc walk Alice 110 65 -25
/cinematic-server npc animation play jump

🧪 This would make "Alice" walk to a location and wave once she arrives. Combine with /cinematic-server start to launch the scene.

• Commands
• FAQ
• Getting Started