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
