diff --git a/README.md b/README.md index 0ed1ccc3886..041d30979b5 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ We will set up the following: - Client - the client is the application used to _play the game_, i.e. MapleStory.exe. ### 1 - Database -You will start by installing the database server and client, and then run some scripts to prepare it for the server. +You will start by installing the database server and database client, and then run some scripts to prepare it for the server. #### Steps @@ -100,27 +100,12 @@ To run the jar, a ``launch.bat`` file is provided for convenience. Simply double Alternatively, run the jar file from the terminal. Just remember to provide the `wz-path` system property pointing to your wz directory. ### 3 - Client -You will start by installing the game with the old installer, then overwrite some WZ files with our custom ones, and lastly get the localhost executable in place. +The client files are located in a separate repository: https://github.com/P0nk/Cosmic-client -#### Steps - -1. Download _MapleGlobal-v83-setup.exe_ from my [Google Drive](https://drive.google.com/drive/folders/1hgnb92MGL6xqEp9szEMBh0K9pSJcJ6IT). This is the official installer from back then. -2. Install it in a directory of your choice. -3. Delete the following files from the installation directory: _HShield_ (entire directory), _ASPLnchr.exe_, _MapleStory.exe_, and _Patcher.exe_. -4. Download _CosmicWZ-2024-07-17-v0.14.0.zip_ from my [Google Drive](https://drive.google.com/drive/folders/1hgnb92MGL6xqEp9szEMBh0K9pSJcJ6IT). -5. Unzip it and copy all .wz-files into the installation directory. Replace the existing ones. -6. Download _HeavenMS-localhost-WINDOW.exe_ from [hostr.co](https://hostr.co/amuX5SLeeVZx). This is a client modified to connect to your localhost instead of Nexon's server (along with some fixes and custom changes). - - Your antivirus will likely detect the file as a trojan or similar and automatically delete it. To prevent this from happening, add your _Downloads_ directory and the installation directory as exclusions in your antivirus software. On W11, this is under "Virus & threat protection settings" -> "Add or remove exclusions". -7. Move _HeavenMS-localhost-WINDOW.exe_ into the installation directory. -8. Done! Double-click the exe and the game should start. - - The client may be a bit fiddly. Sometimes it won't start, but if you see "Client connected" in the server console it's a good indication. Try spam-clicking it like 10+ times, that usually works for me. - -**Important note about localhost clients**: these executables are red-flagged by antivirus tools as potentially malicious software. -This happens due to the reverse engineering methods that were applied onto these software artifacts. -The one provided here has been in use for years already and posed no harm so far, so it is assumed to be safe. +Follow the installation guide in the README. ### 4 - Getting into the game -The client has started, and you're looking at the login screen. +You have successfully started the client, and you're looking at the login screen. #### Logging in At this point, you can log in to the admin account using the following credentials: @@ -129,7 +114,7 @@ At this point, you can log in to the admin account using the following credentia * Pin: "0000" * Pic: "000000" -Or create a regular account by typing in your desired username & password and attempting to log in. This "automatic registration" feature lets you create new accounts to play around with. It is enabled by default (see _config.yaml_). +You can also create a new regular account by typing in your desired username & password and attempting to log in. This "automatic registration" feature lets you create new accounts to play around with. It is enabled by default (see _config.yaml_). #### Entering the game Create a new character as you normally would, and then select it to enter the game. Hooray, finally we're in! @@ -144,21 +129,14 @@ That's it, have fun playing around in game! Some slightly more advanced concepts that might be useful once you're up and running. ### Host on remote server -You don't have to host the server on your local machine to play. It's possible to host on a remote server such as a VPS or even a dedicated server. - -I leave it to you to figure out the server hosting part, but once you have that running you'll need to edit the client exe to point to your remote server ip. +You don't have to host the server on your local machine to play. It's possible to host on a remote server such as a VPS or a dedicated server. -#### Edit client ip -1. Download and install a hex editor: [HxD](https://mh-nexus.de/en/hxd/) -2. Start HxD and open your client exe (I recommend making a copy of it first). At this point you should see a bunch of hex codes and a "Decoded text" column to the right of it. -3. Ctrl+f and search for Text-string "127.0.0.1". You should find three occurrences right above each other. -4. Place your cursor before the first "127" and start typing the desired ip, overwriting what is already there. Do the same on the other two and click on Save. -5. Done! Now the client will attempt to connect to that ip address instead when you launch it. +I leave it to you to figure out the server hosting part, but once you have that running you'll need to edit the client ip to point to your remote server ip. ### WZ files -WZ files are the asset/data files required by the client and server. Typically, [HaRepacker-resurrected](https://github.com/lastbattle/Harepacker-resurrected) is used to handle (view, edit, export) the .wz files. +WZ files are the asset/data files required by the client and server. Typically, the [HaRepacker-resurrected](https://github.com/lastbattle/Harepacker-resurrected) tool is used to manage (view, edit, export) the .wz files. -The client can read the .wz files directly, but the server requires them in XML format. The server also does not make use of the sprites, which is the motivation for different kinds of exporting. +The client can read the .wz files directly, but the server requires them to be in XML format. The server does not make use of the sprites, which is the motivation for different kinds of exporting. HaRepacker allows you to export to "Private server", which is the .img files packaged in the .wz stripped of sprites and converted to XML. This takes much less disk space. This server requires custom .wz files (unfortunately), as you may have noted during installation of the client. The intention is for these to be removed eventually and to solely run on vanilla .wz files. @@ -172,10 +150,3 @@ This server requires custom .wz files (unfortunately), as you may have noted dur Make sure to always export from the client .wz files to the server XML, and not the other way around. Editing the client .wz without exporting to the server may lead to strange behavior. - -### Client features -For more information about the client and its features, see [HeavenMS on GitHub](https://github.com/ronancpl/HeavenMS#download-items). - -Some notable features: -* Opens in window mode by default -* Uncapped max speed diff --git a/pom.xml b/pom.xml index ea27a32ed18..373713bd7e9 100644 --- a/pom.xml +++ b/pom.xml @@ -1,6 +1,5 @@ - + 4.0.0 cosmic-maplestory @@ -51,24 +50,24 @@ net.server.Server - 3.2.5 - 3.4.1 + 3.5.3 + 3.4.2 3.7.1 - 2.0.13 - 2.23.1 + 2.0.17 + 2.25.0 23.0.4 24.0.1 - 4.1.109.Final + 4.2.2.Final 1.17 1.0 - 5.1.0 - 8.4.0 - 3.45.1 - 5.10.2 - 5.11.0 + 6.3.0 + 9.3.0 + 3.49.5 + 5.13.1 + 5.18.0