This extensive document serves as a comprehensive guide to Ink, a scripting language designed for crafting interactive narrative experiences, particularly branching stories and dialogues. It systematically breaks down Ink's features, starting with fundamental concepts like text content, comments, and tags for basic output. The core of Ink's narrative flow is built upon choices (player input options), knots (named sections of content), and diverts (seamless transitions between knots), enabling authors to create non-linear paths. The guide then introduces weaves, a more advanced and structured way to manage complex branching narratives by using gathers to automatically rejoin story paths and nesting to create deeper narrative layers within choices. It highlights how Ink handles variable text through sequences, cycles, once-only, and shuffles, allowing dynamic content generation. Furthermore, the document delves into sophisticated variables and logic, covering global variables for persistent game state, mathematical operations, conditional blocks (if/else), temporary variables for localized calculations, and powerful functions for reusable code. Advanced flow control is explored through tunnels (subroutines for returning to a previous point) and threads (forking narratives for parallel content streams). Finally, the guide introduces lists, a versatile data structure for tracking various states within the game, acting as flags, state machines, or object properties, enabling intricate world modeling and continuity. Writing with Ink Story Flow Variables and Logic Advanced Features State Tracking # Writing with i