base on Grassutter 4.6.0 Update # LunaGC-4.6.0 My Discord https://discord.gg/8vSyTHVphj Please contribute actively to this repository # Setup Guide This guide is very minimal and contains steps to just get your server and client up and running. Connecting to the server won't require Fiddler. However, if you need a more detailed guide and help with the server please refer to GrassCutter's official repository and discord server. ## Read the handbook (found at the end of the file) ## Main Requirements - 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.6.0 (If you don't have a 4.6.0 client, you can find it here along with the audio files) : | Download link | Package size | MD5 checksum | | :---: | :---: | :---: | | [GenshinImpact_4.6.0.zip.001](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.001) | 10.0 GB | 03ce6a5d4b7d8ba192cc6d9133a00bef | | [GenshinImpact_4.6.0.zip.002](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.002) | 10.0 GB | a0320432c00779630df4a421ac7f3999 | | [GenshinImpact_4.6.0.zip.003](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.003) | 10.0 GB | 335a750e6576205970a0bb49fbb2ce72 | | [GenshinImpact_4.6.0.zip.004](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.004) | 10.0 GB | 2210fca193fc5261c5ae75841ce17002 | | [GenshinImpact_4.6.0.zip.005](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.005) | 10.0 GB | f96757dbce7764e65150449f4a476b3e | | [GenshinImpact_4.6.0.zip.006](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/GenshinImpact_4.6.0.zip.006) | 5.67 GB | 6b43dac3616027ce7a980c41092f72fa | | [Audio_Chinese_4.6.0.zip](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/Audio_Chinese_4.6.0.zip) | 14.0 GB | 974bc5df3f7d96de01b68f1aab0371e5 | | [Audio_English(US)_4.6.0.zip](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/Audio_English(US)_4.6.0.zip) | 16.4 GB | f577ea4624981b36789e24913d0f3745 | | [Audio_Japanese_4.6.0.zip](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/Audio_Japanese_4.6.0.zip) | 18.4 GB | f039da619e670259d7e57c4f5e84be9e | | [Audio_Korean_4.6.0.zip](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20240412191920_HThGUGlY3Gjy6AXP/Audio_Korean_4.6.0.zip) | 13.8 GB | 58c3fc8782f3d59b324dfd603fa93e6d | - Make sure to install java and set the environment variables. - Build the server (refer to "Compile the actual server" in this guide.) - Get the version.dll file from the Rsa_Patch folder and put it into the game root directory. - Download the older version of [mihoyonet.dll](https://autopatchhk.yuanshen.com/client_app/download/pc_zip/20231030132335_iOEfPMcbrXpiA8Ca/ScatteredFiles/GenshinImpact_Data/Plugins/mihoyonet.dll) (4.2.0) and replace `GenshinImpact_Data/Plugins/mihoyonet.dll` - Download the [Resources](https://github.com/Kei-Luna/LunaGC_Resources_4.6.0), make a new folder called `resources` in the downloaded LunaGC folder and then extract the resources in that new folder. - Set useEncryption, Questing and useInRouting to false (it should be false by default, if not then change it) - Start the server and the game, make sure to also create an account in the LunaGC console! - Have fun ## Important! - If you use cultivation and you know what you are doing please disable the automatically patch RSA option in settings! (I recommend to use NotThorny's Cultivation modification if you really want to use Cultivation) Cultivation will automatically patch the game either with a 4.0 or 4.5 patch which is not good because LunaGC is 4.6. So, uncheck automatically patch RSA in settings and then place the rsa patch dll again in the game folder if Cultivation has gotten rid of it. ### Compile the actual Server **Sidenote**: Make sure to append the right prefix and suffix based on your operating system (./ for linux | .\ for windows | add .bat for windows systems when compiling server JAR/handbook). **Requirements**: [Java Development Kit 17 | JDK](https://oracle.com/java/technologies/javase/jdk17-archive-downloads.html) or higher - **Sidenote**: Handbook generation may fail on some systems. To disable handbook generation, append `-PskipHandbook=1` to the `gradlew jar` command. - **For Windows**: ```shell .\gradlew.bat .\gradlew.bat jar ``` *If you are wondering, the first command is to set up the environment while the 2nd one is for building the server JAR file.* - **For Linux**: ```bash chmod +x gradlew ./gradlew jar ``` *If you are wondering, the first command is to make the file executeable and for the rest refer to the windows explanation.* ### You can find the output JAR in the project root folder. ### Manually compile the handbook ```shell ./gradlew generateHandbook ``` ## Troubleshooting - Make sure to set useEncryption and useInRouting both to false otherwise you might encounter errors. - To use windy make sure that you put your luac files in C:\Windy (make the folder if it doesnt exist) - If you get an error related to MongoDB connection timeout, check if the mongodb service is running. On windows: Press windows key and r then type `services.msc`, look for mongodb server and if it's not started then start it by right clicking on it and start. On linux, you can do `systemctl status mongod` to see if it's running, if it isn't then type `systemctl start mongod`. However, if you get error 14 on linux change the owner of the mongodb folder and the .sock file (`sudo chown -R mongodb:mongodb /var/lib/mongodb` and `sudo chown mongodb:mongodb /tmp/mongodb-27017.sock` then try to start the service again.) ## How to make or get custom banners? - Well, you can get pre-made ones from this [github repo](https://github.com/Zhaokugua/Grasscutter_Banners) - Rename the file you chose to download to Banners.json and replace it with the already-existing one in the data folder. - The repo also offers a file which contains all of the banners, to use it follow the same procedure mentioned above. ### Making custom banners - If you want to make a custom banner for a character or weapon, you'll need to know the prefabPath, the titlePath and the character/item IDs. - Fun fact: You can set any item to be on the rateUp, even if it's a 4* instead of a 5*. ## Handmade Handbook (tested) - Create accounts: /account <username> - Get all achievements: /am grantall - God mode: /prop god 1 - Enter a domain: /dungeon <ID> - Unlimited stamina: /prop ns 0 - Unlimited energy: /prop UnlimitedEnergy 1 - Recharge energy: /er - Set constellation for selected character: /setConst <number 1 to 6> - Get rid of the skill cooldown: /stat cdr 99 - Change weather: /weather <sunny/rain/cloudy/thunderstorm/snow/mist> - Change talent for selected character: /talent <n/e/q/all> <level> (n - normal attack only) (e - skill only) (q - burst only) - Give items: /g <itemId|avatarId|all|weapons|mats|avatars> [lv<number>] [r<refinement number>] [x<amount>] [c<constellation number>] [sl<skilllevel>] - Unlock all: /unlockall - Change world level: /prop wl <number> - Change AR: /prop player_level <number between 1 and 60> - Change the game speed: /gamespeed <0.1|0.2|0.5|0.75|1.0|1.5|2.0|3.0> - Get 9999 Intertwined fates: /g 223 x9999 - Get 9999 Acquaint fates: /g 224 x9999 - Get 9999 Mora: /g 202 x9999 - Get 9999 Primogems: /g 201 x9999 ### Make sure to not include <> or [] in the commands! The stuff in <> means its required and the stuff in [] means its not required. ### How to get all of the stuff maxed out: /g all lv90 r5 c6 c6 sl10 | Then do a separate one for the materials: /g mats x99999 ### Ways to TP around the map: Method 1: - 1: Unlock the map: /prop um 1 - 2: Open the map - 3: Use the waypoints Method 2: - 1: Open the map - 2: Place a fishing rod marker (the last one) where you want to teleport and mark it. ### How to get avatar/entity/material etc. IDs? - Go to [ambr.top](https://ambr.top) - Search up the material/avatar/enemy and then the ID of it should be in the URL of the site, for example I searched for the pyro hilichurl archer; the link for it is ambr.top/en/archive/monster/21010501/pyro-hilichurl-shooter so the ID for it will be 21010501. ### How to spawn monsters? - Get the ID from the ambr.top link (above) - Do /spawn <id> in the in-game chat. You can also find out more arguments that you can use to modify the monster hp etc by doing `/help spawn` or `/spawn` | Example: `/spawn 21010501`, that will spawn a pyro hilichurl. Give it more hp: `/spawn 21010501 hp9999` and you can find more about the arguments trough the method I mentioned above. ### How to use the brand new /uid command? - Rich text is supported - How to set custom UID: `/uid set changethistext` | bold: `/uid set <b>changethistext</b>` | italic: `/uid set <i>changethistext</i>` | combined: `/uid set <i><b>changethistext</b></i>` | colored text (you'll need a hex color code, you can easy get and pick one by search hex color picker on google now let's assume that you have done it): `/uid set <color=#698ae8>changethistext</color>` - You can also include spaces like this: `/uid set <b>B O L D</b>` - You can combine the bold, italic and colored text - Restore to server-default UID: `/uid default` ## What doesn't work - All of the quests - Serenitea pot - Abyss - Mail - Battlepass - Events - Claiming AR/Commission rewards - Claiming bosses drops - City reputation - Character ascension - Gadgets - Forging - Some inventory stuff - Weapon refinement - Registration in-game using the box when logging in for first time (use console to make account instead) ### Even more ", Assign "at most 3 tags" to the expected json: {"id":"10396","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"