/BlendMC

Cinematic Camera plugin for Minecraft that uses Blender motion paths for cutscenes.

Primary LanguageJavaMIT LicenseMIT

BlendMC

BlendMC: A Cinematic Camera plugin for Minecraft Spigot that uses Blender motion paths for cutscenes.

Examples • Usage • API

Examples

Click for full video: example

Usage

To use BlendMC, you'll need Blender 2.8 or newer installed on your computer. Once it's done, you can download the latest release of the BlendMC Exporter Addon here.

  1. Install Blender 2.8
  2. Install the BlendMC Exporter Addon here
  3. Select your camera, go to File > Export > BlendMC Camera Exporter, and save as a .blendmc file. Put this in your BlendMC plugin data folder.

API

Using the API is very simple.

To create a cutscene:

Player player = null; // However you get a player.
BlendCameraAnimation anim = BlendCameraAnimation.parse(
        new File(BlendMC.getInstance().getDataFolder().getAbsolutePath() + "/example.blendmc")); // The fully qualified path to your blendmc file.
// Create a cutscene with the camera start location being the player's current position.
BlendCutscene cutscene = new BlendCutscene(anim, player.getLocation());

To play that cutscene:

cutscene.play(player, () -> {
    // this optional callback is ran when the cutscene ends
});

If the cutscene is in the wrong direction, you can easily rotate it like this:

// Rotate the entire cutscene 90° right clockwise.
cutscene.rotateAllFrames((float) Math.toRadians(90));

Closing

Pull Requests and issues/feature requests are welcome!

Note: You are responsible for things like setting players to spectator mode. BlendMC does not do this automatically.