FAQ - superstrellaa/CinematicTools GitHub Wiki

❓ Frequently Asked Questions (FAQ)

Here you'll find answers to the most common questions about CinematicTools. If you still need help, feel free to open an issue on GitHub or check the community discussion.

πŸ“¦ Installation Issues

❓ The mod doesn't show up or crashes on launch

βœ… Solution:

  • Make sure you're using Fabric Loader, not Forge or other loaders.
  • Check that you have the required dependencies:
    • fabric-api
    • geckolib
    • creativecore
  • Ensure all .jar files are placed in the mods/ folder.

❓ /cinematic-client doesn't work

βœ… Solution:

  • The client-side part of the mod must be installed on the client, not just the server.
  • Use /cinematic-client in a singleplayer world or from a player on the server with OP level.

πŸ› οΈ Commands

❓ What's the difference between /cinematic-client and /cinematic-server?

  • /cinematic-client is used to create and configure camera paths locally on your client.
  • /cinematic-server is used to save, load, and execute cinematic sequences server-side (for multiplayer or consistent playback).

❓ How do I create a cinematic?

  1. Use /cinematic-client add to create points.
  2. Adjust settings (duration, interpolation, follow, etc).
  3. Use /cinematic-client save myScene to save it.
  4. Use /cinematic-server start myScene <players> to launch it for players.

πŸ“„ See Commands for more.

🧍 NPC / Actors

❓ Can NPCs be animated?

Yes! Use:

/cinematic-server npc animation play <animation>

🧠 Animations must be defined using your model and resource files (e.g. GeckoLib animations).

❓ How do I make an NPC move?

Use:

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

Or for faster movement:

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

πŸ’Ύ Saving & Loading

❓ Where are cinematics saved?

Cinematics are saved server-side, as NBTs in the world:

.minecraft/saves/<world>

You can play them using:

/cinematic-server start <cinematic> <players>

πŸ§ͺ Other Questions

❓ What are interpolations?

Interpolations control the smoothness of camera transitions. Available types:

  • linear
  • circular
  • cosine
  • cubic
  • hermite
  • invcular
  • all (toggle all types)

Use:

/cinematic-client interpolation <type>

❓ What does smooth_start do?

It adds a soft transition from the player’s current position to the first camera point to avoid a jarring cut.

/cinematic-client smooth_start true

❓ What's spinning_fix?

πŸŒ€ It tries to prevent sudden camera spinning due to large yaw differences between points. Only use it if you notice weird spin behavior.

πŸ™‹ Need More Help?

  • Open an issue on GitHub
  • Request help in the Modrinth or CurseForge comment section

πŸŽ₯ Make something epic β€” and don't forget to wave those NPCs!

⚠️ **GitHub.com Fallback** ⚠️