StarScript

StarScript

Transform Minecraft into a powerful story-driven experience engine.

StarScript enables you to create branching narratives, interactive quests, and dynamic storytelling experiences entirely through JSON—no Java coding required. Build immersive story-driven gameplay that reacts to player choices, world events, and in-game actions.

This is the canonical documentation file for the mod and story authoring workflows.

Key Features

Core Story System

• JSON-Based Story System – Define complex narratives with branching paths and multiple endings
• Dynamic Triggers – React to player actions, world events, boss defeats, biome discoveries, and more
• Cinematic Effects – Fade transitions, overlays, camera effects, and visual novel mode
• Save/Load System – Multiple save slots with persistent player progress
• Advanced Variables – Track reputation, counters, flags, and dynamic story state

Combat & Boss Systems

• Boss Phases – HP-triggered story nodes, mid-fight dialogue, and phase-based mechanics
• Arena Locking – Prevent escape until victory or defeat
• Enhanced Death System – 10 types of consequences (XP loss, curses, corruption, etc.)
• Visual Effects – Particle bursts, continuous auras, sounds, and screenshake

Relics & Progression

• Relic State Machine – Items transform between Dormant → Awakened → Corrupted
• Relic Crafting – Craft and upgrade relics through story progression
• Recipe Unlocking – Progressive recipe discovery system
• Story-Bound Items – Items that only work during specific story nodes
• Item Binding Presets – 10 pre-configured item behavior templates

World & Discovery

• Soft Discovery – Environmental hints (sounds, particles) with no markers or arrows
• First-Discovery Flags – Only first player sees intro, others get altered dialogue
• Region Memory – World regions remember events and stay changed
• Structure Variants – Buildings transform based on story (pristine/corrupted/destroyed)
• Delayed Generation – Structures spawn after story triggers

Visual & UI

• Lore GUI – Interactive journal for viewing collected pages, memories, and visions
• Boss Phase Effects – 15+ particle types, 10+ sound effects
• Arena Templates – 8 pre-built arena configurations

Developer Tools

• Performance Optimized – Efficient trigger system suitable for multiplayer servers
• Developer Friendly – Hot-reload support, debug commands, and comprehensive API
• Templates & Presets – Ready-to-use configurations for quick development
• Builder Pattern API – Type-safe programmatic story creation