# Technical Documentation: Grasscutters/Grasscutter > ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/Grasscutters/Grasscutter) ### Overview (`README.md`)

[EN](README.md) | [简中](docs/README_zh-CN.md) | [繁中](docs/README_zh-TW.md) | [FR](docs/README_fr-FR.md) | [ES](docs/README_es-ES.md) | [HE](docs/README_HE.md) | [RU](docs/README_ru-RU.md) | [PL](docs/README_pl-PL.md) | [ID](docs/README_id-ID.md) | [KR](docs/README_ko-KR.md) | [FIL/PH](docs/README_fil-PH.md) | [NL](docs/README_NL.md) | [JP](docs/README_ja-JP.md) | [IT](docs/README_it-IT.md) | [VI](docs/README_vi-VN.md) **Attention:** We always welcome contributors to the project. Before adding your contribution, please carefully read our [Code of Conduct](https://github.com/Grasscutters/Grasscutter/blob/stable/CONTRIBUTING.md). ## Current features * Logging in * Combat * Friends list * Teleportation * Gacha system * Co-op *partially* works * Spawning monsters via console * Inventory features (receiving items/characters, upgrading items/characters, etc) ## Foreward ### **Grasscutter beyond the latest release will have no handholding in terms of instructions.** Grasscutter has not been actively maintained and currently (as of January 12th, 2025) only works up to version REL4.0.1 (introduction to Fontaine). If you have a beta version/unofficial version of Grasscutter, this guide should theoretically still work, however, we will not provide official support these versions. You can still try your luck in the Discord if you are stuck, but please don't act entitled. ## Quick setup guide **Note**: For support please join our [Discord](https://discord.gg/T5vZU6UyeG). ### Quick Start (automatic) - Get [Java 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) - Get [MongoDB Community Server](https://www.mongodb.com/try/download/community) - Get game version REL4.0.x (If you don't have a 4.0.x client, you can find it here and open any of the links to download it): [4.0.x Client-github](https://github.com/JRSKelvin/GenshinRepository/blob/main/Version%204.0.0.md) [4.0.x Client-cloud drive](https://www.123pan.com/s/HoqUVv-U7SBA.html) - ***UPDATE JAN 12, 2025: YOU CANNOT MIX AND MATCH GAME VERSIONS AND SERVER VERSIONS, PLEASE DOWNLOAD THE CORRECT VERSION OF GRASSCUTTER FOR YOUR VERSION OF THE GAME.*** - Download the [latest Cultivation version](https://github.com/Grasscutters/Cultivation/releases/latest). Use the `.msi` installer. - After opening Cultivation (as admin), press the download button in the upper right corner. - Click `Download All-in-One` - Click the gear in the upper right corner - Set the game Install path to where your game is located. - Set the Custom Java Path to `C:\Program Files\Java\jdk-17\bin\java.exe` - Leave all other settings on default - Click the small button next to launch. - Click the launch button. - Log in with whatever username you want. Password can be anything. ### Building Grasscutter uses Gradle to handle dependencies & building. **Requirements:** - [Java Development Kit 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) or higher - [Git](https://git-scm.com/downloads) - [NodeJS](https://nodejs.org/en/download) (Optional, for building the handbook) ##### Clone ```shell git clone --recurse-submodules https://github.com/Grasscutters/Grasscutter.git cd Grasscutter ``` ##### Compile **Note**: Handbook generation may fail on some systems. To disable the handbook generation, append `-PskipHandbook=1` to the `gradlew jar` command. Windows: ```shell .\gradlew.bat # Setting up environments .\gradlew jar ``` Linux (GNU): ```bash chmod +x gradlew ./gradlew jar ``` ##### Compiling the Handbook (Manually) With Gradle: ```shell ./gradlew generateHandbook ``` With NPM: ```shell cd src/handbook npm install npm run build ``` You can find the output jar in the root of the project folder. ### Troubleshooting For a list of common issues and solutions and to ask for help, please join [our Discord server](https://discord.gg/T5vZU6UyeG) and go to the support channel. --- ### Overview (`docs/quests/README.md`) # Quest Documentation These are the [Wiki Files](https://github.com/Anime-Game-Servers/Grasscutter-Quests/wiki) from Grasscutter-Quests.\ ## Sections - [**Missing Scripts**](Missing-Scripts.md) - These are Lua scripts which are required for functionality of certain game elements. - [The Outlander Who Caught the Wind (Prologue Act 1)](lines/The-Outlander-Who-Caught-the-Wind-(Prologue-Act-1).md) --- ### Overview (`docs/events/windtrace/README.md`) # Hide and Seek! Documentation on how the **Hide and Seek** game works.\ Externally dubbed: `Windtrace`. # Map IDs TODO: Document the map IDs of Windtrace. TODO: Investigate `ServerGlobalValueChangeNotify` # Asking Players to Play in a Co-Op Game 1. The client will send `DraftOwnerStartInviteReq` 2. The server will send `DraftOwnerInviteNotify` to all clients. 3. The server will send `DraftOwnerStartInviteRsp` # Matching in a Co-Op Game 1. World owner talks to Gygax and begins a Windtrace game. 2. The packet `DraftOwnerInviteNotify` is sent to clients. 3. Clients will respond with `DraftGuestReplyInviteReq` (client-side) 4. The server will respond with `DraftGuestReplyInviteRsp` 5. The server will respond with `DraftInviteResultNotify` # Starting Windtrace 1. If `DraftInviteResultNotify` is a success, the server will send a series of packets. 1. A series of `SceneEntityAppearNotify` packets. 2. `NpcTalkStateNotify` 3. `PlayerEnterSceneNotify` 4. `MultistagePlayInfoNotify` 2. The players are then teleported to the Windtrace map in their locations. 3. Server will send packets to clients. (this is server boilerplate) 4. The server sends another `MultistagePlayInfoNotify` to clients. # Changing Avatars - Others 1. The server will send a `AvatarEquipChangeNotify` packet to clients. 2. The server will send a `SceneTeamUpdateNotify` packet to clients. 3. The server will send a `HideAndSeekPlayerSetAvatarNotify` packet to clients. # Getting Ready 1. The client will send `HideAndSeekSetReadyReq` to the server. 2. The server will reply with `HideAndSeekPlayerReadyNotify` to clients. 3. The server will send `MultistagePlayInfoNotify` to clients. 4. The server will reply with `HideAndSeekSetReadyRsp` to the client. 5. If all players are ready, the server will move on to start Windtrace. # Starting Windtrace 1. When all players are ready, the server will send a series of packets to players. 1. `GalleryStartNotify` 2. `SceneGalleryInfoNotify` 3. `MultistagePlayInfoNotify` 4. `MultistagePlayStageEndNotify` 5. This will only get sent at the `1.` countdown. ### Notes: - `GuestReplyInviteRsp` is sent **after** `DraftInviteResultNotify`. ## `DraftOwnerInviteNotify` - `invite_deadline_time` - This is the time when the invite expires. - `draft_id` - The value is always `3001` for Windtrace. ## `DraftOwnerStartInviteReq` - `draft_id` - The value is always `3001` for Windtrace. ## `DraftOwnerStartInviteRsp` - `draft_id` - The value is always `3001` for Windtrace. - `invite_fail_info_list` - A list of players who weren't invited. - `retcode` - The response code. - `wrong_uid` - Always `0`. (undocumented) ## `DraftGuestReplyInviteReq` - `draft_id` - The value is always `3001` for Windtrace. - `is_agree` - A boolean value for whether the client accepts the invite. ## `DraftGuestReplyInviteRsp` - `draft_id` - The value is always `3001` for Windtrace. - `retcode` - Response code for the request. - `is_agree` - A boolean value for whether the server acknowledges the client's invite acceptation. ## `DraftInviteResultNotify` - `draft_id` - The value is always `3001` for Windtrace. - `is_all_agree` - A boolean value for whether all clients accepted the invite. ## `NpcTalkStateNotify` - `is_ban` - This value is always true when entering Windtrace. ## `PlayerEnterSceneNotify` - `pos` - This is where the player will be teleported to. - This value depends on if the player is a hunter or a runner. - This value is set by the server and must be hardcoded/read from a JSON file. ## `MultistagePlayStageEndNotify` - `play_index` - Value picked by the server. (use 1) - `group_id` - This value is always `133002121` for Windtrace. ## `MultistagePlayInfoNotify` - Initial + PostEnterSceneReq - Image Reference: - `info` - MultistagePlayInfo data. - `group_id` - The value is always `133002121` for Windtrace. - `play_index` - Value picked by the server. (use 1) - `hide_and_seek_info` - Information about Windtrace. - `hider_uid_list` - A list of UIDs (ints) of the hiders. - `hunter_uid` - The UID (int) of the hunter. - `map_id` - The ID of the Windtrace map. - `stage_type` - Windtrace state. - This will be `HIDE_AND_SEEK_STAGE_TYPE_PREPARE`. - `battle_info_map` - Contains a dictionary of UID -> `HideAndSeekPlayerBattleInfo` objects. - `skill_list` - Array of 3 values of skill IDs chosen by the player. - `avatar_id` - The ID of the avatar the player wants to use. - `is_ready` - The player's in-game ready state. - `costume_id` - The costume the player's avatar is wearing. ## `MultistagePlayInfoNotify` - Picking Avatars - Image Reference: - **Note:** This packet matches the initial structure and data. - `info.hide_and_seek_info.stage_type` - This will be `HIDE_AND_SEEK_STAGE_TYPE_PICK`. ## `MultistagePlayInfoNotify` - Starting Windtrace - Image Reference: - **Note:** This packet matches the initial structure and data. - `info.hide_and_seek_info.stage_type` - This will be `HIDE_AND_SEEK_STAGE_TYPE_HIDE`. ## `MultistagePlayInfoNotify` - Seeking Time - Image Reference: - **Note:** This packet matches the initial structure and data. - `info.hide_and_seek_info.stage_type` - This will be `HIDE_AND_SEEK_STAGE_TYPE_SEEK`. ## `MultistagePlayInfoNotify` - Finish Windtrace - Image Reference: - **Note:** This packet matches the initial structure and data. - `info.hide_and_seek_info.stage_type` - This will be `HIDE_AND_SEEK_STAGE_TYPE_SETTLE`. ## `HideAndSeekPlayerSetAvatarNotify` - `avatar_id` - The ID of the new avatar the player wants to use. - `uid` - The UID of the player who changed their avatar. - `costume_id` - The costume the player's avatar is wearing. ## `HideAndSeekSetReadyRsp` - `retcode` - Response code for the request. ## `HideAndSeekPlayerReadyNotify` - `uid_list` - A list of UIDs (ints) of the players who are ready. ## `GalleryStartNotify` - `gallery_id` - TODO: Check if this value is always `7056` for Windtrace. - `start_time` - This value is always `2444` for Windtrace. - This value is `200` when displaying game end statistics. - `owner_uid` - The UID of the player who started the Windtrace game. - `player_count` - The number of players in the Windtrace game. - `end_time` - This value is always the same as `start_time`. ## `SceneGalleryInfoNotify` - Starting Windtrace - `gallery_info` - SceneGalleryInfo data. - `end_time` - This value is always the same as `start_time`. - `start_time` - This value is always `2444` for Windtrace. - This value is `200` when displaying game end statistics. - `gallery_id` - This value is always the same as `gallery_id` from `GalleryStartNotify`. - `stage` - The current stage of the gallery. - This will be `GALLERY_STAGE_TYPE_START`. - `owner_uid` - The UID of the player who started the Windtrace game. - `hide_and_seek_info` - SceneGalleryHideAndSeekInfo - `visible_uid_list` - List of UIDs (ints) of the players who were left alive. - `caught_uid_list` - List of UIDs (ints) of the players who have been caught. - `player_count` - The amount of players in the Windtrace game. - `pre_start_end_time` - This value is always `0` for Windtrace. ## `HideAndSeekSettleNotify` - `reason` - The reason for the game ending. - `winner_list` - A list of UIDs (ints) of the players who won the game. - `settle_info_list` - HideAndSeekSettleInfo data. - This is a list of players who participated in the game. ## `HideAndSeekSettleInfo` - `card_list` - A collection of `ExhibitionDisplayInfo` - If unknown: hardcode the specified values. - These values are repeated during testing. - `uid` - The UID of the player who participated in the game. - `nickname` - The player's nickname. - `head_image` - This value is always `0`. - `online_id` - This value is always blank. - `profile_picture` - `ProfilePicture` object. - `play_index` - Value picked by the server. (use 1) - `stage_type` - The stage type. (inconclusive; TODO) - `cost_time` - The amount of time the player took to complete the game. - `score_list` - A list of player scores. ## `ExhibitionDisplayInfo` - `id` - The ID of the reward. - `param` - The amount of the reward given. - `detail_param` - This value is *mostly* 0. - This value **matches** param when the reward is of the amount of time spent playing. (participation reward) --- ### Overview (`src/handbook/data/README.md`) # Handbook Data Use Grasscutter's dumpers to generate the data to put here. # Generating Data When you have Grasscutter set up, you can use the following commands to generate the data: - Commands - `grasscutter.jar -dump=commands,en-us` - Items - `grasscutter.jar -dump=items,EN` - Avatars - `grasscutter.jar -dump=avatars,EN` - Quests - `grasscutter.jar -dump=quests,EN` - Entities - `grasscutter.jar -dump=entities,en-us` - Areas - `grasscutter.jar -dump=areas,EN` - Scenes - `grasscutter.jar -dump=scenes,en-us` Grasscutter being "set up" means: - A Java runtime is installed - Resources are provided in the working directory ## Language Locales You can replace `en-us` or `EN` using the language locale which matches the format. | Grasscutter Language Locale | Handbook Language Locale | |-----------------------------|--------------------------| | en-us | EN | ## Files Required - `mainquests.csv` - `commands.json` - `entities.csv` - `avatars.csv` - `scenes.csv` - `quests.csv` - `items.csv` # Item Icon Notes - Artifacts: `https://bbs.hoyolab.com/hoyowiki/picture/reliquary/(name)/(piece)_icon.png` - Alternate source: `https://api.ambr.top/assets/UI/reliquary/UI_RelicIcon_(set)_(piece).png` - `xxxx4` - `flower_of_life` - `xxxx5` - `sands_of_eon` - `xxxx3` - `circlet_of_logos`/`plume_of_death` - Use `circlet_of_logos` with a complete set - Use `plume_of_death` with part of a set. - `xxxx2` - `plume_of_death` - `xxxx1` - `goblet_of_eonothem` - Miscellaneous Items: `https://bbs.hoyolab.com/hoyowiki/picture/object/(name)_icon.png` - Includes: materials, quest items, food, etc. - Alternate source: `https://api.ambr.top/assets/UI/UI_ItemIcon_(id).png` - Avatars/Avatar Items: `https://bbs.hoyolab.com/hoyowiki/picture/character/(name)_icon.png` - Avatar Items are between ranges `1001` and `1099`. - Weapons: `https://api.ambr.top/assets/UI/UI_EquipIcon_(type)_(name).png` - Furniture: `https://api.ambr.top/assets/UI/furniture/UI_Homeworld_(location)_(name).png` - Monsters: `https://api.ambr.top/assets/UI/monster/UI_MonsterIcon_(type)_(variant).png` # Credits - [`...List.json` files](https://raw.githubusercontent.com/Dituon/grasscutter-command-helper/main/data/en-US) - Grasscutter Command Helper - [Internal Asset API](https://ambr.top) - Project Amber --- ### Overview (`src/main/java/emu/grasscutter/game/managers/stamina/README.md`) # Stamina Manager --- ## UpdateStamina ```java // will use consumption.consumptionType as reason public int updateStaminaRelative(GameSession session, Consumption consumption); ``` ```java public int updateStaminaAbsolute(GameSession session, String reason, int newStamina) ``` --- ## Pause and Resume ```java public void startSustainedStaminaHandler() ``` ```java public void stopSustainedStaminaHandler() ``` --- ## Stamina change listeners and intercepting ### BeforeUpdateStaminaListener ```java import emu.grasscutter.game.managers.StaminaManager.BeforeUpdateStaminaListener; // Listener sample: plugin disable CLIMB_JUMP stamina cost. private class MyClass implements BeforeUpdateStaminaListener { // Make your class implement the listener, and pass in your class as a listener. public MyClass() { getStaminaManager().registerBeforeUpdateStaminaListener("myClass", this); } @Override public boolean onBeforeUpdateStamina(String reason, int newStamina) { // do not intercept this update return false; } @Override public boolean onBeforeUpdateStamina(String reason, Consumption consumption) { // Try to intercept if this update is CLIMB_JUMP return consumption.consumptionType == ConsumptionType.CLIMB_JUMP; // If it is not CLIMB_JUMP, do not intercept. } } ``` ### AfterUpdateStaminaListener ```java import emu.grasscutter.game.managers.StaminaManager.AfterUpdateStaminaListener; // Listener sample: plugin listens for changes already made. private class MyClass implements AfterUpdateStaminaListener { // Make your class implement the listener, and pass in your class as a listener. public MyClass() { registerAfterUpdateStaminaListener("myClass", this); } @Override public void onAfterUpdateStamina(String reason, int newStamina) { // ... } } ``` --- ### README HE (`docs/README_HE.md`)

[EN](../README.md) | [简中](README_zh-CN.md) | [繁中](README_zh-TW.md) | [FR](README_fr-FR.md) | [ES](README_es-ES.md) | [HE](README_HE.md) | [RU](README_ru-RU.md) | [PL](README_pl-PL.md) | [ID](README_id-ID.md) | [KR](README_ko-KR.md) | [FIL/PH](README_fil-PH.md) | [NL](README_NL.md) | [JP](README_ja-JP.md) | [IT](README_it-IT.md) | [VI](README_vi-VN.md) | [हिंदी](README_hn-IN.md) **請注意:** 歡迎成為本專案的貢獻者。在提交 PR 之前, 請仔細閱讀[程式碼規範](https://github.com/Grasscutters/Grasscutter/blob/stable/CONTRIBUTING.md)。 ## 當前功能 * 登入 * 戰鬥 * 好友列表 * 傳送系統 * 祈願系統 * 從控制台生成魔物 * 多人遊戲 *部分* 可用 * 物品欄相關 (接收物品/角色, 升級角色/武器等) ## 快速設定指南 **注意:** 如需幫助請加入 [Discord](https://discord.gg/T5vZU6UyeG) ### 快速開始（全自動） - 下載 Java 17：https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html - 下載 [MongoDB 社區伺服器](https://www.mongodb.com/try/download/community) - 下載遊戲版本 REL3.7（如果你沒有的話，可以在[這裡](https://github.com/MAnggiarMustofa/GI-Download-Library/blob/main/GenshinImpact/Client/3.7.0.md)找到 3.7 客戶端） - 下載 [最新的 Cultivation 版本](https://github.com/Grasscutters/Cultivation/releases/latest)。使用 `.msi` 安裝程式。 - 以管理員身分打開 Cultivation，按右上角的下載按鈕。 - 點擊 `Download All-in-One` - 點擊右上角的齒輪 - 將遊戲安裝路徑設置為你的遊戲所在的位置。 - 將自定義 Java 路徑設置為 `C:\Program Files\Java\jdk-17\bin\java.exe` - 其他設置保持預設 - 點擊啟動旁邊的小按鈕。 - 點擊啟動按鈕。 - 用你想要的用戶名登錄，密碼無所謂。 ### 編譯 Grasscutter 使用 Gradle 來處理依賴及編譯。 **依賴:** - [Java SE Development Kits - 17](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) - [Git](https://git-scm.com/downloads) ##### Windows ```shell git clone https://github.com/Grasscutters/Grasscutter.git cd Grasscutter .\gradlew.bat # 建立開發環境 .\gradlew jar # 編譯 ``` ##### Linux ```bash git clone https://github.com/Grasscutters/Grasscutter.git cd Grasscutter chmod +x gradlew ./gradlew jar # 編譯 ``` 編譯後的 JAR 檔案存放在根目錄 ### 命令列表請到 [wiki](https://github.com/Grasscutters/Grasscutter/wiki/Commands) 查看 # 快速排除問題 * 如果編譯失敗, 請檢查 JDK 安裝是否正確 (要求 JDK 17 並確認 JDK 處於環境變數 `PATH` 中) * 客戶端無法登入/連線, 4206, 其他問題... - 大部分情況是因為代理設定本身就是*問題*。如果使用 Fiddler 請確認 Fiddler 監聽通訊埠不是 `8888` * 啟動順序: MongoDB > Grasscutter > 代理程式 (mitmdump, fiddler 等) > 客戶端 --- ### Quests Missing Scripts (`docs/quests/Missing-Scripts.md`) ## World Bosses * Oceanid_Boss_1_4 * V1_6/Oceanid_Boss_1_6 * DrakePrimoRockBoss * V2_3/Boss_Hound ## Dungeons * V2_1/Boss_Shougun_Beta * V2_1/Boss_LaSignora ## Activities/Events ### Aster (unreconciled stars) * AsterMiddle * AsterBig ### FleurFair (windblume) * FleurFair_Parachute * FleurFair_BalloonShoot ### NEW_ACTIVITY_DRAGONSPINE (The Chalk Prince and the Dragon) * IceFlowerBossBattle ### NEW_ACTIVITY_WINTER_CAMP (Shadows Amidst Snowstorms) * V2_3/WinterCampDevice * V2_3/WinterCampGacha * V2_3/WinterCampMimik * V2_3/WinterCampMimik_Watcher * V2_3/WinterCampMimik_Quest * V2_3/WinterCampParkour * V2_3/WinterCampSnowman ### NEW_ACTIVITY_TREASURE_MAP * TreasureMapEvent * V2_0/TreasureMapEventV2 ### unordered * Activity_ArenaChallengeSub * Activity_ArenaChallengeMain ## Scene1 * Fishing_EventTest * test_New_LuaCallType * V2_5/TEST_Require ## Scene 500030 * SGV_Test ## Other/Unordered * Activity_Endora * AttachChildChallenge * BlackBoxPlay/ChargingPort * BlackBoxPlay/DrawOneLine * BlackBoxPlay/DrawOneLinePlus * BlackBoxPlay/EnergyAmplifier * BlackBoxPlay/LightResonanceStone * BlackBoxPlay/LightSquare * BlackBoxPlay/LightSquareV2 * BlackBoxPlay/MagneticGear * BlackBoxPlay/TeleportHighway * BubbleGame * BulletGame * DragonSpineBlossomA * DragonSpineBlossomB * FlyChallenge * MonsterQuickDeath * SnowDungeon * TowerDefense_Challenge * TowerDefense_Gear * TowerDefense_Monster * TowerDefense_Monster02 * TowerDefense_Trap * WindFlora * WindFlora_Arenashake * WindFlora_Boss_RandomList * WindFlora_Laser * WindFlora_Main * WindFlora_RecordFloorBreakable * WindFlora_RecordFloorMemory * WindFlora_RecordFloorTransparent * WindFlora_ReTrans * V1_5/Challenge_SetEyePoint * V1_5/HideAndSeek_Gallery * V1_5/HideAndSeek_Skill * V1_5/HilichurlLevel * V1_6/TuneStone * V1_6/BoatRace * V1_6/General_Watcher * V1_6/KeleeBombBattle * V1_6/Multi_Badminton * V1_6/Optimization * V1_6/ScoreChallenge * V1_6/TuneStone * V1_6/VehicleBattle * V2_0/BlitzRush_Watcher * V2_0/BlossomGroup * V2_0/DrawOneLine_TreasureMap * V2_0/ElectricCore * V2_0/ElectricCore02 * V2_0/ElementFloor * V2_0/ExhibitionRoleElectricBomb * V2_0/ExhibitionRoleElectricPowerSource * V2_0/OreBlossomGroup * V2_0/PhotoTakenSuccessfully * V2_0/RaioCotter * V2_0/SetPerformanceOptimizationWithRegion_V2.0 * V2_0/SetPerformanceOptimizationWithRegion_V3.0 * V2_0/SetPerformanceOptimizationWithRegion_Event_V2.0 * V2_0/TemariChallenge * V2_0/TemariChallengePreQuest * V2_0/ThunderFloor * V2_0/TowerDefense_Challenge_V2.0 * V2_0/TowerDefense_Gear_V2.0 * V2_0/TowerDefense_Monster_V2.0 * V2_0/TowerDefense_MonsterWaveConfig_V2.0 * V2_1/Boss_Raijin * V2_1/FightingStage * V2_1/FishingChallenge * V2_1/FishingChallenge_Moonfin * V2_1/ImmortalPot * V2_1/ImmortalPotEx * V2_1/Monster_Tide_Test * V2_1/MoonlitCamp * V2_1/PirateHelm * V2_1/PirateShoji * V2_1/Wakura * V2_1/WoodFloorPlayOrder * V2_1/WoodFloorPlaySame * V2_1/SeaGodStatue * V2_2/Ayesha * V2_2/Circuit * V2_2/DayFinishSuite * V2_2/DecalDecode * V2_2/Dig * V2_2/PillarMove * V2_2/SelfLoopSeeli * V2_2/ShowDecals * V2_2/RogueDungeon_BOSS * V2_2/RogueDungeon_ChestRoom * V2_2/RoqueDungeon_FirstRoom * V2_2/RogueDungeon_Main * V2_2/RogueDungeon_Require * V2_2/TsurumiBirdFather * V2_2/TsurumiStoneSeq * V2_2/TsurumiTorch * V2_3/EnergyDisk * V2_3/EnergyDisk_Dungeon * V2_3/HachiBattle * V2_3/HachiDungeon * V2_3/HachiSneak * V2_3/MistTrialV2 * V2_3/MistTrialV2_BuffLog * V2_4/BoxPusher * V2_4/DeepSeaDrakeBoss * V2_4/EnvStateManage * V2_4/EnvState * V2_4/EnvStateControl * V2_4/EnvStateWorktop * V2_4/Firecracker * V2_4/HideAndSeek_Gallery_V2 * V2_4/HideAndSeek_Skill_V2" * V2_4/MiniOsial * V2_4/Monster_CombatEnd_Handle * V2_4/PotionStage * V2_4/QunyugeDebris * V2_4/QunyugeDebris_Stop_Balloon * V2_4/SeaLamp_Challenge_Manager * V2_4/SealedAltar * V2_4/WallMaze * V2_5/DarkPressure * V2_5/DarkStair * V2_5/FightingStage_ByNum * V2_5/FightingStage_ByTime * V2_5/GiliGiliI_Boss * V2_5/GiliGiliI_Quest * V2_5/HM_BalloonGallery * V2_5/Huarongdao * V2_5/RecircleChallenge * V2_5/ReviveBoss * V2_5/ReviveCrystalEnergy * V2_5/UGCDungeon_Reforge * V2_5/UGCDungeon * V2_5/Watcher_Energy * V2_5/Watcher_Puzzle * V2_5/Watcher_Tower * V2_6/BW_LightRoadTrack * V2_6/BW_RandomLoadSuite * V2_6/CalculateBulletForward * V2_6/CrystalLink * V2_6/CYJY_Enter_Trans_Player * V2_6/DigPlay * V2_6/DropRockAbyssBulletTrigger * V2_6/HM_WoodenStakeChallenge * V2_6/IrodoriMaster * V2_6/PhotographActivity * V2_6/TowerDefense_Challenge_V3.0 * V2_6/TowerDefense_Gear_V3.0 * V2_6/TowerDefense_Monster_V3.0 * V2_6/TowerDefense_MonsterWaveConfig_V3.0" * V2_6/TowerDefense_SpecialGears_V3.0 * V2_7/rogue_rotate_whitebox * V2_7/Activity_GachaSync * V2_7/Activity_LumenArena * V2_7/Activity_LumenProtect * V2_7/Activity_LumenCharge * V2_7/Activity_LumenWipeout * V2_7/BW_NearBossAuthorityChange * V2_7/HM_FindTubby * V2_7/Rogue_Cell * V2_7/rogue_rotate_whitebox * V2_7/Rogue_Terrain_1 * V2_7/Rogue_Terrain_2 * V2_7/Rogue_Terrain_3 * V2_7/YeLan_BoxPusher * TD_Lib --- ### Resources World Locations (`docs/resources/World Locations.txt`) Excels: - WorldAreaConfigData.json - scene3_point.json (BinOutput/Scene/Trans) textmaps contain the names of the areas if a world area has an 'AreaType' of 'LEVEL_1', it has the following properties: - there is not an 'AreaID2' field - there is an 'elementType' field - this is a PRIMARY region if a world area has an 'AreaType' of 'LEVEL_2', it has the following properties: - there is not an 'elementType' field - the 'AreaID1' field is inherited from its parent area - this is a SECONDARY region the textmap hash is of the secondary region's name, unless it's a primary region --- ### Quests Lines The Outlander Who Caught The Wind (Prologue Act 1) (`docs/quests/lines/The-Outlander-Who-Caught-the-Wind-(Prologue-Act-1).md`) # The Outlander Who Caught the Wind (Prologue Act 1) To start/enable quests run `/quests enable` or activate questing in the server settings. ## Reading The Table * ✔️ Natural Progression _possible_; works as intended * ⚠️ Natural Progression _possible_; bugs occur, see note * ❌ Natural Progression _not possible_; see note(s) * ❓ Unknown Behavior * bw = 'big-world scripts' enabled * m = Main Quest | [The Outlander Who Caught the Wind (Prologue Act 1)](https://genshin-impact.fandom.com/wiki/The_Outlander_Who_Caught_the_Wind) | Works (bw-on) | Works (bw-off) | Log in/out Works | Problems/Notes | |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|----------------|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------| | **m351 : Wanderer's Trail**
[500 CExp, 225 AExp, 975 Mora] | ✔️ | ⚠️ | ✔️ | completion possible without commands | | 35104 : Traveler and Paimon Intro Cutscene | ✔️ | ✔️ | ✔️ | | 35100 : Go to Paimon | ✔️ | ❓ | ✔️ | | 35107 : #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | 35101 : Follow Paimon | ✔️ | ❓ | ✔️ | | 35106 : Unlock the Teleport Waypoint | ✔️ | ✔️ | ✔️ | | 35105 : Go to the foot of the cliff | ✔️ | ❓ | ✔️ | If not relogging, Paimon will now be with you and move with you. | | 35103 : [N/A] 469284815 #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | 35102 : Climb to the top of the rock face | ✔️ | ❓ | ✔️ | Quest 35200 was automatically added to the In Progress list. | | | | | | | | **m352 : Bird's Eye View**
(Teyvat Archon Quest Prologue: Act 1 - 1)
[500 CExp, 225 AExp, 975 Mora] | ✔️ | ❓ | ✔️ | completion possible without commands | | 35200 : Follow the path | ✔️ | ❓ | ✔️ | No new quest marker is automatically added. Opening the quest journal and selecting navigate will added it to the screen in the correct location. | | 35201 : Go to Paimon | ✔️ | ❓ | ✔️ | Paimon will stay with the player. | | 35202 : Talk to Paimon | ✔️ | ❓ | ✔️ | | 35203 : Follow Paimon | ✔️ | ❓ | ✔️ | After logout it resets the user to 35202 | | 35204 : Swim to the island in Starfell Lake | ✔️ | ❓ | ✔️ | | 35205 : Bird's Eye View - Statue of The Seven (I) unlocked | ✔️ | ❓ | ✔️ | TODO check logout | | | | | | | | **m353 : Unexpected Power**
(Teyvat Archon Quest Prologue: Act 1 - 2)
[20 Primo, 575 CExp, 250 AExp, 1100 Mora, 10 Sweet Madame, 10 Teyvat Fried Egg] | ✔️ | ❓ | ✔️ | completion possible without commands, but slime multiply every time you log out and back in [#20](https://github.com/Hartie95/Grasscutter/issues/20) | | 35301 : Unexpected Power - Talk to Paimon | ✔️ | ❓ | ✔️ | | 35312 : Unexpected Power - Exit area rollback failed | ✔️ | ❓ | ✔️ | Player exits area before triggering 35301, you can call add 35312 which will trigger cutscene, but you will have a UI bug | | 35302 : Unexpected Power - Unleash Your Elemental Skill | ✔️ | ❓ | ✔️ | | 35309 : Unexpected Power - Defeat the slimes | ✔️ | ❓ | ✔️ | | 35303 : Unexpected Power - Hold Elemental Skill | ✔️ | ❓ | ✔️ | holding progressbar is missing | | 35310 : Unexpected Power - Defeat the slimes | ✔️ | ❓ | ✔️ | | 35304 : Unexpected Power - Use Elemental Burst | ✔️ | ❓ | ✔️ | | 35311 : Unexpected Power - Defeat the slimes | ✔️ | ❓ | ✔️ | | | | | | | | **m355 : Forest Rendezvous**
(Teyvat Archon Quest Prologue: Act 1 - 3)
[575 CExp, 250 AExp, 1100 Mora] | ✔️ | ❓ | ✔️ | natural progression possible | | 35501 : Go to Mondstadt | ✔️ | ❓ | ✔️ | Wait until Dvalin flies over. | | 36100 : #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | Cutscene trigger for dvalin flying over the players head | | 36101 : #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | 35502 : Advance to the heart of the forest | ✔️ | ❓ | ✔️ | | 35503 : Talk to Paimon | ✔️ | ❓ | ✔️ | | 35504 : Investigate what Paimon has found | ✔️ | ❓ | ✔️ | | 35505 : Talk to Paimon | ✔️ | ❓ | ✔️ | | | | | | | | **m354 : Wind-Riding Knight**
(Teyvat Archon Quest Prologue: Act 1 - 4)
[625 CExp, 275AExp, 1200 Mora] | ✔️ | ❓ | ✔️ | | | 35401 : Keep heading towards Mondstadt | ✔️ | ❓ | ✔️ | | 35402 : Talk to the perky girl | ✔️ | ❓ | ✔️ | | | 35404 : Use Amber to defeat the airborne slimes | ✔️ | ❓ | ✔️ | | 35405 : #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | wait until the talk is finished | | 35403 : Go to the location designated by Amber | ✔️ | ❓ | ✔️ | | | | | | | | | **m360 : Going Upon the Breeze**
(Teyvat Archon Quest Prologue: Act 1 - 5)
[20 Primo, 972 CExp, 275 AExp, 1800 Mora, 8 EnOre, 1 Recurve Bow] | ✔️ | ❓ | ⚠️ | completion possible without commands, but with some smaller bugs | | 36001 : Defeat the nearby hilichurls | ✔️ | ❓ | ⚠️ | goal location might be wrong after logout. Monsters might multiply after logout | | 36003 : Clear out the nearby hilichurl camp | ✔️ | ❌ | ✔️ | There are more hillichurls then there should be. If bw script are disabled, changing the chest to open will break the script and hinder progress | | 36004 : Talk to Amber | ✔️ | ❓ | ✔️ | | | 36005 : Keep heading towards Mondstadt | ✔️ | ❓ | ✔️ | | | | | | | | | **m356 : City of Freedom**
(Teyvat Archon Quest Prologue: Act 1 - 6)
[850 CExp, 250 AExp, 1625 Mora, 7 EnOre] | ⚠️ | ❓ | ⚠️ | completion possible, but with some smaller bugs | | 35601 : Talk to Amber | ✔️ | ❓ | ✔️ | | | 35602 : [CHS] - (test)跟随安柏#QUEST_HIDDEN | ⚠️ | ❓ | ⚠️ | softlock during showing of tipps possible | | 35603 : Go to the location designated by Amber | ✔️ | ❓ | ✔️ | | | 35604 : Talk to Amber | ✔️ | ❓ | ✔️ | | | 35605 : [CHS] - (test)开始飞行教学#QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | | 35606 : Meet Amber at the fountain plaza | ✔️ | ❓ | ✔️ | | | | | | | | | **m357 : Dragon Storm**
(Teyvat Archon Quest Prologue: Act 1 - 7)
[20 Primo, 1250 CExp, 275 AExp, 2400 Mora, 2 FineEnOre] | ✔️ | ❓ | ✔️ | completion possible with smaller bugs | | 35721 : Dvalin's Assault #QUEST_HIDDEN | ✔️ | ❓ | ✔️ | Watch the cutscene and then wait to be airborne | | 35722 : Fend off Stormterror | ⚠️ | ❓ | ✔️ | Using the movement keys (W,A,S,D) in the Dvalin fight might kick you out of the instance. **INVESTIGATE FURTHER** | | 35725 : [CHS] - (test)地城内cs#QUEST_HIDDEN | ✔️ | ❓ | ✔️ | You will return to the main world | | 35723 : Talk to Amber | ⚠️ | ❓ | ✔️ | Weather is not stormy. Finish conversation with Amber and Kaeya, the go the KoF Headquarters | | 35724 : Go to the Knights of Favonius Headquarters | ✔️ | ❓ | ✔️ | | | | | | | | | **m358 : Knights of Favonius**
(Teyvat Archon Quest Prologue: Act 1 - 8)
[1025 CExp, 225 AExp, 1950 Mora, 43 EnOre] | ✔️ | ❓ | ✔️ | completion possible | | 35800 : #QUEST_HIDDEN | ⚠️ | ❓ | ✔️ | wait two day via time forward to progress | | 35801 : Enter the Knights of Favonius Headquarters | ✔️ | ❓ | ✔️ | | | 35802 : Knights of Favonius - Talk to Jean | ✔️ | ❓ | ✔️ | | | | | | | | | **m306 : Winds of the Past**
(Teyvat Archon Quest Prologue: Act 1 - 9.1)
[20 Primo, 1550 CExp, 275 AExp, 3000 Mora, 3 FineEnOre] | ✔️ | ❓ | ✔️ | completion possible with two commands | | 30600 : Meet Amber at the temple | ✔️ | ❓ | ✔️ | | | 30601 : Talk to Amber | ✔️ | ❓ | ✔️ | | | 30602 : Enter the temple | ✔️ | ❓ | ✔️ | Use /dungeon 1001 to go inside the dungeon | | 30607 : [CHS] - (test)到教学点1#QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | | 30608 : [CHS] - (test)到教学点2#QUEST_HIDDEN (Tutorial on how to aim and fire using Amber) | ✔️ | ❓ | ✔️ | | | 30609 : [CHS] - (test)到教学点3#QUEST_HIDDEN | ✔️ | ❓ | ✔️ | | | 30612 : [CHS] - (test)到垂直风场#QUEST_HIDDEN (Tutorial on how to burn stuff with Pyro) | ✔️ | ❓ | ✔️ | | | 30611 : [CHS] - (test)地城失败#QUEST_HIDDEN (Seems to be in case the dungeon is failed) | ✔️ | ❓ | ✔️ | Walk forward and detroy the Dragon's Breath | | 30603 : Explore the temple's depths | ✔️ | ❓ | ✔️ | | | 30610 : Winds of the Past - Talk to Amber | ✔️ | ❓ | ✔️ | | | 30604 : Winds of the Past - Leave Domain (Will not show on HUD) | ✔️ | ❓ | ✔️ | | | | | | | | | **m307 : Crash Course**
(Teyvat Archon Quest Prologue: Act 1 - 9.2)
[20 Primo, 1550 CExp, 275 AExp, 3000 Mora, 3 FineEnOre, 1 Traveler's Handy Sword, Kaeya lv1 c0] | ✔️ | ⚠️ | ✔️ | completion possible with smaller bugs | | 30700 : Meet Kaeya at the temple | ✔️ | ❓ | ✔️ | | | 30701 : Talk to Kaeya | ✔️ | ❓ | ✔️ | | | 30702 : Enter the temple | ✔️ | ⚠️ | ✔️ | | | 30710 : Talk to Kaeya | ✔️ | ✔️ | ✔️ | | | 30707 : [CHS] - (test)到教学点1#QUEST_HIDDEN | ✔️ | ✔️ | ✔️ | | | 30708 : [CHS] - (test)到教学点2#QUEST_HIDDEN (Cryo freezing tutorial) | ✔️ | ✔️ | ✔️ | Freezing is not working, dashing though the fire works though | | 30712 : [CHS] - (test)到教学点4#QUEST_HIDDEN (Hydro Amber tutorial) | ✔️ | ✔️ | ✔️ | | | 30711 : [CHS] - (test)地城失败#QUEST_HIDDEN (fail dungeon fallback) | ✔️ | ✔️ | ✔️ | | | 30709 : [CHS] - (test)到教学点3#QUEST_HIDDEN | ✔️ | ✔️ | ✔️ | | 30702 | Spikes are broken and will make the player stuck, afterwards only tp or leaving the dungeon helps.
finish via one of those solutions:
Move forward with `/teleport 440 -25 198`
Get early Kaeya with `/give 10000015 lv1 c0`
Jump over the spikes with other means. | | 30703 : Explore the temple's depths | ✔️ | ✔️ | ✔️ | destroy the Dragons Breath | | 30715 : Talk to Kaeya | ✔️ | ✔️ | ✔️ | | | 30713 : Kaeya cutscene | ✔️ | ✔️ | ✔️ | | | 30704 : Leave Domain | ✔️ | ✔️ | ✔️ | | | | | | | | | **m308 : Sparks Amongst the Pages**
(Teyvat Archon Quest Prologue: Act 1 - 9.3)
[20 Primo, 1550 CExp, 275 AExp, 3000 Mora, 3 FineEnOre, 1 Otherworldly Story, Lisa lv1 c0] | ✔️ | ⚠️ | ✔️ | completion possible with a few commands | | 30800 : Meet Lisa at the temple | ✔️ | ❓ | ✔️ | | | 30801 : Talk to Lisa | ✔️ | ❓ | ✔️ | | | 30802 : Enter the temple | ✔️ | ❌ | ✔️ | | | 30810 : Talk to Lisa | ✔️ | ✔️ | ✔️ | | | 30807 : [CHS] - (test)到教学点1#QUEST_HIDDEN | ✔️ | ✔️ | ✔️ | | | 30812 : [CHS] - (test)到教学点#QUEST_HIDDEN | ✔️ | ⚠️ | ✔️ | | | 30809 : [CHS] - (test)到教学点3#QUEST_HIDDEN | ✔️ | ✔️ | ✔️ | | | 30808 : [CHS] - (test)到教学点2#QUEST_HIDDEN | ✔️ | ✔️ | ✔️ | | | | 30811 : [CHS] - (test)地城失败#QUEST_HIDDEN (fail dungeon fallback) | ✔️ | ✔️ | ✔️ | | | 30803 : Explore the temple's depths | ✔️ | ✔️ | ✔️ | | | 30814 : Talk to Lisa | ✔️ | ✔️ | ✔️ | | | 30804 : Leave Domain | ✔️ | ✔️ | ✔️ | no autoprogression | | --- --- METRICS --- - Files Extracted: 23 - Estimated Token Budget: ~35161 tokens - Canonical Reference: https://codewiki.google/github.com/Grasscutters/Grasscutter