Skip to content

pmagixc/LunaGC

Repository files navigation

LunaGC-6.0.0 WIP

STATUS: Since 6.2 has started, I no longer have 6.1 client meaning I cannot test whatever I change and cannot fix stuff (and this applies to 6.0 too obviously) for example fishing which is just extremely and unnecessarily hard to fix without a packet log of said version (6.0/1). If there's anyone that is willing to put up with my testing requests, I will attempt to fix said issues, so let me know either through an issue/discord if you have my username.

ABOUT 6.2 (and beyond): I will not continue to update this ps to upcoming versions due to lack of motivation, time and other reasons, unless heavily and I mean heavily requested, I will attempt to make a minimal 6.2 ps but I don't think anyone would want to use it.

Notice: Development halted in favor of the upcoming release (6.1 [ Check the 6.1.0 branch ] )

Updated version of Grasscutters, with some new features implemented.

Old Discord for LunaGC https://discord.gg/7D5gkyJR5Y (don't ask for support there, instead create an issue in this repository)

Features and functionality of the ps is not guaranteed, try it yourself to see what works and what doesnt. This is possibly the only public PS with updated mob and gadget spawns! (Up to Version 5.4)

Contribute if you want/can...

Outstanding bug(s) hall of fame:

  • Abyss (as expected) - wrong floor and chamber numbers being displayed (for example floor 0 chamber 1000) and buffs don't apply/change

Outstanding critical stuff that does not work hall of fame:

  • Lauma and Flins (bad res)

Read the handbook!

Setup Guide

  • Read it below, its just enough to get the server up and running along with the client.

Main Requirements

  • Get Java 17
  • Get MongoDB Community Server
  • Get NodeJS (For handbook generation)
  • Get game version REL6.0.0 (pray you still have it)
  • Make sure to install java and set the environment variables.
  • Build the server (refer to "Compile the actual server" in this guide.)
  • Download the Resources, 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)
  • Patch the game
  • Start the server and the game, make sure to also create an account in the LunaGC console!
  • Have fun (or don't)

Patching the game

  • Put Astrolabe.dll in the game directory
  • To "disable" the patch, just rename Astrolabe.dll to something else so it's not a DLL or don't name it Astrolabe (for example Astrolabe.deleleu / astrollable.dll)

Getting started

  • Clone the repository (install Git first )

    git clone https://github.com/pmagixc/LunaGC.git -b 6.0.0
    
  • Now you can continue with the steps below.

Compile the actual Server

Requirements:

Java Development Kit 17 | JDK or higher

  • Sidenote: Handbook generation may fail on some systems. To disable handbook generation, append -PskipHandbook=1 to the gradlew jar command.

  • For Windows:

    .\gradlew.bat
    .\gradlew.bat jar
  • For Linux:

    chmod +x gradlew
    ./gradlew
    ./gradlew jar

You can find the output JAR in the project root folder.

Manually compile the handbook

./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.)

Credit

proto Repository hk4e-protos

patch Repository hk4e-patch-universal (and credit to Hartie95 for fixing it)