⛩️ 동방환유기 東方幻遊記 ～ Wanderer of Gensokyo 🦋

## ⛩️ Touhou Wanderer of Gensokyo / 東方幻遊記 v1.07 🖼 **13,466 total assets (SFW 4,170 + mature 9,296)** · 🎬 **30+ scenarios** · 👥 **155+ characters** · 🎙 **9 parallel-world narrators** · 🎛 **many detail toggles** · 🌐 **KR/EN/CN/JP UI & first messages** · 🌙 **mature storage module+** A free-entry Gensokyo (幻想郷) roleplay bot built around incidents, wandering, encounters, danmaku, and a cup of tea. {{user}} may enter as a canon character, an outsider, a local, or an intruder; the bot never fixes your role for you. ## 📦 Asset Storage Module (REQUIRED) Character images and spell effects use files from a **separate asset storage module**. The bot owns lore, regex, Lua, rendering, and safety behavior; the module only stores assets. Download and install it together from the link below. ### ▶ https://drive.proton.me/urls/3MTNF20B44#p49Biwv6Uo6X <details> <summary><strong>📖 Features & Settings</strong></summary> ### Features - Scenario-select first messages: per-work main/extra, free, gag, and danmaku codex. - Bunbunmaru-newspaper-style status panel. - Automatic, scene-matched character asset insertion with a reroll button (main model / AUX sub-model / local Lua). - Unique spell cut-ins and a danmaku-codex effect layer. - The World time stop, TSP growth/recovery, and release result panel. - Future Plan proactive appearance candidate preparation. - 9 parallel-world narrators with a canon-based address/honorifics guide. - A 155-character NPC roster plus individual profile lore. - Detail toggles: Canister mode (default / SEMI / FULL), chaos tone, man-eating, dark, official-detail density, mature content, and more. - Korean / English / Chinese / Japanese UI and first messages. ### Recommended - Use **AUX** for the best semantic accuracy or **local Lua** for free, repeatable output without an extra model call. Direct main-model output is also supported. - The default tone is **canon**. Turn on **Chaos** for heavier fan-comedy, or **Dark / Man-eating** for a crueler atmosphere. With mature content off, the mood softens automatically. - For a lighter prompt use **Canister: SEMI** (operating rules only); for a near-raw run use **FULL**. - Asset emotion matching quality depends on the sub-model and its reasoning settings. If an asset looks wrong, use the reroll button below the message. </details> <details> <summary><strong>🩹 Patch Notes</strong></summary> ### v1.07 - Separated generic class cues from persistent identity aliases and blocked short-alias pollution and mention-only activation, fixing wrong-character and wrong-mob asset output. - Improved mature-scene owner, body-target, pose, and contact binding; removed forced generic-mob defaults and deterministic pose reselection after AUX output. - Switched AUX responses to dense semantic line numbers with safe physical-line mapping, preventing blank or protected lines from causing omitted or misplaced assets. ### v1.06 - Fixed missing Lua/AUX asset and status-panel post-processing on initial output, plus raw `<news>` transport left in the message. - Split status authority into Main and AUX. Main consumes only Main transport; AUX discards Main status transport and makes one status call per response. ### v1.05 - Improved AUX and Lua owner/emotion separation, explicit pose correction, sequential target/climax tracking, multi-character state, and automatic-output/reroll consistency. - Stored-chat validation reached **97.5% owner precision**, **82.7% owner recall**, and **89.5% owner F1**; unique outputs rose **13.4%**, duplicates fell **47.0%**, and visible-text pollution remained at zero. - Asset matching runtime stayed within **±3%** of v1.04. The display pipeline was also reduced by **18%** for sidebar source, **98%** for duplicated mature regex, and **33%** for Lua asset data; a real-engine display sample was about **35% faster**. ### v1.04 - Added a **local Lua asset output mode** that does not use the auxiliary model. It inserts character expressions/portraits by matching the message text directly, so it works without an AUX model. However, since it relies on keyword matching rather than contextual understanding, **misfires and misplacements are frequent — please use it with caution.** For accuracy, the auxiliary (AUX) asset output is still recommended. ### v1.03 - Unified generic mob SFW/mature asset tags into base tags, with display-time random rendering for variants. - Optimized AUX asset output for generic mobs, short-alias mentions, recent context, and mature scene matching. - Expanded The World result panel into during / after / thoughts sections, with SFW/mature-aware release summaries. - Added Future Plan controls for model, max group count, activation chance, and cooldown. - Added Bunbunmaru rumor-intake display for Future Plan candidates without replacing the newspaper body. - Improved Bunbunmaru privacy handling for explicit scenes and stopped-time actions. - Clarified The World guidance for frozen living targets, repositioned bodies, and projectiles. ### v1.02 - Reorganized settings tabs into **Display & Assets / Tone & Events / Narration & System**. - Stabilized Future Plan activation. The default cooldown is 2 turns, the default activation rate is 100%, and local candidate selection is used as a fallback if AUX returns no candidate. - First-message Bunbunmaru status variables now update from the selected scenario metadata. Per-card <news|...> metadata is used only for variable injection and is not exposed in the message body. - Unified status-panel output around variables plus markers, and cleaned up legacy <news|...> / <tw|...> render paths and accumulated tag leftovers. - Bunbunmaru status panels and The World result/status panels now display only for the latest relevant output to prevent display buildup. - Stabilized AUX status-panel updates and marker reattachment after reroll. - Fixed Korean status text being cut by byte length, which could truncate sentences mid-word or produce broken characters. - Adjusted The World time-stop turn handling and release-result timing, with a separate dedicated result-panel design. - Future Plan no longer displays rumor lines for null targets. ### v1.01 - Added the "The World" time-stop system — freeze time for up to 3 actions, gated and grown by a TSP resource and restored by sleeping, with an aftermath reaction scaled to the action intensity on release (sidebar toggle, off by default). - Added "Future Plan" — prepares context-appropriate characters to appear proactively in the scene (sidebar toggle, off by default). - Added an on/off toggle for the Bunbunmaru newspaper panel. - Added mob characters (villagers, fairies, inaba, a fairy maid). - Expanded Chinese (CN) UI text for new features such as The World and TSP. - Fixed mob character images not displaying in some cases. - Added friendly🌸 / hostile⚔️ colored system-message banners for random encounters (can be triggered manually from the sidebar). - Fixed first-message scenario cards overlapping the chat input menu on some themes/resolutions. - Improved asset auto-tagging detection for given-name mentions such as Patchouli and Flandre. - Cleaned up non-canon / externally sourced OC entries. </details> <details> <summary><strong>📜 License · References · Thanks</strong></summary> ### License — CC BY-NC-SA 4.0 - **The creator's original work** — system design, code, regex pipeline, Lua scripting, sidebar UI, spell-card cut-in effects, the 文々。新聞 status panel, lorebook structure, asset-prompt design, etc. — is licensed under **CC BY-NC-SA 4.0** (Attribution–NonCommercial–ShareAlike). You may remix, adapt, and build upon it as long as you credit **Canister** and keep it non-commercial, **provided that any derivative work is released under the same CC BY-NC-SA 4.0 license**. - **Touhou Project original IP** (characters, settings, world, music, etc.) belongs to **Team Shanghai Alice (ZUN / 上海アリス幻樂団)** and follows the official Touhou Project Derivative Work Guidelines. This bot is an **unofficial fan work**. - The CC license does not grant rights to the Touhou IP itself; derivative works must separately comply with Touhou guidelines. © **Canister** — Unofficial Touhou Project fan work ### References & Thanks - Parts of the parallel-world narrator's operating rules and ideas were referenced and adapted from the "Custom Narrator" lorebook of the **Touhou General Module** (by its author on the AI-chat community board). Rights to those portions remain with the original author. Thanks to the author for sharing such a solid foundation. - The initial concept and ideas for this bot were inspired in part by the **Touhou Project Simulator** bot. Thanks to that work for the inspiration. </details>