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