BlockBuster engine

#BlockbasterEngine

Cinematic Engine for Minecraft

Blockbaster Engine is a powerful datapack for creating professional cinematics, cutscenes, and animated sequences directly in Minecraft. The engine provides a complete set of tools for recording, editing, and playing back complex scenes with multiple actors.

---

🎬 Key Features

Actor System

Create and manage virtual characters for your scenes:

• Actor creation with unique names and IDs
• Custom skins — apply any skins to actors
• Visibility control of names and display parameters
• Actor database with the ability to save and load
• Interactive menu for editing actor properties

Motion Recording

Capture player actions in real time:

• Frame-by-frame recording of all player movements, turns, and actions
• Save to storage for later use
• Playback via mannequins — precise repetition of recorded actions
• Support for multiple recordings for a single scene
• Indexing system for organizing large numbers of recordings

Scene Editor

A professional tool for creating Cinematography:

• Create and manage scenes with unique IDs
• Add multiple recordings to a single scene
• Link actors to recordings for synchronized playback
• Load and edit existing scenes
• Interactive menu with a user-friendly control interface

Playback System (Player)

Smooth and synchronized playback:

• Frame-by-frame execution of recorded actions
• Synchronize multiple actors in a single scene
• Control the player's camera during cutscene playback
• Automatic player state restoration upon completion
• Callback system for integration with other systems

Mannequin System

Advanced NPC playback system:

• Dynamic creation of mannequins with specified skins
• Frame-by-frame animation of movements and rotations
• Support Indexed records for optimization
• Automatic cleanup after playback completes
• Macro system for efficient data loading

---

🚀 Quick Start

Installation

1. Download the datapack
2. Place the blockbaster-engine folder in the datapacks directory of your world
3. Reload the world or run /reload

Launching the Editor

To work with Blockbaster Engine, use the visual editor instead of commands:

/function _blockbuster:open

After launching, the editor interface will open with a menu in the actionbar (above the hotbar).

---

🎮 Working with the Editor

Interface Controls

Menu Navigation:

• Mouse Wheel (Slot Change) — Switch between menu items
• RMB (Right Mouse Button) — Select the current menu item

Main Menu Structure:

1. 🔴 Record — Start recording movements
2. ⏹ Stop — Stop the current recording
3. ▶ Play — Play the last recording
4. 🎬 Scenes — Open the scene management menu
5. 🎞 Cutscene — Cutscene Editor
6. 👤 Character — Actor Management Menu
7. ❌ Exit — Close the editor

Creating Your First Scene

Step 1: Open Editor

/function _blockbuster:open

Step 2: Create a Character

• Scroll to 👤 Character
• Right-click to open the menu
• Select the desired action (create, list, edit)

Step 3: Record Actions

• Scroll to 🔴 Record
• Right-click to start recording
• Perform the desired actions (move, turn, jump)
• Scroll to ⏹ Stop and right-click

Step 4: Create a Scene

• Scroll to 🎬 Scenes
• Right-click to open the scenes menu
• Create a new scene and add recordings

Step 5: Play

• Select ▶ Play to preview the results

---

🎯 Character Menu

After selecting 👤 Character in the main menu:

1. Character List — view all created actors
2. Stop All — stop playback of all mannequins
3. Back — return to the main menu

Working with Characters

• Create actors with unique names
• Assign custom skins
• Manage name visibility
• Link recordings to specific characters

---

🎬 Scene Menu

After selecting 🎬 Scenes in the main menu:

• Create Scene — new cinematic scene
• Scene List — all saved scenes
• Edit — change scene parameters
• Add Recording — link a recording to a scene
• Play — start a scene

Working with Scenes

• One scene can Contain multiple recordings
• Each recording is linked to a specific actor
• Automatic synchronization of all actors during playback
• Saving scenes to files for reuse

---

🔧 Technical features

Data Storage System

• Use of storage for temporary data
• Loot tables** for persistent storage of scenes and actors
• Predicates** for conditional logic and checks

Optimization

• Indexed system** for working with large numbers of records
• Macro functions** for dynamic data loading
• Efficient memory management** by cleaning up unused data

Integration

• Callback system** for interacting with other datapacks
• Cutscene Engine support** for advanced features
• Modular architecture** for easy functionality expansion

---

📋 Requirements

• Minecraft version**: 1.21.9+
• Game mode**: Any (Creative recommended for ease of use)
• Permissions**: Operator for executing commands

---

🎯 Usage Examples

Creating a Dialogue Scene

1. Create two actors with different skins
2. Record movements for each character
3. Create a scene and add both recordings
4. Adjust timing using the scene editor
5. Play the final scene

Cinematic Cutscene

1. Record camera (player) movement
2. Add actor recordings for background characters
3. Use the playback system to control the camera
4. Integrate with Cutscene Engine for additional effects

---

🤝 Integration with Other Systems

Blockbaster Engine supports integration via:

• Callback Functions — calling custom functions when events occur
• Storage API — accessing scene and actor data
• Predicate System — conditional logic for complex scenarios

---

Create cinematic masterpieces in Minecraft with Blockbaster Engine! 🎬✨