LAN MapleStory Server

A private MapleStory server running on local infrastructure for nostalgic gaming sessions with friends. Custom rates, quality-of-life modifications, and event systems.

JavaMySQLDockerNginxWZ EditorJavaScript

Overview

A self-hosted MapleStory private server (v83 GMS-like) running on the homelab infrastructure. This project combines nostalgia with technical learning, providing a platform for local multiplayer gaming sessions.

Technical Stack

Server Components

  • Game Server: Java-based source (HeavenMS fork)
  • Database: MySQL 8.0 for player data, items, and world state
  • Web Server: Nginx for account registration and ranking pages
  • Container: Dockerized deployment for easy management

Custom Modifications

Rate Adjustments

  • 4x EXP rates for comfortable progression
  • 2x meso rates for economy balance
  • 1.5x drop rates

Quality of Life

  • Auto-loot pets for all characters
  • Extended buff durations
  • Fast travel NPCs in major towns
  • Custom commands for party management

Challenges Solved

WZ File Editing

Modified client data files to:

  • Add custom NPCs and dialogue
  • Adjust item stats for balance
  • Create custom events and quests

Network Configuration

  • Configured proper port forwarding for LAN access
  • Set up local DNS for client connection
  • Implemented basic DDoS protection (even for LAN, good practice)

Database Optimization

  • Indexed frequently queried tables
  • Automated backup scripts
  • Character rollback capabilities

Features

Event System

Custom seasonal events with:

  • Special boss spawns
  • Unique reward items
  • Party-based challenges

Admin Tools

Web-based administration for:

  • Player management
  • Item distribution
  • Server monitoring

Nostalgia Factor

This project serves as both a technical exercise and a way to revisit childhood memories with friends. The v83 era represents the "golden age" of MapleStory for many players.

Share this project

Share: