tgiann-npc-guide replaces traditional tutorial screens with an immersive, story-driven NPC guide system.

Instead of forcing new players to read long tutorial pages, players can explore the city, meet different NPCs, and learn how the server works directly from them. Each NPC can have their own personality, location, stories, voice, animations, and progression.

Players simply approach an NPC, press E, and start a conversation. Each visit reveals a new story about your server, from legal activities such as jobs, banking, licenses, and businesses to illegal activities such as robberies, black money, criminal records, and more.

Every NPC remembers what the player has already learned, turning server onboarding into a progressive experience instead of a one-time tutorial.

Main Features

• Story-Based NPC Tutorial System - Teach players about your server through interactive NPC conversations instead of traditional tutorial screens.

• Unlimited Custom NPCs - Create as many guide NPCs as you want, each with their own character, location, stories, voice, animations, cooldowns, and settings.

• Two Ready-to-Use NPCs - Includes Old Man for legal server content and Pablo for illegal content, with connected story progression.

• Multi-Language Support - All NPC dialogues and stories support multiple languages. Server owners can easily add new languages and customize all content for their server.

• Story Progression System - NPCs tell one story per visit and remember which stories each character has already heard.

• Memories System - Players can view previously discovered stories, replay them, and track their progress. Undiscovered stories remain hidden as ???.

• Sequential or Random Stories - Stories can be delivered in a predefined order or randomly.

• Individual NPC Cooldowns - Each NPC can have their own configurable cooldown between stories.

• Cinematic Conversations - NPC-focused camera, talking animations, facial expressions, and synchronized typewriter text create a more immersive conversation.

• Voice Narration System - Supports prerecorded audio files, browser-based text-to-speech, or completely disabled voice narration.

• Automatic TTS Fallback - Missing audio files can automatically fall back to browser text-to-speech.

• Automatic Voice Generator - Includes an edge-tts based generator that can regenerate NPC voiceovers after you modify their dialogue.

• Per-NPC Voice Settings - Configure language, voice, speed, pitch, and preferred TTS provider for each NPC.

• Customizable Dialogue UI - Typewriter effect, skip option, mute control, story selection, memories, and goodbye interactions.

• Dynamic NPC Dialogue - Greetings, farewells, cooldown responses, thinking lines, and completed-story responses can have multiple variations selected randomly.

• Character-Based Progress Saving - Discovered stories and cooldown progress are stored separately for each character.

• Highly Configurable - Customize NPC models, coordinates, interaction distance, spawn distance, camera, FOV, animations, story order, typewriter speed, cooldowns, voice settings, and more.