THE HISTORY SCENE

📽️ THE HISTORY SCENE – Cinematic Intros for Modpacks
Turn your world’s first impression into an unforgettable legend.

The History Scene is a high-impact, plug-and-play tool for modpack creators and developers. Inspired by the atmospheric openings of Dark Fantasy masterpieces, this mod allows you to inject visual and auditory narratives (cutscenes) the moment a player steps into the world for the first time.

Display concept art, establish your project’s lore, and set the mood with seamless transitions and synchronized narration. No coding required, no headaches.

Update v1.5

Audio files can now be placed in a single file in block 1.

Useful recommendations:

1. ALWAYS use audio files in .wav format.

✨ Key Features
100% Customizable: Full freedom to use your own illustrations (.png) and soundtracks/voiceovers (.wav).

Plug & Play Workflow: Forget complex resource packs. Everything is intuitively managed within the config folder.

Dynamic Transitions: Mathematically calculated Fade In/Out effects to ensure smoothness, regardless of screen time.

Safety & Immersion: The game automatically pauses in the background (Singleplayer) during the sequence. Players can skip at any time by pressing ESC.

Developer API: Use code hooks to trigger scenes after specific events (e.g., defeating a boss or entering a new dimension).

🛠️ Configuration Guide (For Creators)
Auto-Generation: Install the mod and launch the game once. The config/the_history_scene/ folder will be created.

Asset Preparation: Place your images (.png) and audio files (.wav) inside this folder.

Pro Tip: Use 1920×1080 (16:9) images to avoid stretching.

Scene Editing: Open the generated scene.json file to define your story sequence.

Configuration Example (scene.json):
JSON
[
{
“image”: “kingdom_intro.png”,
“audio”: “dark_wind.wav”,
“durationSeconds”: 8.0,
“fadeSeconds”: 2.0
},
{
“image”: “modpack_logo.png”,
“audio”: “final_narration.wav”,
“durationSeconds”: 5.0,
“fadeSeconds”: 1.5
}
]
image: Exact image file name.

audio: Audio file name (use “” for silence).

durationSeconds: Total time the slide stays on screen.

fadeSeconds: Transition time (e.g., 2.0 = 2s to fade in, 2s to fade out).

💻 API Documentation (For Developers)
Integrate The History Scene natively into your mod or script:

Java
// Inject a slide dynamically via code
HistorySceneAPI.injectSlide(“boss_event.png”, “victory.wav”, 10.0f, 2.0f);

// Trigger the cutscene on a specific event
HistorySceneAPI.playCutscene();

// Clear the current playback queue
HistorySceneAPI.clearSlides();