Libre-Maple / MapleSolaxiaV2

Développeur indépendant : Ronan C. P. Lana

Des crédits sont à donner aussi à Nexon(Duh !), au staff original de MapleSolaxia et à d’autres collaborateurs, car juste quelques changements/patchs sur le jeu ont été appliqués par moi-même, dans lesquels certains d’entre eux divergeaient du contenu du patch original v83.

En ce qui concerne la distribuabilité et l’utilisation du code présenté ici : comme c’était le cas avant, ce serveur MapleStory est open-source. Par cela, on entend que n’importe qui est libre d’installer, d’utiliser, de modifier et de redistribuer le contenu, tant qu’il n’y a aucune sorte d’échange commercial impliqué et que les crédits aux créateurs originaux sont maintenus dans les codes.

C’est un projet NetBeans 8.0.2, qui DOIT être construit et exécuté sous JDK/JRE 7 afin de fonctionner correctement. Cela signifie qu’il est plus facile d’installer le projet en ouvrant le dossier du projet serveur dans l’IDE de NetBeans. Une fois installé, construisez ce projet sur votre machine et exécutez le serveur en utilisant l’application « launch.bat ».

Dans ce projet, de nombreux problèmes de gameplay générés soit par les fichiers WZ originaux, soit par les sources du serveur, ont été partiellement ou complètement résolus. Considérer l’utilisation des WZ édités fournis et des fichiers wz.xml côté serveur devrait être de la plus grande importance lorsqu’on traite cette instance de serveur privé, afin de la percevoir à son plein potentiel. C’est mon avis, cependant ! Reportez-vous à « README_wzchanges.txt » pour plus d’informations sur ce qui a été modifié par rapport aux fichiers WZ v83 de Nexon.

L’objectif principal de ce projet est d’essayer du mieux possible de recréer ce qu’était autrefois le MapleStory v83 original, tout en ajoutant quelques saveurs qui pimentent le gameplay. En d’autres termes, de viser à obtenir le meilleur du MapleStory de cette époque.

Les éléments à télécharger

Les fichiers du serveur : https://github.com/ronancpl/MapleSolaxiaV2

Fichiers clients& outils généraux : https://drive.google.com/drive/folders/0BzDsHSr-0V4MYVJ0TWIxd05hYUk

Donation

Si vous avez aimé ce que vous avez vu sur le projet, donnez un petit quelque chose comme coup de pouce pour mes contributions au développement de Maple.Paypal : https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3K8KVTWRLFBQ4

Préparation de l’ambiance

Le lien suivant enseigne sur comment installer un serveur privé MapleStory v83, cependant IL DIFFÈRE sur ce qui est utilisé ici : http://forum.ragezone.com/f428/maplestory-private-server-v83-741739/

Utiliser ce lien SEULEMENT COMME ORIENTATION sur où ici les choses commencent à devenir ambiguës.

En premier lieu, installer tous les outils généraux nécessaires pour faire fonctionner le serveur:

• WampServer2.0i.exe -> destinataire du serveur.
• hamachi.msi -> utilisé pour établir une route de tunnelling pour la communication serveur/client.
• mysql-query-browser-1.1.20-win.msi -> composant du serveur MySQL, stockera la BD du serveur.

Installez maintenant le kit de développement Java 7:

• jdk-7u79-windows-x64.exe
• netbeans-8.0.2-javase-windows.exe -> C’est un projet NetBeans, utilisez un autre IDE à vos risques et périls.

Supprimez chaque fois que vous y êtes invité les fichiers JAR sous « jce_policy-7/UnlimitedJCEPolicy » dans ces dossiers Java:

• C :\Program Files\Java\jre7\lib
• C:\Program Files\Java\jre7\lib\ext
• C:\Program Files\Java\jre7\lib\security
• C:\Program Files\Java\jdk1.7.0_01\lib
• C:\Program Files\Java\jdk1.7.0_01\jre\lib
• C:\Program Files\Java\jdk1.7.0_01\jre\lib\ext
• C:\Program Files\Java\jdk1.7.0_01\jre\lib\security

Maintenant que les outils ont été installés, testez s’ils fonctionnent.

Pour WampServer:Une fois que vous avez fini de l’installer, exécutez-le et vous verrez l’icône Wamp dans le coin inférieur droit.Faites un clic gauche dessus et cliquez sur ‘Mettre en ligne’.En cas d’ICÔNE ORANGE, changez le port 80 à « httpd.conf » par un autre, car il entre en conflit avec un port par défaut de Windows.Ensuite, faites un autre clic gauche dessus et cliquez sur ‘Démarrer tous les services’.L’icône de Wamp doit être complètement verte (si elle est orange ou rouge, vous avez un problème).

Pour Hamachi:Essayez de l’ouvrir. C’est aussi simple que cela.Hamachi est facultatif, cependant. Vous n’avez pas besoin d’installer Hamachi si vous voulez faire le serveur juste pour l’utiliser sur votre propre machine. Cependant, si vous voulez permettre à d’autres joueurs d’accéder à votre serveur, pensez à utiliser alternativement des méthodes de redirection de port.

Installation du SERVEUR

Définissez le dossier « MapleSolaxia » sur un endroit de votre préférence. Il est recommandé d’utiliser « C:\Nexon\MapleSolaxia ».

Configuration du SQL : ouvrez MySQL Query Browser, et définissez ces paramètres au démarrage et cliquez sur OK:Server Host : localhostPort : 3306Username : root

Maintenant il faut faire ATTENTION:

1. File -> Open Script.. -> Rechercher « C:\Nexon\MapleSolaxia\sql » -> db_database.sql, et l’exécuter.
2. Fichier -> Ouvrir le script… -> Rechercher « C:\Nexon\MapleSolaxia\sql » -> db_drops.sql, et l’exécuter.

Maintenant, c’est OPTIONNEL, vous n’avez pas besoin de l’exécuter si vous ne voulez pas, car il va simplement changer certaines boutiques de PNJ pour mettre en place de nouveaux biens, non présents dans le MapleStory original, à vendre:

1. Fichier -> Ouvrir le script…. -> Rechercher « C:\Nexon\MapleSolaxia\sql » -> db_shopupdate.sql, et l’exécuter.

A la fin de l’exécution de ces SQL, vous devriez avoir installé un schéma de base de données nommé « maplesolaxia ». ENREGISTREZ VOTRE PREMIER COMPTE à utiliser dans le jeu en créant manuellement une entrée sur la table « accounts » de cette base de données avec un login et un mot de passe.

Configurez l’IP que vous voulez utiliser pour votre serveur MapleStory dans le fichier « configuration.ini », ou définissez-la comme « localhost » si vous voulez le faire tourner uniquement sur votre machine. Vous pouvez également utiliser l’adresse IP donnée par Hamachi pour l’utiliser sur un réseau Hamachi, ou utiliser une méthode de redirection de port non Hamachi. Ni l’une ni l’autre ne seront abordées ici.

Ouvrez maintenant NetBeans, et choisissez Ouvrir un projet…. Sélectionnez alors le dossier « MapleSolaxia », qui devrait déjà être un projet reconnaissable par NetBeans. Si ce n’est pas le cas, vous avez un problème.

Dans le projet, vous pouvez rencontrer des erreurs de code. Celles-ci se produisent parce que vous n’avez pas encore défini les « noyaux » du projet. Dans la hiérarchie du projet, cliquez avec le bouton droit de la souris sur le projet et sélectionnez « Résoudre les problèmes du projet ». Localisez le dossier « cores » à l’intérieur du répertoire racine de ce projet et configurez manuellement les fichiers manquants avec les fichiers qui s’y trouvent.

Enfin, sélectionnez « Clean and Build project » pour construire le fichier JAR pour le serveur MapleStory. Une fois fait, assurez-vous que WampServer et Hamachi sont allumés et fonctionnent, puis exécutez « launch.bat » à la racine du projet. Si aucune erreur n’a été soulevée par cette action, votre serveur MapleStory est maintenant en ligne.

Installation du CLIENT

La configuration du client est assez simple:

1. Depuis « ManagerMsv83.exe », installez MapleStory sur votre dossier de préférence (par exemple « C:\Nexon\MapleStory ») et suivez leurs instructions.
2. Une fois fait, effacez ces fichiers : « HShield » (dossier), « ASPLauncher.exe », « MapleStory.exe » et « patcher.exe ».
3. Extraire dans le dossier client le « localhost.exe » de Localhostv83.
4. Effacer les fichiers WZ originaux avec ceux fournis par le dossier « client_wz » sur le Google Drive.

Si vous n’utilisez pas « localhost » comme IP cible dans le fichier de configuration du serveur, vous devrez HEX-EDITER « localhost.exe » pour récupérer votre IP. Retrouvez tous les emplacements IP en recherchant « Text String » « 127.0.0.1 », et appliquez les modifications partout où cela convient.

Pour l’édition hexadécimale, installez l’éditeur hexadécimal Neo à partir de « free-hex-editor-neo.exe » et suivez leurs instructions. Une fois fait, ouvrez « localhost.exe » pour l’édition et écrasez les valeurs IP sous les 3 adresses. Enregistrez les modifications et quittez l’éditeur.

Ouvrez le client « localhost.exe ». Si par n’importe quel moyen le programme ne s’est pas ouvert, et en vérifiant que le journal du serveur votre ping a été écouté et vous utilisez Windows 8 ou 10, il pourrait probablement être un problème de compatibilité. Extrayez « lolwut.exe » de « lolwut-v0.01.rar » et placez-le dans le dossier client de MapleStory (« C:\Nexon\MapleStory »). Vos paramètres de propriété de « localhost.exe » doivent suivre ceux-ci:

• Exécuter en mode de compatibilité : Windows 7;
• Mode couleur réduit non coché;
• Résolution 640 x 480;
• Non coché désactiver l’affichage sur les paramètres DPI élevés;
• Exécuter en tant qu’administrateur;
• Ouvrir « lolwut.exe », utilisez la méthode de Fraysa.

Important : si le client étant refusé de se connecter au serveur de jeu, cela peut être à cause de problèmes de pare-feu. Rendez-vous à la fin de ce fichier pour procéder à l’activation de cette connexion avec le pare-feu de l’ordinateur. Alternativement, on peut désactiver le pare-feu et essayer d’ouvrir le client à nouveau.

Note importante sur l’ÉDITION DU CLIENT

N’UTILISEZ PAS les XML du serveur pour les réimporter dans le WZ du client, cela générera des sortes de bugs par la suite.

• Utilisez plutôt le HaRepacker 4.2.4, cryptage « GMS (old) ».
• Ouvrez la WZ désirée pour l’éditer et, EN UTILISANT L’IU, faites les changements désirés.
• Enregistrez la WZ modifiée, en écrasant le contenu original dans le dossier du client.
• Enfin, RE-EXPORTEZ (option d’exportation « Private Server… » option d’exportation) les XML modifiés dans les fichiers WZ.XML du serveur, en écrasant l’ancien contenu.

Ces étapes sont IMPORTANTES pour maintenir la synchronisation entre les modules serveur et client.

Comme exemple d’édition de WZ client, considérez le projet MobBookUpdate que j’ai développé, pour mettre à jour toutes les données de chute rapportées des mobs dans le jeu en fonction des données de chute actuelles sur la base de données :

• Ouvrir le projet MobBookUpdate sur NetBeans, situé à « C:\Nexon\MapleSolaxia\MobBookUpdate », et le construire.
• Dans le sous-dossier « lib », copiez le fichier « MonsterBook.img.xml ». Il provient de la version originale de WZ v83.
• Collez-le sur le sous-dossier « dist ».
• Dans « dist », ouvrez l’invite de commande en y faisant un clic alt+droit.
• Exécutez « java -jar MobBookUpdate.jar ». Cela générera un fichier « MonsterBook_updated.img.xml ».
• Enfin, écrasez le « MonsterBook.img.xml » sur « C:\Nexon\MapleSolaxia\wz\String.wz » avec ce fichier, en le renommant en « MonsterBook.img.xml ».

À ce stade, le Monster Book côté serveur a été mis à jour avec l’état actuel des données de chute de la base de données. Ensuite, ouvrez HaRepacker 4.2.2 et chargez « String.wz » depuis « C:\Nexon\MapleStory ». Déposez le nœud « MonsterBook.img » en le supprimant de l’arbre hiérarchique, puis (CONTRAIREMENT À CE QUI DEVRAIT ÊTRE FAIT NORMALEMENT !) importez le « MonsterBook.img.xml » du serveur.

Prenez note que ceci est absolument dangereux s’il est fait sans précaution. Une fois que le MonsterBook.img ne contient pas de données spécifiques au client dans le contenu de ses nœuds, l’importation du XML ne cause aucun mal du tout. Cependant, essayez de ne pas supprimer/réimporter les nœuds des fichiers WZ, car cela peut entraîner des pertes de données. Utilisez plutôt l’interface utilisateur de HaRepacker pour effectuer les modifications.

Sauvegardez les modifications et écrasez l’ancien WZ sur le dossier du client MapleStory.

Portforwarding the SERVER

Pour utiliser le portforward, vous devrez avoir la permission de modifier des choses sur le routeur LAN. Accédez à votre routeur en utilisant le navigateur Internet. Les URL varient en fonction du fabricant. Pour le découvrir, ouvrez l’invite de commande et tapez « ipconfig » et recherchez le champ « default gateway ». L’IP qui y figure est l’URL nécessaire pour accéder au routeur. Cherchez également l’IP donnée à votre machine (alias champ « adresse IPv4 »), qui sera celle du serveur.

Le login/mot de passe par défaut varie également, utilisez donc le lien http://www.routerpasswords.com/ comme référence. Habituellement, le login en tant que « admin » et le mot de passe en tant que « password » accomplit bien la tâche.

Maintenant que vous vous êtes connecté au système du routeur, recherchez tout ce qui concerne le portforwarding. Si le système vous invite entre le portforwarding et le portriggering, choisissez le premier, c’est ce que nous allons utiliser.

Maintenant, il est nécessaire d’activer les bons ports pour l’Internet. Pour MapleSolaxia, il est essentiellement nécessaire d’ouvrir les ports 7575 à 7575 + (nombre de canaux) et le port 8484. Créez un nouveau service personnalisé qui active cette gamme de ports pour le canal du serveur et choisissez d’utiliser les protocoles TCP/UDP. Enfin, créez maintenant un service personnalisé pour l’utilisation du port 8484.

Optionnellement, si vous voulez héberger une page web, transférez également le port 80 (le port HTTP).

Ce n’est pas encore fait, parfois les pare-feu bloquent les connexions entre le LAN et l’Internet. Pour y remédier, il est nécessaire de créer quelques règles pour le pare-feu afin d’autoriser ces connexions. Recherchez les options avancées avec les pare-feu sur votre ordinateur et, avec celui-ci ouvert, créez deux règles (une sortante et une entrante).

Ces règles doivent cibler « une application », « permettre les connexions » et doivent cibler votre client MapleStory (aka localhost).

Après toutes ces étapes, le processus de portforwarding devrait maintenant être terminé.