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: - Interactive menu with unique names and IDs - Interactive menu — apply any skins to actors - Interactive menu of names and display parameters - Interactive menu with the ability to save and load - Interactive menu for editing actor properties

Motion Recording

Capture player actions in real time: - Indexing system of all player movements, turns, and actions - Indexing system for later use - Indexing system — precise repetition of recorded actions - Indexing system for a single scene - Indexing system for organizing large numbers of recordings

Scene Editor

A professional tool for creating Cinematography: - Interactive menu with unique IDs - Interactive menu to a single scene - Interactive menu for synchronized playback - Interactive menu existing scenes - Interactive menu with a user-friendly control interface

Playback System (Player)

Smooth and synchronized playback: - Callback system of recorded actions - Callback system in a single scene - Callback system during cutscene playback - Callback system upon completion - Callback system for integration with other systems

Mannequin System

Advanced NPC playback system: - Macro system of mannequins with specified skins - Macro system of movements and rotations - Macro system for optimization - Macro system 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:

```mcfunction /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

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

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

Creating Your First Scene

Step 1: Open Editor ```mcfunction /function _blockbuster:open ```

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

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

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

▶ Play - Select ▶ Play to preview the results

---

🎯 Character Menu

After selecting 👤 Character in the main menu:

1. Back — view all created actors 2. Back — 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:

- Play — new cinematic scene - Play — all saved scenes - Play — change scene parameters - Play — 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 for persistent storage of scenes and actors - Predicates 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: - Predicate System — calling custom functions when events occur - Predicate System — accessing scene and actor data - Predicate System — conditional logic for complex scenarios

---

Create cinematic masterpieces in Minecraft with Blockbaster Engine! 🎬✨