Skip to content

About

A full reimplementation of MapleStory v83 client in Rust. Targeting native MacOS, Windows, and WASM.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

OpenStoryRS

This repository is the Rust port of the OpenStory v83 MapleStory game client. The implementation roadmap is in PORT_PLAN.md.

The client reads the existing NX assets in place. UI.nx is the version 83 UI archive and the client resolves UI asset paths from it. Keep the files in the existing OpenStory/wz directory; point the client at them with OPENSTORY_DATA_DIR=/path/to/wz or --data-dir /path/to/wz.

Core in-game panels use their v83 frames and controls from UI.nx, including stats, inventory and equipment, skills, quests, chat, map windows, and options. Live character and server data is rendered over the NX artwork.

The native client opens v83 login and world/channel artwork in a resizable GPU-backed window, keeps a 1024x768 logical canvas, and scales with letterboxing. The account and password fields accept text; the password is masked. The selected world and channel can be used to request a character list. Characters display name, level, job, and map. In the field, the camera keeps the player above the status bar and uses the visible field area for map limits. Escape opens the quit confirmation when no panel is handling it. The login background's six light beams animate independently using their NX frame delays; login buttons use their NX disabled, mouse-over, and pressed art. Keyboard focus uses NX focus art when available and a gold outline otherwise. Tab cycles through the account field, password field, and enabled actions; arrows move among actions, and Enter or Space activates the focused action. Login and Guest are enabled while the session connects; clicking either queues the request until the Maple handshake and login-start packet complete. Login also requires an account of 1–12 characters and a password of 5–12 characters. If the server reports that its Terms of Service have not been accepted, the client asks the player to review them; clicking OK or pressing Enter sends acceptance, while Escape cancels. The selection screen follows the legacy three-slot layout and pages through all characters returned by the server. Click a character's avatar or the Start sign to enter; Enter also selects the highlighted character. Character selection supports PIC registration, verification, and the disabled-PIC path; PIC entry is masked and accepts 6–16 letters or numbers from the keyboard. Each row also has a Delete action with confirmation and optional PIC verification. Set OPENSTORY_MACS and OPENSTORY_HWID to override the legacy selection hardware strings. On macOS, when either override is absent, the client supplies the v83-compatible MAC/HWID format from the primary network interface and the platform UUID, matching the legacy client's character-selection packets. These values are sent only as part of character selection and PIC requests to the configured Maple server. When a character slot is free, Create Character opens Explorer, Cygnus Knight, and Aran class choices. The customization screen reads gender-specific face, hair, color, skin, clothing, shoe, and weapon pools from Etc.nx, previews the selected avatar, checks forbidden names locally, and uses the v83 name-check/create packets. The server's new character entry is added to the current selection list.

Set OPENSTORY_FONT_PATH to select a TrueType font; macOS, Windows, and Linux system-font locations are used as fallbacks. The client connects to 127.0.0.1:8484 by default so the packaged app can reach a local v83 server without command-line arguments. Set OPENSTORY_SERVER=HOST:PORT to choose another default, or use --connect HOST:PORT to override it. The client completes the Maple handshake and sends the login-start packet before any queued login request. The login button submits the fields. Set OPENSTORY_ACCOUNT and OPENSTORY_PASSWORD to prefill them, or set OPENSTORY_AUTO_LOGIN=1 to submit them after the handshake. The Save Login ID checkbox remembers the account name only; the password is never written to settings. OPENSTORY_MACHINE_ID optionally supplies the legacy machine serial as hexadecimal and defaults to zero. Set OPENSTORY_DEBUG_NETWORK=1 to log connection stages and packet opcodes for diagnosis; packet contents are not logged. Set OPENSTORY_DEBUG_LOG=/path/to/file to keep those diagnostic lines in a file when launching through macOS Launch Services. Set OPENSTORY_BGM_VOLUME or OPENSTORY_SFX_VOLUME to a percentage from 0 to 100.

To package a native macOS app bundle, run scripts/package-macos.sh; it writes target/OpenStoryRS.app and signs the local bundle ad hoc for development.

The NX reader, fixed-step clock, logical viewport, foothold physics, bounded packet primitives, v83 Maple encryption, partial-frame decoder, and login, world-list, character-list, server-status, redirect, compact map-change, and movement-fragment parsers are in place. The client builds v83 MOVE_PLAYER snapshots and sends them when the local movement state changes. openstory-assets reads through a platform-neutral random-access source: native builds open NX archives lazily from files, and browser hosts can supply a memory-backed source after fetching or range-caching archive data. Browser fetch, persistence, and range-cache policy remain part of the future WASM adapter. After channel selection, the client loads map backgrounds, objects, tiles, and environments from the same NX archives, caches repeated art textures, and advances animated object and background frames using their NX delays. Scene images share bounded GPU atlas pages to reduce texture changes while preserving authored draw order. Background entries honor their parallax, tiling, and horizontal or vertical motion type; server obstacle packets toggle map environments. The v83 SET_TRACTION update also adjusts player friction on slippery fields. The v83 SHOW_COMBO packet updates the Aran combo counter overlay, including its three-second display after a reset. The first SET_FIELD transition uses the selected character's map and portal from the character list. The map scene shows the selected character's body, head, face, hair, and equipped items. Character selection shows a compact equipped-avatar preview beside each character row. Use Left/Right or A/D to walk; left or right Option jumps; Space talks to the nearest nearby NPC. Movement acceleration and jump force use equipped and buffed SPEED/JUMP with the legacy stat caps; hold Up or W to activate map portals. The avatar uses NX-authored one-handed or two-handed stand/walk frames and jump frames, including the legacy body arm and hand z layers. Press F1–F7 to play and broadcast the matching facial expression; NX-authored face frames animate locally and for other visible players. Press Backslash to open the key bindings panel. The client loads the v83 server key map, uses bound skills, items, and gameplay actions, and lets you rebind 40 supported built-in menu, gameplay, and face actions. It preserves unsupported saved actions so they remain visible and can be cleared. The Family shortcut uses the v83 action 26. The panel also lists learned active skills and usable inventory items by their localized names; stale skill/item bindings stay visible so they can be cleared. Click an action or press 1–8 to choose it, then press the replacement key; Backspace clears its binding and the mouse wheel scrolls the list. The panel shows the eight quick-slot keys supplied by the server; click a slot and press a key to rebind it. Local quick-slot edits use the legacy QuickSlotKeys setting and override the server's login-time layout. Skill macro editor opens from the Skills window. It edits the three server-backed macros, their shout setting, and ordered learned-skill slots; a bound macro key shouts its name when enabled and queues its skills through the normal skill-use path. The Quick Slots action opens the eight-slot bar above the HUD; it shows bound skill, item, cash, macro, and action icons with the configured key labels. Click a filled slot to run its binding, or drag a Use, Setup, or Cash inventory item onto a slot to update that key on the server. The minimap loads its map bitmap and portals from Map.nx, shows the player, NPCs, mobs, and other characters, and cycles through collapsed, normal, and expanded views. Town maps open expanded, and the max-size button is disabled at its limit. It can also open the World Map. Messenger handles server invitations, three v83 room slots, chat, invite/decline, and dragging the window. The server-requested World Map opens its NX-backed regional panel, shows the current-map marker, and lets you navigate regional links. The search field filters regional markers by map name, description, or ID as you type. It also searches the localized map catalog across regions, ranks exact and prefix name matches first, and shows a scrollable list of results. Selecting a result opens its regional map and highlights the matching marker; this is map browsing, not character travel. Hovered markers show their map details and optional NX route image. Automatic travel remains open work. The client sends v83 movement snapshots when position, prior position, foothold, or stance changes. Remote spawn, removal, movement, and look updates now drive visible characters using NX body, face, hair, and equipped item art, aligned through attachment points and ordered by equipment z layers, with name labels, stance-based facing, and smoothed server positions. NPC spawn, controller, and removal packets draw art from Npc.nx, including linked NPC definitions and animated stand, move, and say states selected by server NPC_ACTION packets. Mob spawn, controller, movement, and kill packets update map entities using Mob.nx stance art. Summon spawn, movement, stance, and removal packets load and animate stand/fly frames from Skill.nx, falling back to skill effect frames when needed; summons are ordered with map actors by depth. Non-stationary summons use shared foothold physics between server movement updates. Remote SKILL_EFFECT and skill-type SHOW_FOREIGN_EFFECT packets play NX-authored skill-use effects, update remote facing and attack stance, and use the legacy teleport effect for supported teleport skills. SHOW_FOREIGN_EFFECT level-up and monster-card events play their matching Effect.nx/BasicEff.img animations over the local or remote character. FIELD_EFFECT packets play the legacy map and screen animation paths from Map.nx, switch background music, or resolve field sounds through the Sound.nx category fallbacks. Server-driven Maple Guide appearances and messages now use the v83 tutorial.img text when present in the active UI archive, with the legacy hint-ID fallback when that archive contains only tutorial artwork. LOCK_UI and DISABLE_UI packets pause mouse-driven UI actions until the server unlocks them. Supported SHOW_ITEM_GAIN_INCHAT item-gain notifications now display the localized item name and signed quantity in blue chat, skill/buff echoes show their NX effect without duplicating a just-rendered local cast, and MonsterBook card notifications play the local card effect. The Monster Book window loads its cover and collected cards from the initial character state, then applies server card updates, with category filters, card details, name search, and a set-effect page that shows collected-card progress and set bonuses from the legacy client data. Monster details include NX-backed drop icons and stats; scroll over the drop grid to browse longer reward lists. Click the monster sprite to cycle through stand, move, and die animations; the client follows NX frame delays, opacity, and scale, and the die animation returns to stand when it finishes. DROP_LOOT and REMOVE_LOOT update map drops with item or meso icons from the existing NX archives. Drops animate while falling, float after landing, and fade or move to a looter when collected; meso icons animate from their NX frame data. Press Z near a drop to send PICKUP_ITEM. Reactor spawn, hit, and removal packets load art from Reactor.nx, place reactors on map footholds, and play their state-specific hit animations. Basic attacks send server-authoritative DAMAGE_REACTOR requests when a hittable reactor intersects the attack arc. Regular portals animate from MapHelper.img; hidden portals reveal their animation when approached. Hold Up or W in a portal to request a server map change; same-map portals move the player to their named destination after the legacy cooldown. Click an NPC to request dialogue, including NPCs whose scripts are supplied by the server. When an NPC has an available scripted quest but no regular NPC script, clicking it starts that quest's server-authored dialogue. The dialogue panel handles selection lists, yes/no and accept/decline prompts, text and number input, and page navigation. Its frame and standard controls use the NX UIWindow.img/UtilDlgEx artwork. Long dialogue pages scroll inside their panel with the mouse wheel or Page Up/Down. Press Space or click to reveal a line as it types; press Space again to advance or accept the current choice. On text-entry prompts, Space reveals the prompt first and then remains available for spaces in the answer; Enter submits it. Up/Down moves the selection highlight through long lists, which also scroll with the mouse wheel. Space submits number prompts. Outside dialogue, Space requests a conversation with the nearest NPC within legacy interaction range; both Option keys jump. When the server opens an NPC shop, its Buy and Sell views use NX item names and icons; sell rows show the legacy NX unit price and exclude items marked notSale or cash items using the correct item archive. Quantity controls send v83 buy/sell requests, rechargeable stock sends the recharge request, and inventory updates remain server-authoritative. The bottom HUD uses the stock v83 StatusBar.img background, gauge, and toolbar sprites, with live HP, MP, and EXP fills plus character level, name, job, and resource values. HP updates display a two-second bar, and positive HP deltas float the legacy blue healing digits from Effect.nx above the character. The native toolbar opens Status, Use/Equip inventory, Skills, key settings, quick slots, Cash Shop, Options, and a menu for quests, social panels, the Monster Book, and World Map. Its Trade button opens the /trade composer. Stun, freeze, and shadow-web hold mobs in their stand animation until the server cancels those statuses. DAMAGE_MONSTER packets float the legacy digits from Effect.nx above the mob with a 1.5-second rise and fade. Controlled mobs use the shared foothold physics and v83 MOVE_MONSTER updates, while remote movement remains server-authoritative. In a field, press Enter to open public chat, type a message, and press Enter to send; Escape closes the composer. Server chat broadcasts appear in a scrolling HUD panel, with GM messages highlighted. Server popup notices and Fake GM notices use the v83 login notice panel and can be dismissed with Enter, Escape, or its OK button. Visible speakers show four-second speech balloons drawn from the v83 ChatBalloon.img frame assets. While the composer is open, Tab cycles public, buddy, guild, alliance, and party chat. /w <character> <message> sends a whisper, /find <character> requests the player's channel, and /pt <message> sends directly to party chat. /party create, /party invite <character>, /party join <id>, /party accept, /party deny, /party leave, /party expel <character>, and /party leader <character> manage party membership; /party list toggles the party panel. Press O to show party members, channels, and server-reported HP.

When no dialog or panel is open, press Escape to open Options. The panel exposes graphics and effects quality, music and sound volume with mute controls, mouse speed, HP/MP warning thresholds, screen shake, windowed mode, 800×600/1024×768 resolution, and the v83 social permissions for whispers, messenger/party/guild/alliance/family invitations, buddy/guild/ alliance chat, trade and expedition requests, and follow requests. Drag a slider or use Tab and the arrow keys; Space toggles the selected checkbox. Save or Enter persists the settings and applies display changes, while Cancel or Escape restores the saved values. Incoming whispers, group chat, and the implemented party, guild, alliance, messenger, family, and trade request flows honor their corresponding setting. On Windows, mouse speed uses the legacy system pointer-speed mapping; other platforms follow the C++ no-op behavior. On macOS, settings are stored in ~/Library/Application Support/OpenStoryRS/settings.ini. The file also stores the Save Login ID choice and account name. Saving options preserves these values and removes any legacy saved-password entry. Missing social permission settings default to allow, matching the v83 client. Expedition and follow settings are saved for compatibility, though those request flows are not implemented yet. Mute choices are session-only, matching the C++ client. Missing or invalid music and sound effect volumes default to 50 percent. Incoming group chat, whisper delivery errors, and find replies appear in the colored HUD history. Incoming whispers also open a dedicated conversation window. Press H to start a new whisper, type a character name, press Tab to enter a message, and press Enter to send; /w <character> opens or switches conversations, while /w <character> <message> sends directly. Conversation histories and drafts are kept per character. Press B to show the scrollable buddy list; /buddy add <character>, /buddy group <character> <group name>, /buddy filter <group name> (or all), /buddy remove <character>, /buddy accept, and /buddy dismiss manage buddies; the list shows each buddy's server-assigned group. Re-adding an existing buddy is blocked locally so it cannot silently reset their group to Default Group. Dismissing hides the pending invite locally, matching the legacy client behavior. /trade <visible character> creates a v83 trade room and invites that player; use /trade accept or /trade decline for incoming invitations. In the trade room, press I and drag inventory stacks onto your offer grid, enter a quantity when prompted, set a meso offer, chat, and confirm or cancel. Server updates control both sides of the trade and the final result. The v83 under-level meso-trade restriction and Vicious Hammer/Vega Scroll result packets also show their legacy notices; report-result packets open a dismissible OK notice. Click a visible character to request their v83 character-info panel; Escape or its close button dismisses the panel. Its Party, Trade, and Guild buttons send the corresponding invites. The Raise Fame and Lower Fame buttons send v83 fame requests, enforce the level-15 requirement, show server rejection reasons, and update the open panel when the server confirms a change. Clicking a visible personal-shop owner opens their shop. Press G to open the scrollable guild roster and accept or decline pending guild invites with Y or N. When not in a guild, click Create Guild, enter a 3–12 letter name, and submit it to start the server's nearby-cofounder confirmation flow. Guild members can open the Ranks editor to change all five rank titles, or the Emblem editor to choose valid backgrounds, colors, and marks from UI.nx/GuildMark.img with a live asset preview. The Guild and Alliance windows also use the v83 UIWindow.img/UserList/Guild and GuildUnion panel art from UI.nx. /guild create <name> is the equivalent chat shortcut. When another player asks you to cofound, press Y/N to agree or decline. /guild invite <character>, /guild leave, /guild expel <member>, /guild rank <member> <1-5>, /guild ranks <r1>|<r2>|<r3>|<r4>|<r5>, /guild emblem <bg> <bg color> <logo> <logo color>, and /guild notice <text> send server-authoritative guild management requests. Press V to browse the guild bulletin board, write posts and notices, reply to threads, and delete selected posts. Press U for the alliance panel; /alliance invite <guild>, /alliance expel <guild>, /alliance leave, /alliance notice <text>, and /alliance ranks <r1>|<r2>|<r3>|<r4>|<r5> manage alliance settings. /alliance accept and /alliance deny answer invitations, and Y/N also works for pending alliance invitations. The panel uses server-sent alliance roster broadcasts and shows the local alliance ID while a roster is unavailable; rank-title and alliance-member updates are consumed from the server. Assign Family in the key bindings panel to open the server-backed family window and pedigree list. The panel shows reputation, motto and junior capacity; click the motto to edit it, invite a junior by name, use the selected family ability, or leave with confirmation. Click a family-tree row to view that member; Y/N answers incoming family-join and summon prompts. Press Left Control to send a one-hit regular attack; guild/family level-up and job-advancement broadcasts appear in yellow chat notices, spouse/fiance messages appear in red, and v83 ship departure, arrival, and transit status messages appear in yellow. The client uses the equipped weapon data, plays its NX stance, and targets the nearest mob ahead. Bow, crossbow, claw, and gun attacks select a compatible projectile stack, add any NX attack bonus it provides, use the v83 ranged packet and range, and animate the projectile. Remote ranged attacks also animate their server-reported projectile; the server owns ammo consumption. Incoming attack broadcasts animate remote characters with weapon-specific NX stances and show normal, critical, or miss feedback above mobs. DAMAGE_PLAYER packets show bounded damage/miss indicators and server-directed recoil above remote characters; LEFT_KNOCK_BACK applies the v83 leftward movement impulse to the local player. Body-attacking mobs use NX attack values and current-frame bounds to send v83 TAKE_DAMAGE; equipped WDEF and Achilles reduce contact damage, and local hits show damage/miss feedback with recoil. Reports are limited to one per 500 ms of continuous overlap while HP remains server-authoritative. Frozen, poisoned, and stunned mobs receive the legacy blue, green, and yellow tints. When the server authorizes a controlled mob skill, the client sends the action selected from the mob's ordered info/skill entries and plays its matching NX animation. SPAWN_MIST and REMOVE_MIST render and clear the legacy translucent poison, smoke-screen, and mob-skill area effects. NPC shops now show NX item names and icons, support buying, selling, rechargeable stock, and server transaction results. Perfect Pitch purchases show their item cost and available balance, and requests are blocked when the ETC inventory lacks enough. NPC storage uses a two-column, NX-backed item view with category tabs, item store/take actions, and meso transfers. Clicking a stack opens a quantity prompt for partial deposits and withdrawals; withdrawals retrieve the v83 stack and return the unselected remainder to storage after the inventory update. Inventory and storage contents remain server-authoritative. Press K to open a class-tabbed skill book built from Skill.nx and String.nx; learned levels update from server packets, skill points can be spent, active skills can be used, and attack skills use their NX damage type, scaling, hit count, and target count in the attack request path. Skill use checks the legacy job, weapon, HP, MP, and ammunition costs before sending a request; v83 ADD_COOLDOWN updates block casts until the server-provided cooldown expires. Inventory consumption remains server-authoritative. Attack target selection uses the skill level's NX hit rectangle and horizontal range multiplier for both mobs and reactors. Skill hit animations follow the NX character-level, skill-level, and weapon-hand variants and attach to each mob in the attack broadcast. Local casts also play the selected NX use effect and skill action, including level and weapon-hand variants. Projectile skills load their root or per-level ball frames from Skill.nx for local and remote attacks, and fly toward each reported target; ordinary ranged attacks continue to use the equipped ammo art. Teleport uses its learned NX range and stops at foothold walls or large floor changes; Flash Jump applies its aerial movement locally. Using a skill or mastery book now parses the v83 result and shows a success or failure message; learned skill levels still come from the server's skill update. Press J to open the available/active/completed quest log; its state comes from the initial character packet and server quest updates, while names, eligibility, and descriptions come from Quest.nx. The available tab can start quests and ready active quests can be turned in through v83 quest actions. Objective rows show held item counts and server-reported monster progress, and nearby NPCs show available, active, or ready markers. A quest with non-scripted selectable rewards displays an item chooser in its detail panel; use its arrows or Left/Right to pick the item, and the chosen v83 selection index is sent when turning in the quest. Quests marked with startscript or endscript use the corresponding scripted v83 action and the existing server-driven NPC dialogue. A quest must be explicitly confirmed before forfeiting it. Server quest-clear packets play the completion sound and NX light-pillar effect. Learned weapon mastery, Angel's Blessing, and Berserk contribute their NX values to local attacks. GIVE_BUFF and CANCEL_BUFF use bounded v83 mask decoding, retain timed statuses, and apply Maple Warrior, Weapon Attack, Accuracy, and Hyper Body HP/MP effects to local combat and HUD values. Booster combines with equipped weapon speed for local attacks and remote attack animations. Player ailments now show in the HUD; stun blocks movement and attacks, confusion reverses horizontal input, slow reduces movement acceleration, seal blocks skill use, and Darkness halves local attack accuracy. Poison HP changes remain server-driven. Other active-buff effects and combat mitigation, special projectile variants and skill damage formula cases, character-creation polish, birthday verification for character deletion, and most other game UI remain under development. Mob movement now uses server-reported attack and skill actions to play one-shot attack1–attack9 and skill1–skill9 animations when those frames exist in the mob assets. When the server grants a controlled mob a skill, the client sends its matching indexed action. Mob skill-effect visuals and expressions remain open. Music, UI, movement, portal, attack, mob, and skill-use sounds now play through the native audio mixer with world-distance attenuation and a 64 MiB least-recently-used cache; a browser audio backend remains future work.

Initial character entry now parses the legacy meso amount, inventory slot capacities, equipped items, equipment bag, and stack items. MODIFY_INVENTORY add, count, remove, and swap packets update that snapshot, including equip/unequip moves. INVENTORY_GROW updates the server-authoritative capacity and the inventory grid immediately; SET_EXTRA_PENDANT_SLOT records the pendant-slot entitlement and reports activation changes. Press I in the field to open a letterbox-scaled inventory with six category tabs, a scrollable four-column slot grid, cached NX icons, stack counts, meso, and slot capacity. Ordinary Use items send the legacy USE_ITEM request and play their one-shot Effect.nx/ItemEff.img animation when one exists; item consumption and effects on character stats remain server-authoritative. Pet food sends the v83 PET_FOOD request so the server feeds the hungriest summoned pet. Key-bound Use, Setup, and Cash items share the inventory activation path, including pet-food handling, chair sit/stand, and special cash actions. Activating a Cash pet sends the v83 SPAWN_PET toggle request. Pet spawn/removal and movement packets update map pets using their NX stance art and name labels; server pet-name changes refresh the visible label. Local pets follow with foothold physics and use the legacy pet AI cadence to send PET_LOOT requests for nearby drops. Server pet-chat packets display timed speech bubbles above the correct pet, while pet command packets play the NX success/failure interaction art, legacy alert/jump fallback, and matching pet sound category. PET_EXCEPTION_LIST packets consume the pet serial and excluded item IDs and report the server's exclusion count in yellow chat. Clicking an Equip item sends MOVE_ITEM to its legacy equipment slot, and clicking a worn item sends the unequip request to the first free Equip slot. Dragging between slots in the same bag sends a server-authoritative MOVE_ITEM; inventory updates confirm changes and rebuild the local avatar from NX art. Equipment scrolls can be selected from Use and applied to a chosen equipped slot. Equip actions check gender, job class, level, fame, and total stat requirements from Character.nx and the currently equipped gear before sending the move. The server's scroll-result packet plays the NX enchant success/failure animation on the affected character and reports the result in local chat. Dragging an item outside the inventory drops it; stack drops open a quantity prompt, cash items are blocked, and untradable items require confirmation. Hovering an occupied slot shows its String.nx name, description, required level, and NX equipment bonuses. Gather merges compatible stacks and closes gaps; Sort applies the v83 server ordering for the active bag. Supported cash megaphones, Maple TV, avatar megaphones, and pet name tags open the chat composer and send their v83 USE_CASH_ITEM payloads. Item megaphones accept an optional inventory attachment: enter a message, press Enter, click an inventory item, then press Enter to send. Click the selected item again to clear it, or press Enter on a blank line to send without an attachment. Press I to reopen the inventory while choosing an attachment. On megaphone types that support the whisper flag, Tab toggles it. Maple TV items with the legacy target control prompt for an optional recipient name (up to 12 characters). The composer accepts up to three triple-megaphone lines, five Maple TV lines, and four avatar-megaphone lines; an empty submission sends the lines already entered. Incoming v83 avatar-megaphones show the sender look and message in matching Map.nx banner art for ten seconds. A 514 store permit prompts for a shop name and sends the legacy personal-shop creation packet. A 523 Owl of Minerva opens a search panel with the server's popular items, item-name or ID search, paged shop listings, and a warp action. A 503 hired-merchant permit requests the server's deployment check, then prompts for a name and sends the merchant-room creation packet when approved. Hired merchants spawn from server map packets with their NX employee animation and sign, can be clicked to request a room visit, and update their descriptions and visitor counts from status packets. The room screen supports visitor purchases and chat, plus owner stocking from inventory, withdrawals, organization, meso collection, starting the store, maintenance exit, and store closure. Cash and tradeBlock items are rejected before listing and checked again before submission. Stocking posts one bundle containing the selected stack. Server-opened personal-shop rooms use the same resizable catalog and chat panel, with visitor purchases, owner stocking and withdrawals, sale notifications, and store start/exit actions. The client reads mini-room metadata from character spawn and update packets; clicking a visible personal-shop owner opens that shop. Other targeted cash actions and consumable-specific visuals remain open work. The v83 move request does not support partial stack moves within a bag, while drop and storage quantity prompts remain available. The legacy client rejects drags between inventory categories, so slot moves stay within the selected bag. Press P to open Pet Equipment, or use the Pets button in the inventory. It shows pet names, level and fullness alongside pet gear in the Equip inventory. Use a gear item while the intended pet is summoned; the server inventory update remains authoritative. Press C in the field to open Character Stats. Spend AP with the + buttons or use Auto to confirm allocation to the character's primary stat; each point is sent to the server and the panel waits for the authoritative stat update. Server FORCED_STAT_SET updates also apply to combat and movement totals, appear in the stats panel, and are cleared by the server's RECALCULATE_STATS packet. Press the grave accent key to enter the rebuilt Cash Shop. Its resizable catalog reads only on-sale products with a valid commodity SN from Etc.nx/Commodity.img; it supports search, category filters, item details and icon preview, currency balances, purchase confirmation, and the server-backed locker and withdrawal flow. Server responses show reason-specific notices for purchase failures and stock availability. The catalog's coupon field sends the legacy v83 coupon request and reports invalid, expired, used, and wrong-server responses. Resizing the window recomputes the logical pointer position so clicks stay aligned with the 1024×768 canvas.

To inspect a decoded field without connecting to a server, run OpenStoryRS --data-dir /path/to/wz --inspect-map 100000000. The renderer culls off-canvas sprites, supports atlas UV regions with per-sprite tint and opacity, and batches adjacent draws that share a texture. Runtime map-art pixels use a least-recently-used cache bounded to 128 MiB and 16,384 entries; decoded NX string bytes and bitmap pixels use separate bounded least-recently-used caches per archive. GPU textures are reused for the active scene. To inspect the stand, walk, and jump frames for a base appearance, run OpenStoryRS --data-dir /path/to/wz --inspect-avatar 0 20000 30000.

About

A full reimplementation of MapleStory v83 client in Rust. Targeting native MacOS, Windows, and WASM.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages