# Storymod — Mod Description
## English
**Storymod** is a custom Minecraft Forge 1.20.1 mod built for creating narrative, story-driven experiences inside Minecraft — essentially a toolkit for turning the game into an interactive visual novel / quest-driven adventure, with everything editable in-game through custom menus (no external editor needed).
**Core systems:**
- **Dialogue system** — branching conversations with custom NPCs. Each line can have a character name, icon, voice-over audio, a trigger key, and a display timer. Lines can branch into player choices (up to 9 options), set/require story flags, start quests, or trigger cutscenes. Three visual styles for the dialogue box (classic line, "Loloshka"-style, "Mex"-style), with a customizable glow color.
- **Quest system** — a quest editor and tracker (talk-to/kill/collect-type quests), with an on-screen quest HUD and a Quest Compass item that beams a particle trail toward the current objective's NPC.
- **Cutscenes** — scripted camera sequences with waypoints, played back with a cinematic letterbox overlay; a Cutscene Lens item lets you trigger any saved cutscene on demand.
- **Zones & Tours** — defined world regions and guided multi-stop tours.
- **Custom NPCs** — GeckoLib-animated NPCs with persistent emotions, custom skins (picked from a local folder, no file-dialog needed), saved NPC "profiles," and an animation **Montage** editor (a drag-and-drop timeline for chaining emotes/animations, synced to dialogue, with a live 3D preview).
- **Journal & Hub** — a journal screen tracking quests/decisions, and a central hub menu linking all the above systems.
- **Economy & progression** — a currency ("Render"/"Thoughts") and a diamond-based skill tree for leveling up, replacing an earlier item-based progression system.
- **Customization** — menu color themes, a dedicated in-game Settings screen, and an in-progress UI theme color picker (red/yellow/purple/blue).
- **Items** — besides the compass and cutscene lens: story items (an old key, a letter, a mysterious map, a memory crystal, a diary) that set story flags on use; NPC-interaction tools (a gift, a "thread" to make an NPC follow you, a time-freezing seal, a megaphone, a whistle); and a "Wanderer" clothing/armor set.
- **Help system** — an in-game help screen explaining UI buttons and concepts.
Everything is authored and edited entirely from in-game menus (dialogue editor, quest editor, cutscene editor, zone/tour editors), so a creator doesn't need to touch code to build a branching story with NPCs, quests, and cutscenes.
---
## Русский
**Storymod** — кастомный мод для Minecraft Forge 1.20.1, созданный для построения сюжетных, историй-ориентированных приключений прямо внутри Minecraft — по сути, конструктор, превращающий игру в интерактивную визуальную новеллу/квестовое приключение, где всё редактируется прямо в игре через собственные меню (без внешних редакторов).
**Основные системы:**
- **Система диалогов** — ветвящиеся разговоры с кастомными NPC. У каждой реплики можно задать имя персонажа, иконку, озвучку, букву-триггер и время показа. Реплики могут ветвиться на варианты ответа игрока (до 9 штук), ставить/проверять сюжетные флаги, запускать квесты или катсцены. Три визуальных стиля окна диалога (классическая линия, "как у Лололошки", "как у Мекса") с настраиваемым цветом свечения.
- **Система квестов** — редактор и трекер квестов (поговорить/убить/собрать), с HUD-индикатором на экране и предметом "Квестовый компас", который рисует след из частиц до NPC — цели квеста.
- **Катсцены** — срежиссированные сцены с точками камеры, проигрываются с кинематографичной чёрной полосой сверху/снизу; предмет "Линза катсцен" запускает любую сохранённую катсцену по желанию.
- **Зоны и туры** — заданные области мира и многоточечные экскурсии-туры.
- **Кастомные NPC** — анимированные через GeckoLib NPC с сохраняющимися эмоциями, кастомными скинами (выбор из локальной папки, без системного диалога выбора файла), сохранёнными "профилями" NPC и редактором анимаций **"Монтаж"** (таймлайн для сборки цепочек эмоций/анимаций, синхронизированных с диалогом, с живым 3D-превью).
- **Дневник и Хаб** — экран дневника с квестами/решениями игрока и центральное хаб-меню, объединяющее все системы.
- **Экономика и прокачка** — валюта ("Рендеры"/"Мысли") и алмазное дерево навыков для прокачки, заменившее прежнюю систему прокачки через отдельные предметы.
- **Кастомизация** — цветные темы меню, отдельный экран настроек прямо в игре, и (в разработке) выбор общего цвета темы интерфейса (красный/жёлтый/фиолетовый/синий).
- **Предметы** — помимо компаса и линзы: сюжетные предметы (старый ключ, письмо, загадочная карта, кристалл памяти, дневник), ставящие флаги сюжета при использовании; предметы для взаимодействия с NPC (подарок, "нить" чтобы NPC следовал за вами, печать, останавливающая время, мегафон, свисток); и комплект одежды/брони "Путник".
- **Система помощи** — экран подсказок, объигровых меню (редактор диалогов, редактор квестов, редактор катсцен, редакторы зон/туров) — автору не нужно тр) или оставить так, в чате?
Story (SM) Team
