Skip to content
Amos Chua edited this page Jan 26, 2023 · 10 revisions

Table of Contents:

Catergory Question
General Can I re-post the source code elsewhere without credit?
What's the difference between this and AzureMS v354.5?
What's the difference between this and AzureV316?
Software Tools Which Java JDK version should I use?
Do I need to set the encoding?
Can I use Netbeans instead of IntelliJ for IDE?
What's the difference between HeidiSQL and MySql Workbench? Which one should I use?
Set-up Which SQL script should I use?
Where can I download a test client (with localhost) to use for testing?
Can I turn off the GUI Admin Tool?
Testing How do I run the test client?
Are there any stock accounts provided?
How do I add new accounts?
Why do I get a pop-up telling me "This client can be executed only in Korean code-page", when I try to run the client?
Miscellaneous Are there open source projects for Azure-based Discord Bots as well?
How can I allow other people to connect to the server, if I use this source?
How can I add translations for players?

Questions:

Q: Can I re-post the source code elsewhere without credit?

A: No. Open source does not mean that it's in the public domain. We would appreciate if you could keep any forks as public repositories on GitHub. If you must VCS it elsewhere, then kindly credit the authors and maintainers.

This is a reminder that reposting without credits, and/or claiming credit for this repository is intellectual property theft. You would be STEALING.


Q: What's the difference between this and AzureMS v360?

A: This is an open source project maintained by Team SPIRIT for a community-driven development of a KMS v316-based server.
The v360 version is an unaffiliated project, that is in closed-source development by SoulGirlJP (now known as SoulyWK).


Q: What's the difference between this and AzureV316?

A: The AzureV316 repository is based on an early build of AzureMS v316, which precedes many fixes and feature updates. This repository is based on a later build of AzureMS v316, and should be closer to the AzureMS v316 experience that most players remember or see on YouTube.


Q: Which Java JDK version should I use?

A: Java 8.


Q: Do I need to set the encoding?

A: Yes! Azure v316 uses Windows-949 (CP949) instead of Unicode or EUC-KR.
Note: CP949 does not support alphabetical sorting


Q: Can I use Netbeans instead of IntelliJ for IDE?

A: Yes - set the encoding to extended unix code eucKR (also stylised as EUC-KR) and you should be good to go.
There some differences, but it would work for the most part.


Q: What's the difference between HeidiSQL and MySql Workbench? Which one should I use?

A: It is entirely up to personal preference.
There aren't many notable differences aside from the fact that you need to use WAMP/XAMP if you're going for the MySQL route, since MySQL Workbench doesn't host the DB, unlike HeidiSQL. The usage of either is split for the AzureMS staff of the time as well: for instance, Dipi preferring Heidi and KOOKIIE/Brandon/Desc preferring MySQL.


Q: Which SQL script should I use?

A: If you're a beginner, please use the AzureSQLWithData.sql script from the AzureV316 repository.
More advanced users may simply use the ElectronDB.sql script from this repository to start the server with a clean slate. Do note that you will need to manually set the Maple Admin NPC (ID: 9062000) in the spawn map (ID: 410000001) for new characters, using the spawn table in the database if you choose to do so. Alternatively, make use of the spawn table insertions in AzureSQLWithData.sql script from the AzureV316 repository to grab all of Azure's default NPCs.


Q: Can I turn off the GUI Admin Tool?

A: There is a flag in src/constants/ServerConstants (ENABLE_ADMIN_TOOL) that can be set to false.
This will speed up compile and start up time, but has not been extensively tested. It's a crude circumvention by means of wrapping every reference in an if-else check.


Q: Where can I download a test client (with localhost) to use for testing?

A: SoulGirlJP's AzureV316 client will work for this.
More advanced users may choose to use their own clean KMS v316 client, alongside ElectronClient. See the announcement in the ElectronMS Discord for more details.


Q: How do I run the test client?

A: If you're using SoulGirlJP's AzureV316 client, run TAIGA_redirector and it should launch the client for you!


Q: Are there any stock accounts provided?

A: If you set up the database using AzureSQLWithData.sql (as instructed earlier), there should be a stock account provided:

Otherwise, no, you would have to set up your own admin accounts.


Q: How do I add new accounts?

A: There are 2 main ways: 1) via SQL 2) Turn on auto-register (should already be on by default)

  • Note: SQL route is only for those who know what they're doing - as such, detailed instructions have been omitted.
  • To turn on auto-register, go to the constants file: src/constants/ServerConstants.java, then set AUTO_REGISTER = true;

Q: Why do I get a pop-up telling me "This client can be executed only in Korean code-page", when I try to run the client?

A: Due to encoding issues, KMS clients require the system locale to be in Korean. See here for instructions. Do not worry, as your system and input languages will remain unchanged.


Q: Are there open source projects for Azure-based Discord Bots as well?

A: As a matter of fact, yes!
KOOKIIE has made a (Python) API library, Lazuli, for querying AzureV316-based databases.
Brandon has made a plug-and-play (Python) bot, Lapis, that is based on Lazuli. You can check it out for a Discord bot that is very easy to set-up and use.


Q: How can I allow other people to connect to the server, if I use this source?

A: This open source project is mainly focused on server development; custom launcher and re-directors are beyond the scope of this project. That said though, ElectronClient is nonetheless available as an option. See the announcement in the ElectronMS Discord for more details.


Q: How can I add translations for players?

A: This open source project is mainly focused on server development. NPC dialogue (and most other server-sided text) should already be in English. English locale for the client side would probably require WZ and/or client edits, and are beyond the scope of this project.

There was supposed to be a fork focused on translating everything to English. However, the owner of that fork seems to have gotten busy with other projects instead and it hasn't been updated in a long time.


AOB:

Kindly forward any unanswered queries to the issues page.
If you'd like to chat with the developers, you may find us in the ElectronMS Discord

Parallels with AzureV316 Wiki:

Both wikis were written by the same person: KOOKIIE
That's why they're similar.

Clone this wiki locally