MaplePatcher - An automated patching system for MapleStory Private Servers

Joined
Jun 28, 2006
Messages
297
Reaction score
190
Hi y'all.

I am currently working on a patching system for MapleStory called MaplePatcher. It's about 90% complete as it's basically in the testing phase now.

Some features include:
- CRC32 checking for file integrity vs files hosted remotely
- Supports both .WZ and extracted clients (such as folders and .img files), and all other dependent files in the MapleStory directory
- Includes a splash page where you can update players with a notice when they launch the game, which is simply just a browser
- Intended for the player to launch first each time they play the game
- Bandwidth protection; if users mess with the MapleStory directory too much, it will error out and force users to redownload the full version the traditional way, so it's not completely patching the entire MapleStory directory in one go
- Anti-virus/Defender check on MapleStory.exe, and it will inform you how many times it had to re-patch MapleStory.exe and to make users aware to allow the MapleStory directory as an antivirus exclusion if it happens more than 3 times
- JSON API, no mysql required for remote patch files and script, and remote API is cached so no needless script-loading after first load
- Simple "Play Game" button after patching is complete, which will close the patcher, and then launch MapleStory.
- Remotely flag if server is offline, under maintenance, pending future maintenance, or even if the user is banned (such as IP).

Features planned:
- The ability to patch and update...itself.
- Making it look a bit prettier
- Patch within .WZ files without just simply replacing the whole .WZ in one go (with .WZ encryption-type selection based on server version)

Full release planned in about a month.

Attached are some example screenshots

What it looks like when the game is ready to play, and it's fully patched up:
Screenshot 2025-04-05 030754 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


What it looks like when it's patching
Screenshot 2025-04-05 032504 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


When flagged for "Pending Maintenance", to have users be aware that while they can play for now, they will soon get disconnected:
Screenshot 2025-04-05 032558 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


When flagged as down for maintenance
Screenshot 2025-04-05 032808 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


When banned
Screenshot 2025-04-05 032917 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


It also has a "-debug" argument.

Screenshot 2025-04-05 033327 - MaplePatcher - An automated patching system for MapleStory Private Servers - RaGEZONE Forums


Here's a video on what happens if you delete some files in the MapleStory directory, the patcher will bring them back.

Same thing will happen if you edit any of them, even with a Hex editor, as the crc32 check will kick in and re-patch them to what's current.

Link to video example:
 
Last edited:
Back