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: ```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 **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** ```mcfunction /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!** 🎬✨