Head developer: Ronan C. P. Lana

Besides myself for maintaining this repository, credits are to be given to Wizet/Nexon (owners of MapleStory & it's IP contents), the original MapleSolaxia staff and other colaborators, as just some changes/patches on the game were applied by myself, in which some of them diverged from the original v83 patch contents (alright, not just "some patches" by now since a whole lot of major server core changes have been applied on this development).

Regarding distributability and usage of the code presented here: like it was before, this MapleStory server is open-source. By that, it is meant that anyone is free to install, use, modify and redistribute the contents, as long as there is no kind of commercial trading involved and the credits to the original creators are maintained within the codes.

This server source should be built and run on Java 8 in order to run properly -- used to be ran in Java 7, thanks kolakcc (Familiar) for the Java 8 support!

Consider using an IDE for setting up the server source into a project. Once mounted the project, build it on your machine and run the server using the "launch.bat" application.

In this project, many gameplay-wise issues generated from either the original WZ files and the server source have been partially or completely solved. Considering the use of the provided edited WZ's and server-side wz.xml files should be of the greatest importance when dealing with this instance of server source, in order to perceive it at it's full potential. My opinion, though!

In other case, as fallback from the provided ones, consider using whole clean set. Selecting part of the provided ones to play pretty much may eventually lead to unexpected issues.

The main objective of this effort is to try as best as possible to recreate what once was the original MapleStory v83, while adding up some flavors that spices up the gameplay. In other words, aim to get the best of the MapleStory of that era.

Download items

Server files: https://github.com/ronancpl/HeavenMS

Client files & general tools: https://drive.google.com/drive/folders/0BzDsHSr-0V4MYVJ0TWIxd05hYUk

Java 8 SDK & NetBeans bundle: https://www.oracle.com/technetwork/pt/java/javase/downloads/jdk-netbeans-jsp-3413153-ptb.html

Important note about localhosts: these executables are red-flagged by antivirus tools as potentially malicious softwares, this happens due to the reverse engineering methods that were applied onto these software artifacts. Those depicted here have been put to use for years already and posed no harm so far, so they are soundly assumed to be safe.

Latest localhost: https://hostr.co/amuX5SLeeVZx

The following list, in bottom-up chronological order, holds information regarding all changes that were applied from the starting localhost used in this development. Some lines have a link attached, that will lead you to a snapshot of the localhost at that version of the artifact. Naturally, later versions holds all previous changes along with the proposed changes.

Change log:

Fixed Monster Magnet crashing the caster when trying to pull fixed mobs, credits to Shavit. https://gofile.io/?c=BW7dVM
Cleared need for administrator privileges (OS) to play the game, credits to Ubaware.
Set a higher cap for AP assigning with AP Reset, credits to Ubaware.
Fixed Monster Magnet crashing the caster when trying to pull bosses. Drawback: Dojo HPBar becomes unavailable. https://hostr.co/SvnSKrGzXhG0
Fixed some 'rn' problems with quest icons & removed "tab" from party leader changed message. https://hostr.co/tsYsQzzV6xT0
Removed block on applying attack-based strengthening gems on non-weapon equipments. https://hostr.co/m2bVtnizCtmD
Set a higher cap for SPEED.
Removed the AP assigning block for beginners below level 10. https://hostr.co/AHAHzneCti9B
Removed block on party for beginners level 10 or below. https://hostr.co/JZq53mMtToCz
Removed block on MTS entering in some maps, rendering the buyback option available.
Removed "AP excess" popup and limited actions on Admin/MWLB, credits to kevintjuh93.
Removed "You've gained a level!" popup, credits to PrinceReborn.
Removed caps for WATK, WDEF, MDEF, ACC, AVOID.
'n' problem fixed.
Fraysa's https://hostr.co/gJbLZITRVHmv
Eric's MapleSilver starting on window-mode.

Open-source client development - HeavenClient

Continuing from where SYJourney's JourneyClient has finished contributions (as of 5 Jul 2016), an open-source development of a software artifact designed to handle both gaming operations and interactions with the server is being conducted.

Newer implementations are being maintained by 頼晏 (ryantpayton) and aims to offer higher display resolution, bring recent UI contents for the pre-BB gameplay and incremental support on overall gaming perspective.

HeavenClient Github: https://github.com/ryantpayton/HeavenClient

Development information

Status: <span style="color:SkyBlue">Released (4 rounds)</span>.

Mission

With non-profitting means intended, provide nostalgic pre-BB maplers world-wide a quality local server for freestyle entertainment.

Vision

By taking the v83 MapleStory as the angular stone, incrementally look forward to improve the gaming experience whilst still retaining the "clean v83" conservative ideal. Also, through reviewing distinguished aspects of the server's behavior that could be classified as a potential server threat, in the long run look for ways to improve or even stabilize some of it's uncertain aspects.

Values

Autonomy, seek self-improvement for tackling issues head-on;
Adventurous, take no fear of failures on the path of progress;
Light-hearted support, general people out there didn't experience what you've already had;
Humility, no matter how good you are, there's no good in boasting yourself over experiences only a few have had;

Announcements

HeavenMS development as we can see right now achieved an acceptable state-of-the-art. A heartfelt thanks for everyone that contributed in some way for the progress of this server!

A case study has been conducted with the objective of overview results achieved during HeavenMS development. Those can be checked out on: https://heavenms-survey.home.blog/2019/12/24/project-visualizations/

Support HeavenMS

If you liked this project, please don't forget to star the repo ;) .

It's never enough to tell this, thanks to everyone that have been contributing something for the continuous improvement of the server! Be it through bug reports, donation, code snippets and/or pull requests.

Our Discord channel is still available on: https://discord.gg/Q7wKxHX

Disclaimer

HeavenMS staff has no current intention to publicly open a server with this source, if that ever comes to happen this note will be lifted. Don't be scammed!
This server source is NOT intended to be stable as is. Proper deadlock review and other maintenance contributions are needed in order to make it steps ahead on viability.

Preparing the ambient

The following link teaches on how to install a MapleStory v83 private server, however IT DIFFERS on what is used here: http://forum.ragezone.com/f428/maplestory-private-server-v83-741739/

Use that link ONLY AS AN ORIENTATION on where here things start to become ambiguous.

Firstly, install all the general tools required to run the server:

WampServer2.0i.exe -> recipient of the MySQL server.
mysql-query-browser.msi -> MySQL client component, visually shows the DB data and hubs queries.
hamachi.msi -> used for establishing a tunnelling route for the server/client communication.

Now install the Java 8 SDK & NetBeans bundle (or any other IDE of your liking):

jdk-8u111-nb-8_2-windows-x64.exe -> JDK/JRE 8 & IDE for building the server.

Now that the tools have been installed, test if they are working.

For WampServer:

Once you're done installing it, run it and you will see the Wamp icon on the bottom right corner. Left click it and click 'Put Online'.
In case of ORANGE ICON, change port 80 at "httpd.conf" to another, as it clashes with a Windows default port. Then Left click it again and click 'Start All Services'.
The Wamp icon must look completely green (if its orange or red, you have a problem).

For Hamachi:

Try opening it. It's that simple.

Hamachi is optional, though. You don't have to install Hamachi if you want to make the server just for use on your own machine. However, if you want to let other players access your server, consider alternatively using port-forwarding methods.

Installing the SERVER

By downloading through the Github download button, you may have obtained a ZIP file with a single "HeavenMS-master" folder on it. EXTRACT that folder.

For expediency, "HeavenMS-master" folder on this guide will be referred just as "HeavenMS". Rename it for convenience. Then, set "HeavenMS" the folder on a place of your preference. It is recommended to use "C:\Nexon\HeavenMS".

Setting up the SQL: open MySQL Query Browser, then create a new session with the parameters below, then click OK.

Server Host: localhost
Port: 3306
Username: root

Now it must be done CAREFULLY:

File -> Open Script... -> Browse for "C:\Nexon\HeavenMS\sql" -> db_database.sql, and execute it.
File -> Open

HeavenMS

Install / Use

README