[Setup Guide] v117.2 Private Server on Windows 10 Build 1709 - Working 2024

[ralagagu]

This is a forgotten version from long ago (Sept 2012), due to its very limited operating system compatibility.
Here are instructions on how to get it running in 2024 and beyond.
These steps are reproduceable and have been executed multiple times before posting this guide.

WARNING: DO NOT ATTEMPT THESE STEPS IF YOU ARE NOT ON WINDOWS 7 OR WINDOWS 10 BUILD 1709 16299.125 / 16299.1087
ANY OTHER VERSIONS WILL NOT WORK. YOU WILL BE WASTING YOUR OWN TIME.
Read more about it here: https://forum.ragezone.com/threads/working-maplestory-v117-2-windows-10.1143280/

MapleStory Private Server v117.2 Setup Guide
From Scratch on Fresh Windows 10 Pro 64-Bit Build 1709 16299.125 & 16299.1087
Tested Hardware: MacBook Pro Late 2019 16 Inch - Intel i7 - 16GB Ram - 512GB SSD - Radeon 5300
- Working as of 12/25/2023
- MacBook Pro on Mac Os 12.7.1 Monterey, using Boot Camp Assistant w/ Windows 10 1709 16299.125 Multi Iso, installed windows 10 via Bootcamp

FINAL WARNING: DO NOT BOTHER TRYING UNLESS YOU MEET THE REQUIREMENTS. YOU WILL BE VERY DISAPPOINTED.


Windows 10 Build 1709 Setup

1. Files you will need
MapleStory - Server source: https://forum.ragezone.com/threads/development-v117-2-source.1040283/
- For simplicity, any instances of NostalgiaStory is referring to Development v117.2 source.
MapleStory v117 - https://forum.ragezone.com/threads/maplestory-client-localhost-archive.1101897/
- You will need to patch it to v117.2. Which can be done on a W7 virtual machine, then transfering the Maplestory folder to your W10 Build 1709 Machine.

//INSTALLING STUFF
2. Install the following:
a. winrar-x64-51b4.exe
b. npp.7.5.9.Installer.x64
c. jdk-8u5-nb-8-windows-x64.exe - Default settings, No JUnit, do not search for updates - NetBeans 8.0 bundled.

----------------------------------------------------------------------------------
// Setting Up MySQL Server
Eric's Development SQL Database REQUIRES MySQL 5.6.17

3. WINDOWS 10 1709:
a. Install all_vc_redist_x86_x64.zip (yes all of them, 2008 to 2022, both x64 and x86)
b. Install wampserver3.3.0_x64 - select MariaDB 10.10.2, MySQL 5.7.40
c. START Wampserver x64, it should load 2 of 3 services. (Orange Icon)
d. Install wampserver3_x64_addon_mysql5.6.17.exe
e. Start wampserver, left click icon. Select MySQL 5.6.17.
- it won't work initially, need to modify stuff. Most likely will be orange with 2 / 3 Services running.

4. Fixing MySQL 5.6.17 for Windows 10 Bootcamp via GPT Drive
If you encounter null error, and error 87 / 187, do steps below: Solution -

You must be registered to see links

a. Delete ibdata1, ib_logfile0, ib_logfile1 in C:\wamp64\bin\mysql\mysql5.6.17\data
b. Copy pre-made 'my.ini' into C:\wamp64\bin\mysql\mysql5.6.17, overwrite existing one.
my.ini changelog:
uncomment skip_grant_tables
innodb_buffer_pool_size = 256M
innodb_log_file_size = 256M
innodb_thread_concurrency = 16
innodb_flush_log_at_trx_commit = 2
innodb_flush_method = normal
optional
- set permissions - c:/wamp64 folder - uncheck read only
- set security full control
c. Restart Wampserver - It should be green.

5. Install mysql-gui-tools-5.0-r17-win32.msi - Default settings

-----------------------------------------------------------------------------------
// Setting Up MySQL Database - Must Be 5.6.17
6. Run WampServer -> Open MySQL Query Browser
a. Server Host: localhost
b. Port: 3306
c. Username: root
d. Password: blank (empty)

7. File -> Open Script -> /NostalgiaStory/SQL/Development 20141203 1907.sql -> Execute
a. There should be no errors if MySQL was setup properly on 5.6.17.
If error1. line 173 Table storage engine for androids doesn't have this option:
ISSUE: You are not using MySQL 5.6.17
b. Wait for it to finish executing (1 minute).

7.1. Make an account for login.
a. Goto Ascension Schemata, account. Execute the table and edit it to add 'admin', 'password' account. ToS = 1.
b. Apply. Close MySQL Browser.

----------------------------------------------------------------------------------------
//Adding JCE_Policy to Java Folders
7.5. Extract contents of jce_policy-8.zip to folders in C:\Program Files\Java
a. C:\Program Files\Java\jdk1.8.0_05
b. C:\Program Files\Java\jre8\lib
c. C:\Program Files\Java\jre8\lib\security
d. C:\Program Files\Java\jre8\lib\ext

---------------------------------------------------------------------------------------------------------
//SETTING UP IDE - IntelliJ vs NetBeans - You can use either.

//SETTING UP INTELLIJ JAVA PROJECT
8a. IntelliJ -> Open -> C:\Users\W117.2\Documents\NostalgiaStory\src

9a. File -> Project Structure -> Project Settings, Project
- Name: NostalgiaStory
- SDK: 1.8 Oracle OpenJDK Version 1.8.0_5
- Language: Sdk default
- Compiler output: C:\Users\W117.2\Documents\NostalgiaStory

10a. File -> Project Structure -> Project Settings, Libraries
a. Plus Sign -> Java -> C:\Users\W117.2\Documents\NostalgiaStory\jarLibs
b. Select mina-core.jar, mysql-connector-java-bin.jar, slf4j-api.jar, slf4j-jdk14.jar

11a. File -> Project Structure -> Project Settings Artifacts
a. Plus Sign -> JAR -> From modules with dependencies
- Module: NostalgiaStory
- Main Class: server.Start
- extract to the target JAR
- Directory for META-INF/MANIFEST.MF: C:\Users\W117.2\Documents\NostalgiaStory\artifacts
- Ok.
- Output Directory: C:\Users\W117.2\Documents\NostalgiaStory\artifacts
- [tick] Include in Project Build

12. Build and Pray

//SETTING UP NETBEANS JAVA PROJECT - not needed if using IntelliJ
8b. NetBeans IDE 8.0 -> New Project
a. Categories: Java, Projects: Java Application
b. Project Name: NostalgiaStory, Project Location: C:\Users\W117.2\Documents
c. Uncheck Use dedicated folder for storing Libraries, Create Main Class
d. GitHub website -> Download Zip of NostalgiaStory -> Extract contents of it inside C:\Users\W117.2\Documents\NostalgiaStory\src

9b. List of non-git needed files:
a. jarLibs/mina-core.jar // mysql-connector-java-bin.jar // slf4j-api.jar // slf4j-jdk14.jar
- copy them from jarLibs/
b. /wz/ -> found in v117xmlwz.rar
- extract it to NostalgiaStory/wz/

10b. Add Libraries in Netbeans:
a. Extract jarLibs.rar
b. Right click Libraries -> Add JAR/Folder -> Navigate to jarLibs -> Add 4 .jar's

11b. Build and Pray (Hammer Icon)
a. It should create a /build folder and /dist folder. No need to touch them.

---------------------------------------------------------------------------------------------------------
//Launching the Server

12. Extract v117.2xmlwz.rar to /NostalgiaStory/wz
-

You must be registered to see links

13. Run launch.bat
a. Ensure the NostalgiaStory.jar address is corerct in launch.bat, set CLASSPATH=.;artifacts\NostalgiaStory.jar
b. If error at CashItemFactory.java:54 occurs with input string "10003361 ", need to delete the white space in:
wz/etc/cashpackage.xml, delete the new line.
example: <string name="0" value="10003361"/> @ line 4787

------------------------------------------------------------------------------------------
//Installing Local MapleStory files

15. Copying MapleStory v117.2 Files
a. (Disable Anti-Virus)
b. Copy LEN-basic_v115.1.rar to C:/Nexon/MapleStory, extract it.

You must be registered to see links

c. LEN.ini modify -> IP=127.0.0.1

--------------------------------------------------------------------------------------------
//Launching Game

16. Launcher.exe (make sure anti-virus is off)

IF You use v117 Setup (unpatched from v117.2)
- Themida - An Internal exception occured (Address: 0x12b2910) Please, contact support@oreans.com thank you!
https://forum.ragezone.com/threads/private-server-offline-v117.998024/
- Solution is to copy Nexon/Maplestory folder from a patched v117.2 device installation (backed up)

-----------------------------------------------------------------------------------------------
For those of you who wish to run on newer builds of Windows 10, you will need to Patch HideDll.
[ENABLE]
00480CF0:
db 31 C0 C3

[DISABLE]
00480CF0:
db 55 8B EC