All credits go to Ronan C. P. Lana, Nexon, Wizet, and the contributors of HeavenMS and subsequent parties. I do not take credit for any files located herein unless specifically specified otherwise. Forked from HeavenMS in order to have a history of changes made herein.
Required Files
- Use Git or checkout with SVN using this web URL
- I will refer to this location, for the source, later as {source}
- Download and install the following from here:
- current_wz
- HaSuite-211.7z
- jdk-7u79-windows-x64.exe
- ManagerMsv83.exe
- I will refer to this location, for the client, later as {client}
- netbeans-8.0.2-javase-windows.exe
- Download the latest localhost
- Download the latest mariadb that is available for Windows
- Download STREDIT
- I will refer to this location, for the extracted STREDIT, later as {edit}
Creating a New Database
- Open HeidiSQL
- Click New in the bottom-left panel
- Type a name for the new session
- Fill in the Hostname / IP, User and Password with the parameters used while setting up MariaDB
- Click Open
- Right-click your open connection in the top-left panel
- Expand Create new
- Click Database
- Type maplestory in the Name field
- Click OK
Preparing the Database
- Click maplestory in the top-left panel
- Click File
- Click Run SQL file...
- Navigate to {source}\sql
- Open db_database.sql
- Repeat steps 12 - 14 for db_drops.sql
Creating an Account
- Right-click the maplestory database and click Refresh
- Expand the maplestory database
- Click on the accounts table
- Click on the Data tab
- Press the Insert key
- Type a username into the name column
- Type a password into the password column
- Close HeidiSQL
Configure Your Server
- Navigate into the {source} folder
- Open configuration.ini
- Change HOST to the IP Address you want your server to listen on
- Change URL, DB_USER, DB_PASS to the parameters used while setting up MariaDB
Build the Server
- Open NetBeans IDE 8.0
- Click File
- Click Open Project...
- Navigate to {source}
- Click on the {source} folder
- Click Open Project
- If prompted to resolve Project Problems continue with Resolve Project Problems otherwise continue with No Project Problems
Resolve Project Problems
- Click Resolve Problems...
- Click Resolve...
- Complete steps 1 - 7 from Combined Procedure
- Click Close again
- Continue with Continued Steps
No Project Problems
- Right-click on the newly opened project
- Click Properties
- Click Libraries
- Click Manage Platforms...
- Click Add Platform...
- Complete steps 1 - 7 from Combined Procedure
- Click OK
- Continue with Continued Steps
Combined Procedure
- Check Java Standard Edition, if not already selected
- Click Next >
- Navigate to C:\Program Files\Java
- Click on jdk1.7.0_XX
- Click Next >
- Click Finish
- Click Close
Continued Steps
- Right-click on the newly opened project
- Click Clean and Build
- Close NetBeans IDE 8.0
Preparing the Client
- Navigate into the {client} folder
- Delete the HShield folder
- Delete ASPLnchr.exe, MapleStory.exe, and Patcher.exe
- Copy all files from current_wz into {client}
- Click Replace the files in the destionation
- Copy HeavenMS-localhost-WINDOW.exe into the {client} folder
- Rename HeavenMS-localhost-WINDOW.exe to MapleStory.exe
- Navigate into the {edit} folder
- Open STREDIT.exe
- Click File
- Expand Open..
- Click Open new file...
- Navigate into the {client} folder
- Click MapleStory.exe
- Click Open
- Click No
- Click No again
- Change all three IPs listed in the Configured IPs section to match HOST in the configuration.ini file
- Click File
- Click Save
Testing the Client
- Navigate into the {source} folder
- Run launch.bat
- Navigate into the {client} folder
- Run MapleStory.exe
Changing a character to a GM character
- Open HeidiSQL
- Connect to your MySQL server with the parameters used while setting up MariaDB
- Expand the maplestory database
- Click on the characters table
- Click on the Data tab
- Find the row with the character who will be a GM
- Change the gm column to one of the following values:
- 0: Common
- 1: Donator
- 2: JrGM
- 3: GM
- 4: SuperGM
- 5: Developer
- 6: Admin
- Close HeidiSQL
Port-forwarding the server
- Port-forward the following ports:
- MapleStory LoginServer 8484
- MapleStory Scania Ch 1 - 3 7575 - 7577
WZ Editing
I am going to go over how to WZ Edit with using Heena as an example. I want to change the dialogue when you talk to her. The dialogue is either in the scripts as a .js file or in the .wz files. In this example it is the .wz file. Procedure may differ based on different scenarios but hopefully this will get you an idea on how navigate the .wz file and the basics of editing.
- Extract HaSuite-211.7z
- Navigate into the extracted folder
- Open HaRepacker.exe
- Change BMS\GMS\MSEA to GMS (old) in the drop-down menu
- Click File
- Click Open...
- Navigate into the {client} folder
- Click String.wz
- Click Open
- Expand String.wz
- Double-click on Npc.img
- Find 2101
- Expand 2101
- Click d0
- Change traveller to traveler
- Click Apply Changed Value
Make sure maplestory is closed before proceeding, otherwise you will receive an unhandled excepetion error and you will have to redo your changes
- Click File
- Click Save...
- Click Save again
- Click String.wz
- Click Save for the last time
- Click Yes
- Close HaRepacker.exe
MobBookUpdate
TODO: Coming soon