",
"headers": {
"x-nxopen-api-key": "YOUR_API_KEY"
},
"metadata": {
"usage": {
"initialization": "Standard MCP HTTP flow: (1) initialize request -> get mcp-session-id header, (2) send notifications/initialized with session-id, (3) call tools/list or tools/call",
"imageSearch": "For image similarity: download CDN image, base64 encode, pass to search_similar with image_data parameter",
"notes": [
"Session ID must be included in mcp-session-id header after initialization",
"notifications/initialized is required before tools can be called",
"Image files may not be available on server - use image_data with base64 for external images",
"search_similar with image_path may fail if files not in /mnt/efs/data - use CDN URL + base64 instead"
]
}
}
}
}
}
```
### Configuration Fields
* **type**: MCP connection method (http)
* **url**: The MCP endpoint provided by MSU Open API
* **x-nxopen-api-key**: Your MSU Builder API key
## 4. Usage
Once the MCP configuration is complete, Builders can search for resources using natural language queries in their AI tool. The following search types are supported:
* Keyword search — Finds resources by exact or partial name match
* Semantic search — Finds resources by meaning and context, even without an exact name
* Hybrid search — Combines keyword and semantic search for broader results
**Example queries**
* "Please find the red sword item"
* "Please search for cute chair images."
* "Show me the pink character sprite"
The AI tool will internally call the MCP and return matching results.
## 5. Available Features
Resource MCP provides the following features:
* Resource search
* Category lookup
* Tag lookup
* Image-based similarity search
* Sprite data lookup
* Category-based listing
* Image URL retrieval
## 6. Notes
### 6.1. MCP Is a Development Tool
* Resource MCP is intended for use during AI-assisted development workflows.
* It is not designed for production services or end-user-facing applications.
### 6.2. API Key Security
* Keep the API key secure and do not expose it publicly.
* Do not include the API key in source code repositories.
* If the key is compromised, reissue it immediately.
### 6.3. Result Accuracy
* Search results are returned based on keyword matching and similarity scoring.
* Results may not always match the intended output. For more accurate results, provide specific and detailed search conditions.
***
# MSU Resources Skill Guide
Source: https://docs.msu.io/msu-resources/msu-resource-skill-guide
## 1. What is MSU Resource Skill?
MSU Resource Skill is a standardized set of reference instructions and resources that helps AI agents find and use MapleStory Universe game resource assets when building Synergy Apps.
Once installed and connected to Resource MCP, Builders can ask their AI agent to discover and use in-game assets — including Monsters, NPCs, Items, Skills, and Backgrounds — using natural language, directly within their development environment.
MSU Resource Skill does not supply game resources directly. It works as a reference and support layer that connects your AI agent to the Resource MCP.
## 2. Prerequisites
Before installing MSU Resource Skill, make sure the following are in place:
* Node.js 18 or later
* git
* An MSU Builder API key — required for Resource MCP authentication
* A connected Resource MCP instance
## 3. Installation
Install MSU Resource Skill by running the following command:
```jsx theme={null}
npx skills add NEXPACE-Limited/msu-skills
```
## 4. Configuration
To use MSU Resource Skill, an MSU Builder API key and a connected Resource MCP instance are required.
* For API key issuance, refer to the Getting Started with [MSU Builder guide.](https://docs.msu.io/msu-builder/get-started)
* For Resource MCP configuration, refer to the [MSU Resource MCP Setup Guide](https://docs.msu.io/msu-resources/mcp-setup-guide).
## **5. Quick Start**
After installing MSU Resource Skill and connecting Resource MCP, ask your AI agent to use MapleStory Universe resources while building a game.
**Example prompts**
* "Please build a web view featuring three moving Orange Mushrooms."
* "Please write Phaser3 code for a MapleStory character walking across the screen, wearing Toben Hair, Defiant Face, Blue Cloth Pants, and a White Undershirt, and holding a Sword."
## 6. FAQ
### What is MSU Resource Skill?
MSU Resource Skill helps AI agents use MapleStory Universe resources when building games. It provides the agent with instructions and reference information for working with those resources.
### Which AI agents can I use?
Any AI agent that supports Skills and MCP can be used. For example, Claude Code and other compatible AI coding agents are supported.
### Do I need an API key?
Yes. Resource MCP requires an MSU Builder API key.
### Do I need to connect Resource MCP?
Yes. Resource MCP is required to use MSU Resource Skill.
### Can the AI agent make mistakes?
Yes. AI-generated outputs can be incomplete, outdated, or incorrect. Always review generated code, selected resources, and final outputs before publishing or sharing them.
**Important Notes**
* Resource Skills are provided solely as part of the infrastructure supporting the Open API made available by Nexpace, to help your AI agent discover and use MSU game resources when creating and operating Synergy Apps. They are a reference and support layer only: they do not themselves supply game resources, do not operate or control your AI, and do not generate any outputs. They are provided on an "as is" and "as available" basis and may be updated, limited, suspended, or discontinued at any time without notice or liability.
* Your use of Resource Skills is subject to the MSU API Terms and all other applicable Builder-related terms (including the Builder Terms and EULA), as well as all applicable laws and regulations. In the event of any conflict, the terms governing the Open API and the MSU API Terms shall prevail.
* Resource Skills rely on a valid MSU Builder API key and a connected Resource MCP. Your access may be limited, suspended, or terminated at any time — including if your API key is suspended or expired, you exceed applicable rate limits or quotas, or you violate any applicable terms — and Nexpace shall have no liability for any resulting interruption, loss, or damage.
* Resource Skills are provided for reference purposes only. Any outputs, recommendations, code, or actions are produced by your AI — a third party that Nexpace does not control — and may be inaccurate, incomplete, non-compliant, or infringing. You must independently review, test, and validate all such outputs and actions before relying on or executing them. You are solely responsible for ensuring that your Synergy App and its use of MSU game resources comply with all applicable terms and laws.
* You are solely responsible for securing your API key, MCP connection, and any related wallet or account access made available to your AI agent. Nexpace is not responsible for any loss, theft, unauthorized use, or compromise of such credentials or data.
* Resource Skills are owned by, or licensed to, Nexpace and are protected by applicable copyright laws, MapleStory Universe policies, and terms of use. You are granted only a limited, non-exclusive, non-transferable, revocable right to use Resource Skills for the creation and operation of Synergy Apps. You may not reverse engineer, decompile, extract, or otherwise derive the source or structure of Resource Skills, or distribute, resell, sublicense, or make them available to any third party without prior written approval from Nexpace.
* You may not use Resource Skills, or any MSU game resources accessed through them, to train, fine-tune, or develop any AI or machine-learning model, dataset, or service, or to create any product or service that competes with or substitutes for Resource Skills or the Open API.
* Resource Skills are provided without warranties of any kind, including accuracy, completeness, reliability, or fitness for a particular purpose. To the maximum extent permitted by applicable law, neither Nexpace nor its affiliates shall be liable for any direct, indirect, incidental, consequential, or other damages arising from your use of Resource Skills.
***
# MSU Resources Search Guide
Source: https://docs.msu.io/msu-resources/msu-resources-search-guide
## **1. What is MSU Resource Search?**
MSU Resource Search is a tool where you can browse, preview, and export game resource assets from MapleStory Universe. Using MSU Resource Search, you can search across tens of thousands of in-game assets — including Monsters, NPCs, Items, Skills, and Backgrounds — and preview their animations directly in the browser. Each resource can be exported as a spritesheet or accessed via CDN link for use in external projects.
MSU Resource Search is currently in Beta, and the asset library is continuously updated.
You can access it at [resource-search.msu.io](http://resource-search.msu.io).
## **2. MSU Resource Search Layout**
The MSU Resource Search interface is divided into three main areas:
* Search & Filter Panel (left): Contains the search bar, category filter tabs, and the resource result grid.
* Preview Panel (center): Displays the animation preview of the selected resource, along with its action tabs, sound information, and playback controls.
* Resource Detail Panel (right): Shows metadata for the selected resource, including type, category, display name, animation info, and tags.
## **3. Searching for Resources**
### 3.1. Search Bar
Enter a keyword in the search bar at the top of the page and click the Search button (or press Enter) to find resources by name. The result count will be displayed below the filter tabs.
To clear the current search, click the X icon inside the search bar.
### 3.2. Category Filter Tabs
You can filter results by resource category using the tabs below the search bar:
| **Tab** | **Description** |
| :--------- | :------------------------------------------------------- |
| All | Shows all resource types across every category |
| Monster | In-game monster characters (e.g., Snail, Blue Snail) |
| NPC | Non-player characters (e.g., Roger, Athena Pierce) |
| Item | Equippable and usable in-game items |
| Skill | Skill icons and animations (e.g., Blessing of the Fairy) |
| Background | Map background images with dimension info (e.g., 96×48) |
Multiple category tabs can be active at the same time. Click an already-selected tab to deselect it.
### 3.3. Resource Result Grid
Search results are displayed as cards in a scrollable grid. Each card shows:
* A category badge (e.g., Monster, NPC, Item, Skill, Background) in the top-left corner
* The resource thumbnail (animation preview image)
* The resource name below the thumbnail
* The asset ID with a copy icon in the bottom-left
* For Background resources, the image dimensions (e.g., 96×48) are displayed as an additional badge
* A Copy asset ID button (the icon in the bottom-right corner of each card) that copies the resource's asset ID to the clipboard
Click any card to select that resource and load it in the Preview Panel.
## 4. Previewing Resources
When you select a resource from the result grid, the Preview Panel in the center of the screen.
### 4.1. Resource Header
At the top of the Preview Panel, you can see:
* The resource name and asset ID badge (click the badge to copy the ID)
* The resource type (e.g., Animation) and category (e.g., Monster, Skill)
* The frame count (e.g., 16f)
* The CDN button and Export button on the right side
### 4.2. Action Tabs
Below the header, action tabs let you switch between different animation states for the selected resource. For example, a Monster resource may have the following action tabs:
* stand — Idle standing animation
* move — Walking or moving animation
* hit1 — Hit/damaged animation
* die1 — Death animation
Skill resources may have tabs such as icon, iconDisabled, and iconMouseOver. Click each tab to switch the animation playing in the preview canvas.
### 4.3. Sounds Panel
If the selected resource has associated sound effects, the Sounds panel appears in the top-left of the preview area. Each sound entry shows:
* The sound name (e.g., Damage, Die)
* A Play button to listen to the sound directly in the browser
* A CDN link button to open the audio file URL
* A Copy URL button to copy the audio CDN link to the clipboard
### 4.4. Animation Playback Controls
At the bottom of the preview canvas, you can control the animation playback:
* Play / Pause button — Toggle animation playback
* Speed controls — Set playback speed: 0.25x, 0.5x, 1x (default), 2x, 4x
* Frame selector — Click individual frame thumbnails at the bottom of the panel to jump to a specific frame. The current frame number and total frames (e.g., 3 / 5) are displayed.
### 4.5. Canvas Controls
In the top-right corner of the preview canvas:
* Fit to view — Resets the canvas to show the full animation in view
* Zoom in / Zoom out — Adjust the canvas zoom level
* Actual size — Resets zoom to 100%
The current zoom level is shown on the right (e.g., 200%). A ruler (in px) is displayed along the canvas edge for reference.
## 5. Resource Detail Panel
The Resource Detail Panel on the right side of the screen displays metadata for the currently selected resource.
### 5.1. Basic Info
| **Field** | **Description** |
| :-------- | :------------------------------------------------ |
| Type | The resource type (e.g., Animation) |
| Category | The resource category (e.g., Monster, Skill, NPC) |
| dname | The display name of the resource |
### 5.2. Animation Info
| **Field** | **Description** |
| :-------- | :------------------------------------------------------------ |
| Frames | Total number of animation frames |
| Actions | Total number of action states (e.g., stand, move, hit1, die1) |
### 5.3. Tags
Tags are displayed as badge chips (e.g., #bodyAttack, #tier:low). Tags can be used as reference for categorizing or filtering resources programmatically.
### 5.4. Expanding the Resource Detail Panel
Click the > icon at the top-right of the Resource Detail Panel to collapse it, giving the Preview Panel more horizontal space. Click again to restore it.
## 6. CDN — Copying the Resource CDN Link
Click the CDN button in the Preview Panel header to copy the CDN URL of the currently selected resource animation to the clipboard. The button briefly shows "Copied!" to confirm the action.
This CDN link points directly to the resource file hosted on MSU's static resource server and can be used to reference assets in external applications or projects.
## 7. Similar Resources
At the bottom of the Preview Panel, the Similar Resources section displays up to 11 visually or contextually related assets. Each entry shows the resource's category badge, thumbnail, name, and a similarity percentage score.
Click any item in the Similar Resources list to select it and load its details in the Preview Panel.
**Important Notes**
All assets available through MSU Resource Search — including monsters, NPCs, items, skills, backgrounds, sprites, animations, sound effects(where applicable), and associated metadata (collectively, the "Assets") — are the intellectual property of Nexpace Limited and/or its affiliates and licensors and are protected by copyright, trademark, and other applicable laws. All rights are reserved.
* **Eligibility and permitted use:** Subject to your compliance with this notice and the terms referenced below, Nexpace grants you a non-exclusive, revocable, non-transferable, non-sublicensable license to download, copy, and use the Assets solely for the purpose of developing, prototyping, and creating Synergy Apps (as defined in the MSU Builder Terms) within the MapleStory Universe ecosystem, including the right to incorporate the Assets into such Synergy Apps. To publish, operate, distribute, or otherwise make a Synergy App incorporating any Asset publicly available, you must be a registered Builder and remain in compliance with the MSU Builder Terms.
* **Conditions and limits.** This license does not permit you to: (a) use the Assets in any product, service, or project that is not a Synergy App within the MapleStory Universe ecosystem; (b) redistribute, re-host, sell, rent, sublicense, or otherwise make the Assets - or any CDN link, URL, or other means of accessing the Assets- available to third parties as standalone files asset libraries, or otherwise outside of your Synergy App; (c) claim ownership of the Assets or remove or alter any ownership, attribution, or proprietary notices; (d) use the Assets in any unlawful, infringing, or brand-damaging manner; or (e) use the Assets, in whole or in part, to train, fine-tune, or develop any machine learning or artificial intelligence model, or to derive, extract or infer any underlying data, source materials, asset taxonomy, or trade secrets. Any use outside the scope of the permitted use above requires the prior written permission of the rights holder. The Assets may embody trademarks of Nexpace, its affiliates or its licensors, or third parties, and no right to use any such trademark as a source identifier
* **Incorporated terms.** Your access to and use of the Assets is also governed by the asset-use and intellectual-property provisions of the MSU Terms of Service, the MSU Builder Terms, the MSU OpenAPI Terms, and any other applicable MSU terms and legal policies, regardless of whether you are a registered builder. Those terms and policies are incorporated into this notice by reference and are available at [MSU Legal Documents](https://msu.io/policy/). By accessing, previewing, exporting, downloading, or copying a CDN link to any Asset, you acknowledge that you have read and agree to this notice and those terms. If you do not agree, do not access, download or use the Assets.
* **Termination and deletion**. Your license under this notice is revocable at any time. Upon revocation, termination of your access, rejection or removal of your Synergy App, or upon our request, you must promptly cease all use of and permanently delete all downloaded copies of the Assets in your possession or control, other than Assets already lawfully incorporated into a Synergy App that remains in good standing under the MSU Builder Terms.
This is a provisional notice pending publication of formal Terms of Service for MSU Resource Search. Once formal Terms are published, they will govern your use of the service and the Assets, and continued use will constitute acceptance of those Terms. MSU Resource Search is in Beta and provided "as is"; Assets, features, and access may change or be revoked at any time.
Inquiries: [contact\_builder@nexpace.io](mailto:contact_builder@nexpace.io)
[\[View all MSU legal policies\]](https://msu.io/policy/terms_of_use)
***
# MSU Explorer
Source: https://docs.msu.io/msu-services/msu-explorer
## **1. What is MSU Explorer?**
MSU Explorer is a platform where Maplers can view all on-chain data related to Henesys L1, the mainnet of MapleStory Universe.
MSU Explorer is officially supported by CrossAngle that provides various crypto asset-related services through Xangle. MSU Explorer therefore operates under CrossAngle Terms of Service, separate from those of MapleStory Universe.
For more details, please refer to the bottom-left section of MSU Explorer website.
\[[Go to Terms of Service](https://msu-testnet-explorer.xangle.io/term-of-service)]
Additionally, important usage notices that Maplers must follow while using MSU Explorer are provided in the form of a Disclaimer, located to the right of the Terms of Service link.
## **2. MSU Explorer Main Dashboard**
On MSU Explorer’s main page, Maplers can view the latest information on Henesys L1 at a glance.
### **2.1. Search Bar**
Maplers can search for detailed blockchain data by entering one of the following into the search bar:
* **Transaction Hash Value:** View details of the transaction, the related block, and associated logs.
* **Block Number:** Check block data, including all transactions and internal transactions.
* **Wallet Address:** View all related transactions, internal transactions, and token data (ERC-20, ERC-721, ERC-1155).
* Token: Check details about a specific token.
* **NFT:** View information about a particular NFT.
### **2.2. Main Dashboard**
Please note that the image shows test environment and may not reflect the live data.
On the main dashboard, Maplers can view:
| Metric | Description |
| :------------------------- | :------------------------------------------------------ |
| **Average Block Created** | Average block time in the last hour |
| **Daily Transaction** | Average number of transactions in the past 3 days |
| **Daily Account Created** | Average number of accounts created over the past 3 days |
| **Gas Price** | Gas price of the most recent transaction |
| **Base Fee** | Average block base fee over the past hour |
| **Gas Used** | Average gas used per block over the past hour |
| **Internal Transactions** | Total number of internal transactions on Henesys L1 |
| **New Accounts Created** | Number of accounts created over the last 30 days |
| **Daily Gas Fees** | Total gas fees paid on blocks over the last 24 hours |
| **ERC-20 Token Transfer** | Total number of ERC-20 token transfers on Henesys L1 |
| **ERC-721 Token Transfer** | Total number of ERC-721 token transfers on Henesys L1 |
Additionally, at the bottom of the main dashboard, Maplers can view the 10 most recent blocks and the 10 most recent transactions.
Clicking on each entry allows Maplers to view its detailed information:
* **Latest Blocks**: Displays the 10 most recent blocks, including gas used, number of transactions, and block rewards
* **Latest Transactions**: Displays the 10 most recent transactions, including transaction hash, amount of NXPC transferred, sender wallet address, and recipient wallet address
## **3. MSU Explorer Navigation Tabs**
Please note that the image shows test environment and may not reflect the live data.
On the left side of MSU Explorer web interface, Maplers can navigate using various functional tabs that provide detailed on-chain data about MapleStory Universe.
1. **Home**: Navigates to the main homepage of MSU Explorer
2. **Blockchain:** Provides access to core blockchain data across four sub-tabs
1. **Transactions**: View all transactions on Henesys L1 in reverse chronological order
2. **Internal Transactions:** View all internal transactions executed via smart contracts, listed by latest first
3. **Blocks:** Explore all blocks on Henesys L1 starting from the most recently generated
4. **Deployed Contracts:** View smart contracts deployed on Henesys L1
3. **Tokens**: Displays information about supported tokens on Henesys L1
1. **All Tokens #1**: Native governance token of MapleStory Universe – NXPC
2. **All Tokens #2:** In-game utility token – NESO
3. **Token Transfers**: Lists all token transfers on Henesys L1 in reverse chronological order
4. **NFTs**: Offers complete visibility into NFT-related activity across three sub-tabs
1. **All NFTs & Transfers:** View all NFT types on Henesys L1 and their transfer history
2. **NFT Trades**: Review all NFT trades that have occurred via the MSU Marketplace
3. **NFT Mints**: Track all NFT minting events from within MapleStory N
5. **Accounts**: Lists all accounts connected to MapleStory Universe, ordered by NXPC token balance in descending order
6. **Analytics**: Visualize Henesys L1 network and token trends through four categories
1. **User**: Charts the trend of Unique Active Wallets connected to MapleStory Universe
2. **Network**: Shows historical data on the number of transactions over time
3. **Token:** Displays holder trends for NESO, NXPC, and NFTs
4. **Marketplace:** Tracks the number of unique accounts actively trading on the MSU Marketplace
***
# MSU Marketplace
Source: https://docs.msu.io/msu-services/msu-marketplace
## **1. What is MSU Marketplace?**
MSU Marketplace is a platform where Maplers can buy or sell NFT items, characters, FT items, and nicknames to enhance their gameplay experience.
**MSU Marketplace is composed of the following sections:**
1. **Main Screen:** Overview of in-game item listings and the trading status of the MSU Marketplace.
2. **Tabs for Purchases:** Use the “NFT Items”, “Characters”, and “FT Items”, and “Nicknames” tabs to browse available items.
3. **Bid:** Submit a price proposal if your desired item is unavailable or listed at an undesired price.
4. **Search Bar:** Quick search for specific items by keyword.
5. **Inventory:** View and manage your in-game items, including those you own, have listed, bookmarked, or made/received offers on. You can also view your trading history here.
### **1.1. Main Screen**
On the Main Screen, you can check the overall activity status of the MSU Marketplace through the following data:
* **Total Listings:** Cumulative number of all items ever listed on the marketplace
* **Total Active Wallets:** Cumulative number of wallets that have accessed services in the MapleStory Universe
* **Total Sales:** Total number of transactions made
* **Total Trading Volume:** Cumulative transaction volume in NESO
Scroll down to see highlighted rankings:
* **Record-breaking Sales:** Top 3 in-game items sold for the highest prices.
* **Recent Sales:** The 20 most recently listed NFT items
* **Recent Listings:** The 20 most recently added items
* **Top Traders:** Maplers ranked by trading volume
### **1.2. Tabs for Purchases**
In the “NFT Items”, “Characters”, “FT Items”, and “Nicknames” tabs, you can buy and sell NFT items, characters, and FT items respectively.
For more details about how to buy these items, please refer to the “How to purchase on the Marketplace” section.
### **1.3 Bid**
In the “Bid” section, you can propose your desired price and quantity for specific NFT items. If a seller accepts, the transaction is made. This reverses the usual listing format; you propose the deal, and a seller may choose to accept it.
Only in-game NFT items are supported in the “Bid” section.
### **1.4 Search Bar**
Use the search bar at the top of the page to quickly search items.
### **1.5. Inventory**
In “Inventory”, you can manage items held in your Wallet Inventory. It includes:
* **Owned:** Items you currently hold.
* **On Sale:** Items you have listed for sale
* **Bookmark:** Items you’ve bookmarked
* **Activity:** Your transaction history
* **Offers:** Offers you’ve made or received
MVP Bronze rank or higher is required to use the MSU Marketplace. Unranked users can only browse, bookmark, and purchase characters
## **2. How to bring your assets to the Marketplace**
To bring in-game items, characters, and nicknames obtained in-game into the MSU Marketplace, follow the steps below:
### **2.1. Items**
1. **Minting**
* Mint the item obtained in-game.
2. **Moving to Wallet Inventory**
* Drag or double-click the minted item to transfer it from your character inventory to your Wallet Inventory.
3. **Checking in Inventory**
* Visit the MSU Marketplace and find the item listed in your “Inventory” tab.
* Only items marked with “m” in the bottom right corner are mintable. Items marked with an “L” cannot be minted.
### **2.2 Characters**
Characters can only be listed if they are unlinked from MapleStory N.
* If the character you want to sell is linked, unlink it first via the character selection screen.
* Then, go to the “Owned” tab in your Inventory to confirm it is ready for sale.
### **2.3. Nicknames**
* Selling an off-chain nickname: To sell a standard (off-chain) character nickname, you must first convert it into an on-chain NFT. You can do this by changing your character's name in-game; the old name will be minted as an NFT and sent to your wallet, ready for sale.
* Selling an on-chain nickname: If your character is already using an on-chain nickname NFT and you wish to sell it, simply change your character's name to something else. The previously equipped nickname NFT will be unequipped and returned to your wallet.
* For more details, please refer to the \[[Nickname NFT Guide](https://docs.maplestoryn.io/msn-101/beginners-guide/item-and-equipment/nickname-nft)]
## **3. How to purchase on the Marketplace**
To buy NFT items, characters, FT items, or nicknames:
* Use the search bar or browse through the “NFT Items”, “Characters”, “FT Items, or “Nicknames”” pages.
- You cannot make a purchase if your NESO balance is insufficient or if the item price is below the minimum trade amount (0.000001 NESO).
- Listing items is free, but transaction fees are automatically deducted from the sale amount upon purchase or offer acceptance.
You can check the transaction fee during the listing or offer process.
### **3.1. NFT Items**
On the “NFT Items” page, you can use filters to narrow down your search:
* **Price range:** Set minimum and maximum price.
* **Unique Number:** The sequential number assigned upon minting, indicating the order in which the item was minted in MapleStory Universe.
* **Item Type:** Filter by All, Weapon, Armor, Decoration, Utility, or Set-up.
* If you select “All”, “Weapon” or “Armor”, additional filters are available:
* **Class:** Warrior, Magician, Bowman, Thief, Pirate
* **Potential/Bonus Potential Rank:** The ranking of potential and bonus potential for the item, ranging from No Potential to Legendary.
* **Level Range:** The range of levels at which the item can be equipped
* **Star Force:** The Star Force level of the item
* For “Weapon” and “Armor”, you can apply “Advanced Search”:
* **History:** Enter a character name to view item achievement history that is associated with that character
* **Advanced Search:** Filter by up to 5 potential stats, bonus potential stats, and basic stats to refine your search
After setting the filters, use the “Save Filter” button under the “Search” button to save your settings for future use.
You can easily reapply saved filters whenever you want to search with the same criteria.
When you click an item from the equipment item list, the item detail page shows:
* **Item image** and **equip preview** (login required to preview equipped look)
* **Item price**
* **Item sale end time** and **time remaining** until sale ends
* **Seller's username** (Clicking the username will take you to that user's inventory page)
* **Item name** and **category**
* **Item equip requirements**
* **Item details**
* **Transaction history** (Use the dropdown menu to view the trade history of the selected item and of identical items)
On the left side of the item page, you can click “Details” section to open the Navigator for more information.
### **3.2. Characters**
On the “Characters” page, you can refine results with the following filters:
* **Price Range:** Set minimum and maximum price
* **Class:** Warrior, Magician, Bowman, Thief, Pirate
* **Level Range:** Specify the level range of the character
* **Combat Power**
Selecting a character opens a detail page that shows:
* **Character Profile Image**
* **Character price**
* **Sale End Time** and **Time Remaining** Until Sale Ends
* **Seller’s Username** (Clicking the username redirects you to the seller’s Inventory Page)
* **Character Name**
* **Basic Info:** Level, Job, Fame, etc.
* **Detailed Stat Information**
* **Equipped Items**
* **Price Offer Information**
* **Recent Activity History**
On the left side of the page, you can click the “Details” section and access the Navigator for more info.
### **3.3. FT Items**
On the “FT Items” page, the list on the left shows consumable items currently available for purchase.
Clicking an item reveals:
* **Available Listings:** Current ask prices
* **Trade History:** Past transaction records
* **Price History:** Daily highest, lowest, and average prices
* **My Listings:** FT items you have listed for sale. Use the dropdown at the top-right of the “My Listings” section to view bid listings for selected or all items.
※ Only sellers can propose prices. Buyers input a quantity, and the system auto-matches it to the lowest price available and compete the purchase.
* Only sellers can propose prices. Buyers input a quantity, and the system auto-matches it to the lowest price available and compete the purchase.
* From “Activity History”, you can select either a 7-day or 30-day period to view the average daily activity price.
* Hover over the price graph to see the highest, lowest, average prices, along with the trading volumes for that day.
#### **3.3.1. Important Notes on FT Item Pricing & Purchase Quantity:**
* When purchasing FT items, the system automatically buys from the lowest-priced listings in order, including gas fees.
* The estimated price updates every 5 seconds, so the lowest price may change after each update.
* A single purchase can involve up to 5 sellers only.
* Example: If 10 sellers each list 1 Power Elixir, and you input a quantity of 10, the system will automatically adjust your purchase to a maximum of 5, drawing from 5 sellers only. To purchase more, you will need to place a new order.
* FT items are listed for 7 days. Unsold items will be automatically delisted when the listing expires.
### **3.4. Nicknames**
The Nicknames page makes it easy to find the perfect name using a set of powerful filters. You can narrow down the listings by:
* **Price Range**: Set a minimum and maximum price for the nickname
* **Length**: Filter by the number of characters in the nickname (from 4 to 12)
* **Composition**: Choose the character type of the nickname (Alphabet Only, Numeric Only, or Mixed)
Clicking on any nickname in the results will open its dedicated detail page. Here you'll find everything you need to know:
* **Nickname Image**
* **Price**
* **Sale End Time**: The exact date and time the listing expires, along with the remaining time
* **Seller's Username:** Clicking the username will take you to that user's Inventory page
* **Nickname**
* **Length and Composition**: Information about the nickname's character count and type.
* **Transaction History**
* **Offer Information**: Details about any offers made on the nickname.
For even more information, access the Navigator via the "Details" section on the left.
### **3.5. Items Unavailable for Trade**
Some items cannot be traded on the MSU Marketplace:
* Items marked with "L" displayed on the bottom right cannot be minted or moved to Wallet Inventory
* Items labeled "Currently in Use" are in use in MapleStory N and cannot be traded or offered
* Items labeled "Discarded" are discarded in-game items and cannot be traded
* Items labeled “Burned” are burned on-chain and cannot be traded.
* If the wallet holding an item is not linked to MapleStory Universe, the item will display a wallet address instead of a username
* Items marked with an “S” icon are Soulbound Tokens(SBTs) and cannot be traded
### **3.6. Using the Offer Feature**
You can use “Offer” to negotiate the purchase price for NFT items.
**3.6.1. How to Make an Offer**
1. Hover over an item and click the “Offer” button or go to the item detail page and click “Offers.”
2. Enter your desired price in the popup window and click “Make an Offer”.\
A minimum offer of 1,000,000 NESO is required. Offers below this amount cannot be submitted.
**To view your offer activity**
* Go to “Inventory” > “Offers” > “Offers Sent” to see the items, characters, or nicknames you have made offers on.
* Go to “Inventory” > “Offers” > “Offers Received” to see offers made on your listed items, characters, or nicknames.
**3.6.2 Offer Policy Notes**
* Only the top 5 highest offers are visible to the seller. If multiple offers are made at the same price, the one submitted earlier will be shown first
* When an offer from the top 5 expires, is accepted, or is canceled, the next highest offer will appear
* If your offer is not visible, it is either not in the top 5 or was submitted later at the same price
* To change an offer already made on an item, cancel the previous one and submit a new offer
* If there is an item you really want to purchase, check the “Offers” list on the item detail page and make a competitive offer
* If your NESO balance drops below your offer amount, your offer will be automatically canceled
* If you’ve made an offer on an item you wish to purchase, be sure to manage your NESO balance accordingly
* Notifications will be sent when your offer is accepted or canceled
* You will also receive a notification if your listed item receives the top offer
## **4. What is Bid?**
Unlike the “NFT Items”, “Characters”, and “FT Items” tabs, the **“Bid"** section allows Maplers to propose their desired price and quantity for an item, regardless of its stats. Sellers may then choose to fulfill the bid.
* Only price and quantity can be selected when using the Bid system. If you want to purchase an item with specific stats, use the “NFT Items” tab instead.
* In the “Bid” tab, buyers can register the items they wish to purchase, and sellers can search for items they wish to sell using the search bar.
* Not all items are available for Bid transactions. Only selected items may be traded through the Bid system.
### **4.1. How to Place a Bid**
If there is an item you want to buy, follow these steps:
1. Enter the quantity and unit price of the item you would like to buy into the **“Place Bid”** field. \\
2. Click the “Order” button and check your bid in the list on the left side of the page.
3. If another Mapler accepts your bid, the transaction is completed immediately. You can view the result in the “Trade History” section or in “Inventory” > “Activity”.
4. Use the dropdown at the top-right of the “My Order” section to view all of your registered bids.
* A minimum bid of 1,000,000 NESO is required. Bids below this amount cannot be placed.
* Bid orders are valid indefinitely unless canceled in “My Order.”
* Bid history can only be viewed during the active bid period.
* The total bid amount (including Offers) cannot exceed your NESO balance.
### **4.2. How to Sell to a Bid**
You can search the bid list for your desired price and proceed to sell an item.
* Only one item may be sold at a time
* Sales can only be completed if there is a matching buy order at the exact price.
* Refresh the page to check the latest bid matches and order status.
If you want to sell an item, follow these steps:
1. Input the price you wish to sell at from the bid list and click “Sell”.
2. Select the item you want to sell from the list.
3. Once selected, proceed with the sale.
Once a sale is initiated, it cannot be retracted. If you have multiple identical items, make sure to double-check the item’s status before selling.
**Would you like to save items for later?**
Click the “💚” button at the top of the item card in the left-hand item list to bookmark them. You can manage bookmarked items in a dedicated tab.
### **4.3. Bid Cancellation Conditions**
If NESO is used for other purchases outside the “Bid” tab, (e.g., to purchase items) and your NESO balance falls short of your active bid, any bid that exceeds the balance will be automatically canceled.
* In this case, the entire bid is canceled, not just the portion that exceeds the balance.
* If there are multiple bids at the same price, the most recently submitted bid is canceled first.
## **5. Using Inventory Tab**
### **5.1. What is the “Owned” tab in Inventory?**
In the “Owned” tab, you can view the list of items you currently hold in your Wallet Inventory.
* Items must be transferred from your character inventory to Wallet Inventory to appear here.
* Items purchased on the MSU Marketplace are also stored in the Wallet Inventory. If you wish to equip them, move them to your character inventory.
* For more details, please refer to the \[[Nickname NFT Guide](https://docs.maplestoryn.io/msn-101/beginners-guide/item-and-equipment/nickname-nft)]
#### **5.1.1. Item Transfer**
You can directly transfer items or nicknames you own to another Mapler without listing them for sale. In the “Owned” tab, you will find a three-dot icon at the top-left corner of each asset’s image.
Click the three-dot icon at the top-left corner of the asset’s image to access available functions.
**\[Available functions]**
* Sell
* Cancel Sale
* Copy Link
* Transfer
Click “Transfer”, input the recipient’s wallet address, and proceed with the transfer.
* Double-check the quantity for FT item transfers.
* Always verify the recipient’s wallet address before confirming.
* Only minted characters can store and retrieve items from Wallet Inventory.
* Only nicknames that are not currently equipped by a character can be transferred.
* Double-check the quantity for FT item transfers.
* Always verify the recipient’s wallet address before confirming.
* Only minted characters can store and retrieve items from Wallet Inventory.
* Only nicknames that are not currently equipped by a character can be transferred.
### **5.2. What is the “On Sale” tab in Inventory?**
In the “On Sale” tab, you can view and manage items or nicknames you’ve listed for sale on the MSU Marketplace.
* To list an item, character, FT item, or nickname for sale, go to the “Owned” tab, click on it, and proceed to its detailed page.
* Once listed, the item will appear in the “On Sale” tab.
Here’s what you check in this tab:
* Track listings with less than 24 hours remaining on their sale period
* Review the current sale price of your listed items, characters, and nicknames at any time
* Check the current lowest sale price for your listed FT items
* Cancel any of your active listings
* Notification alerts when one of your assets is sold to another Mapler
**5.2.1. Notes on Selling FT Items**
* Unit prices may slightly change accordingly to the “Bid Unit Policy”.
* Minimum sale quantity requirements may apply per item
* If another Mapler is in the process of buying your listed item or it is sold just before you attempt to cancel, the cancellation may not go through.
- Items marked with an "L" in the bottom-right corner are bound to characters and cannot be minted or sold on the MSU Marketplace.
- If an item has already been transferred to another wallet, you will receive a “Cannot Sell” message.
### **5.3. What is the “Bookmark” tab in Inventory?**
Bookmark is a feature that allows you to save NFT items, characters, FT items, or nicknames you’re interested in purchasing.
* After bookmarking items, view the list in “Inventory” > “Bookmark”
* To remove a bookmarked item/character/nickname, you must manually unbookmark it.
* Even if the item/character/nickname is sold, it will remain bookmarked until removed.
### **5.4. What is the “Activity” tab in Inventory?**
The “Activity” tab shows your transaction history for NFT items, characters, FT items, and nicknames.
* You can also view transaction history via MetaMask browser extension under the “Portfolio” function.
* Additionally, transactions can be checked in the \[[MSU Explorer](https://msu-explorer.xangle.io/)]
### **5.5. What is the Offers tab in Inventory?**
In the Offers tab, you can view offers you've made on MSU Marketplace items as well as offers received on items you've listed for sale.
* The “Received” tab displays the top 5 highest offers made on your listed items.
* This list updates when offers are canceled, accepted, or expired.
* The “Sent” tab shows a complete list of all offers you’ve submitted so far.
***
# MSU Navigator
Source: https://docs.msu.io/msu-services/msu-navigator
## **1. What is MSU Navigator?**
MSU Navigator is a hub where Maplers can search and view all on-chain and off-chain items, characters, nicknames, and user information within the MapleStory Universe.
In MSU Navigator, you can view not only your own information but also the character, nickname, and item details of other users.
* **Character Information**
* Link/Unlink status
* Minted / Mintable status
* **Item Information**
* All items in the wallet inventory (including SBT local copies)
* Minted items in character inventory
* Mintable items in character inventory
* NFT items registered in the NFT Collection
* **Nickname Information**
* All nicknames present in the wallet inventory
- Local items obtained through field hunting in MapleStory N cannot be searched or viewed in MSU Navigator.
- SBT items granted as rewards cannot be searched in the MSU Navigator or viewed on the main dashboard. However, they can be checked in the Owned Items list.
## **2. MSU Navigator Main Dashboard**
On the main dashboard of MSU Navigator, you can view the overall status of all on-chain and off-chain items.
### **2.1. Top Menu**
* **Search Bar:** Enter item name, character name (nickname), or username to search for relevant information.
* **My Page:** Directs you to your Owner Detail Page, where you can view all items, characters, and nicknames held in your wallet.
* For more details, please refer to **\[Section 4: My Page].**
### **2.2. Main Dashboard Overview**
Under the Info tab, the following metrics are displayed:
**2.2.1. Info Tab**
* **Unique Active Wallets:** Number of accounts that have logged into any MSU service at least once
* Transactions: Total on-chain transactions across MapleStory Universe services
* MSU Marketplace Volume: Cumulative trading volume to date
**2.2.2. Highest Price Equipment Items**
You can view the **top** **5 highest-priced equipment items**.
* The ranking period can be selected from **7 Days, 30 Days,** or **All**.
* For each equipment item, you can view its image, name, unique ID, NESO price, and USD equivalent.
* Clicking an item will redirect you to its **detail page**.
For more information on the detail page, please refer to **\[Section 3: MSU Navigator Search Function]**.
**2.2.3. Highest Price Decoration Items**
You can view the **top 5 highest-priced decoration items**.
* The ranking period can be selected from **7 Days, 30 Days,** or **All**.
* For each decoration item, you can view its image, name, unique ID, NESO price, and USD equivalent.
* Clicking an item will redirect you to its **detail page**.
For more information on the detail page, please refer to **\[Section 3: MSU Navigator Search Function]**.
**2.2.4. Character Rankings**
You can view the **top** **5 highest-level characters**.
* For each character, you can view its ranking, name, job, and level.
* To view rankings beyond the Top 5, click the “View All” button in the Character Rankings section to be directed to **\[MapleStory N Web > Rankings]** page.
* Clicking on a character will redirect you to their **detail page**.
For more information on the detail page, please refer to **\[Section 3: MSU Navigator Search Function]**.
## **3. MSU Navigator Search Function**
There are two search bars on MSU Navigator main dashboard. Both search bars serve the same function.
You can enter an item name, character name (nickname), specific item info (item name + unique ID), or username to search for the information you wish to view.
### **3.1. Important Notes When Searching**
1. **Popular Searches:** View the most-viewed item names, specific items, and character names (nicknames) from the past 7 days by clicking the search bar. Use this to discover which items and characters are currently trending among users.
2. **Autocomplete:** Enter two or more characters into the search bar. A list of autocomplete suggestions will appear, and selecting a suggestion will immediately trigger a search, allowing you to find what you’re looking for without typing the full name.
Autocomplete is supported only for item names and is not available for character names or nicknames.
3. Item Type vs. Specific Item: A specific item refers to an item that includes its unique ID and represents an individual instance owned by a user. (***Example:*** Among many Dominator Pendants, Dominator Pendant#1 owned by User A is a specific item)
1. To search by item type: enter only the item name.
2. To search by specific item: enter both the item name and its unique ID.
* You must enter at least 2 characters to search.
* You much enter the exact item or character name. Partial matches or typos will not return results.
### **3.2. Item Name Search - NFT**
Searching by NFT item name (without the unique ID) will direct you to its detail page, where you can view:
**Item Details**
| Category | Details |
| :----------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Item Info** | - Item image
- Item name
- Item Type
- Requirements for equipping
|
| **Item Circulation and Trading Volume Overview** | - Circulating Supply: The amount of items that are circulating in the market and are tradable by the public.
- Max Supply: Maximum Supply of the Item
- 24h volume(NESO)
|
| **Play Rewards** | - Display of the in-game reward allocation and remaining unclaimed (yet to be farmed) quantity using a bar graph
|
For NFT items, you can also view the following additional information:
**1. Dynamic Pricing Formula chart** (for enhancement-eligible equipment only):
* This chart displays price fluctuations caused by Dynamic Pricing.
* You can check the cost of enhancement, the number of enhancements, and other related data for each enhancement level.
* It also allows you to select and view specific enhancement levels and time periods for detailed analysis.
**2. Trade Information:**
* You can view the full trade history of the searched item in chronological order.
* Each record shows the price, buyer and seller usernames, wallet addresses, and the date and time of the transaction.
If no trade history exists for the item, a message stating “No trade history available.” will be shown.
#### **3.2.1. Top Button Functions**
When viewing an item’s detail page, the following common buttons are available at the top:
| **Category** | **Button Image** | **Description** |
| -------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Marketplace** | | - pens the MSU Marketplace in a new tab and shows current listings for the item.
|
| **Add to Watchlist** | | - Adds the item to your Watchlist so you can track it over time.
|
| **Share** | | - Opens sharing options:
- **Copy Link** – Copies the current page’s URL
- **Share on X** – Shares the item on X (formerly Twitter)
- **Share on Facebook** – Shares the item on Facebook
|
| **Explorer** | | Opens MSU Explorer in a new tab, where you can view detailed information about the associated wallet address. (Only available when searching by username) |
* The “Explorer” button is only available when searching by username.
* The “Add to Watchlist” button is not available for FT items.
* The “Marketplace” button is not available for Character NFTs.
### **3.3. Specific Item Search - NFT**
Searching by NFT item name along with its unique ID takes you to that item’s detail page, where you can view the following information:
**Item Details**
| Category | Details |
| :---------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Item Info** | - Owner’s Username
- Item Image & Mintable Status (mintable / minted)
- Item Name + Unique ID
- Item Type
|
| \*\*Item Circulation and Trading Volume Overview \*\* | - Circulating Supply: The number of items currently available and tradeable on the market
- Max Supply: The maximum quantity of this item that can exist.
- Token Standard
|
When searching for a specific item (not just by item type), you’ll be directed to the item's unique detail page, where you can view the following additional information:
1. **Info**
1. Equip Requirements
2. Item Stats & Enhancement Info
3. Item Description
4. Set Info (if the item belongs to a set)
2. **History**
1. View achievement history including achievement name, character name, and timestamp, sorted in chronological order.
3. **Activity**
1. View the item’s activity log, including achievement name, character name, and timestamp, sorted in chronological order.
2. You can filter the activity log by using the following options (multiple selections allowed):
1. All: View all records
2. Sale: Trade history
3. Transfer: Transfer history
4. Mint: Minting history
### **3.4. Item Name Search - FT**
When searching by an FT item name, you willll be directed to the item detail page, where the following information is available:
**Item Details**
| Category | Details |
| :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Item Info** | - Item Name
- Item Type
- Item Description
|
| **Item Circulation and Trading Volume Overview** | - Circulating Supply: The number of items currently available and tradeable on the market
- Max Supply: The maximum quantity of this item that can exist
- 24h volume(NESO)
|
| **Play Rewards** | - Display the in-game reward allocation and remaining unclaimed (yet-to-be-farmed) quantity using a bar graph
|
For FT items, you can view the following additional information:
1. **Price History**
* Displays the previous day’s high, low, average price, and trading volume for the FT item.
* This data is updated daily at 00:00 (UTC +0).
* Below the price information is a visual chart showing the daily trading volume and average price.
* Hover over any date to view detailed price data for that day.
* You can set the display period to either 7 days or 30 days.
* The bar graph represents daily trading volume, while the line graph represents the daily average price.
### **3.5. Character Name and Nickname Search**
If you search for a character name that is also a minted nickname, the search results will show both the character and nickname cards. If the character name has not been minted, you will be redirected to the character's detail page.
If you search for a name that is currently equipped on a character, you’ll be directed to the character detail page.
**Character Details**
| Category | Details |
| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \*\*Character Info \*\* | - Owner’s username
- Character image & its mintable state (mintable / minted)
- Character name
- Character level
- Character job
- Birthday: Character creation date
- Fame
- Nesolet
|
| \*\*Ranking \*\* | |
| \*\*Token Standard \*\* | - Token Standard of the character
|
For Character NFTs, you can view the following additional information:
1. **Info**
* View the character's Basic Information:
1. Stat (Info)
2. Hyper Stat (info)
3. Ability (Info)
4. Skill (Skill)
5. Medals (Collection)
6. Quests (Quest)
* Below the Basic Info section, you can view the character’s equipped items. Hover over each item to see its tooltip:
1. EQUIP: Displays equipped gear items as images
2. DEC.: Displays equipped decoration items
3. PET: Displays equipped pets
2. **Holding Items**
* Check the character’s inventory items, organized by inventory tab.
* You can filter the items by:
1. All: Show all items
2. Minted: Show only minted items
3. Mintable: Show only mintable items
3. **History**
* View the character’s **account history**, categorized by type.
* Use the **dropdown menu in the top-left corner** to filter by specific sub-categories:
| Category | Details |
| :------------------ | :------------------------------------------------------------------------------ |
| \*\*Character \*\* | - Level
- Job Advancement
- Ability
|
| **Item** | - Reward
- Star Force
- Potential
- Bonus Sta
|
| \*\*Adventure \*\* | |
| **Battle** | |
| \*\*Blockchain \*\* | |
| \*\*Social \*\* | - |
4. **Activity**
* View the activity log of the selected character:
1. All: View All
2. Mint: Minting history
3. Sale: Trade history
If you search for a name that is an on-chain nickname and not currently equipped on a character, you will be directed to the nickname detail page.
**Nickname Details**
| Category | Details |
| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| Nickname Info | - Owner’s username
- Nickname image
- Nickname
- Length/Composition
- Currently equipped status
|
| Token Standard | - Token Standard of the nickname
|
The following additional information is also available for Nickname NFTs:
1. **Activity**
* View the nickname's activity list:
1. All: View All
2. Mint: Minting history
3. Sale: Trade history
### **3.6. Username Search**
When searching by username, you will be directed to the user account detail page, where the following information can be viewed:
**Account Details**
| Category | Details |
| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| \*\*Account Info \*\* | - Owner's username
- User profile image
- Wallet address
- Character: Number of owned character(s)
- Item: Number of owned item(s)
- NESO
- Nesolet
|
| \*\*On-chain Info \*\* | - Total Item Minted: Total number of items minted to date
- Total NESO Minted: Total amount of NESO claimed to date
- Total Trading Volume
|
When searching by username, you can also view the following detailed information:
1. **Character**
* Displays a card-style list of all characters owned by the account.
* Hovering over a character image shows a detailed tooltip.
* **Search Bar:** Use the search bar on the left to find a specific character by name.
* **Status:** You can filter the characters by:
1. All: Show all characters
2. Minted: Show only minted characters
3. Mintable: Show only mintable characters
2. **Items**
* Displays a card-style list of all items owned by the account.
* Hovering over an item image shows a detailed tooltip.
* Use the dropdown at the top-left to select one of the following:
1. NFT Items
2. FT Items
* **Search Bar:** Use the search bar on the left to find items by the name of the character holding them.
* **Sub-category Filter**: Use the dropdown below the search bar to refine by category.
* **Status:** Filter the items by:
1. All: Show all items
2. Minted: Show only minted items
3. Mintable: Show only mintable items
* **Item Location:** Filter the item location by:
1. All: Show all items regardless of inventory locations
2. Wallet Inventory:Show only wallet-stored items
3. Character: Show only items stored in character inventories
4. If selected, a dropdown will appear to choose a specific character
3. **Nicknames**
* Displays all on-chain nicknames owned by the account as a list of image cards.
* Use the search bar on the left to find a specific nickname.
4. **Watchlist**
* Displays the account’s Watchlist, showing items added via the Add to Watchlist feature.
* Items appear as cards sorted by most recent registration.
* Use the top-left dropdown to filter by Watchlist type.
## **4. My Page**
On the My Page, you can view detailed information about your account. This section shares the same structure as **\[Section 3.6. Username Search]**
**Account Details**
| Category | Details |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Account Info** | - Owner's username
- User profile image
- Wallet address
- Character: Number of owned character(s)
- Item: Number of owned item(s)
- NESO
- Nesolet
|
| **On-chain Info** | - Total Item Minted: Total number of items minted to date
- Total NESO Minted: Total amount of NESO claimed to date
- Total Trading Volume
|
When searching by username, you can also view the following detailed information:
1. **Character**
* Displays a card-style list of all characters owned by your account.
* Hovering over a character image shows a detailed tooltip.
* **Search Bar:** Use the search bar on the left to find a specific character by name.
* **Status:** You can filter the characters by:
1. All: Show all characters
2. Minted: Show only minted characters
3. Mintable: Show only mintable characters
2. **Items**
* Displays a card-style list of all items owned by your account.
* Hovering over an item image shows a detailed tooltip.
* Use the dropdown on the top-left to select item types:
1. NFT Items
2. FT Items
* **Search Bar:** Use the search bar on the left to search items by name.
* You can use the dropdown menu below the search bar to filter and view items by specific sub-categories.
* **Status:** You can filter the items by:
1. All: Show all items
2. Minted: Show only minted items
3. Mintable: Show only mintable items
* **Item Location:** You can filter the location of the items by:
1. All: Show items from all inventories
2. Wallet Inventory: Show only wallet-stored items
3. Character: Show only items stored in character inventory
* If selected, a dropdown will appear to choose a specific character
3. **Nicknames**
* Displays all on-chain nicknames owned by the account as a list of image cards.
* Use the search bar on the left to find a specific nickname.
4. **Watchlist**
* Displays items, characters, nicknames, or users you have added to your Watchlist.
* Items appear as cards sorted by most recent registration.
* Use the top-left dropdown to filter by Watchlist type.
***
# Smithy
Source: https://docs.msu.io/msu-services/smithy
## **1. What is Smithy?**
Smithy is a web-based item enhancement app provided within MapleStory Universe. Instead of launching MapleStory N every time you want to enhance items, Smithy brings enhancement directly to your browser on any device.
This means you can enhance items anytime, anywhere, with added flexibility that goes beyond the game client experience:
* **Greater Flexibility**: Enhance items from your character's inventory or your wallet inventory
* **No Game Client Required**: Exchange Power Crystals and enhance items without launching MapleStory N
* **Streamlined Process**: The streamlined workflow lets you enhance items faster and more easily
With Smithy, enhancement opportunities are always within reach. Upgrade your items on the go.
## **2. How to log in to the Smithy Synergy App**
Smithy supports login through your MSU Account.
You can log in to Smithy in two ways
* Click the "Sign In" button in the upper right corner
* Click the "Start Enhancing" button on the intro page (if not already logged in)
When you attempt to log in, the system checks if your wallet is connected to MSU. It then proceeds with Smithy login using your connected MSU account information.
### **2.1 Signature request for first-time login**
When logging in to Smithy for the first time, you'll see a permission request during the login process. This page explains what actions Smithy will perform. You can cancel the login if you prefer not to proceed.
#### **2.1.1 Why Signing Is Required**
This signature verifies that Smithy has safe read/write permissions for items and enhancement materials in your wallet, such as NESO and Power Crystal. It's a simple authentication step. No actual transaction is made.
After reviewing this information, you'll complete a wallet signature to confirm your approval. Once signed, you can use Smithy freely without repeating this process.
### **2.2 When already logged in to MapleStory N**
Smithy and MapleStory N cannot run simultaneously since they share the same enhancement data. If you're already logged in to MapleStory N when you try to access Smithy, you'll see a message asking if you want to log out of MapleStory N first.
If you click "Confirm," your MapleStory N login session will be terminated, and you can proceed with Smithy.
If you click "Cancel," MapleStory N stays active, but login to Smithy won't be allowed.
## **3. Enhancement Inventory**
Once you log in to Smithy, click the "Start Enhancing" button to enter the Enhancement Inventory.
Here you can view and enhance all enhanceable items. You can also check and exchange Power Crystal, the materials needed for enhancement.
Items that can be enhanced through Smithy include
* Items owned by your characters (including equipped items)
* Items in your Wallet Inventory
Use the toggle buttons at the top left of the item list to switch between Character Inventory and Wallet Inventory. Click each button to explore items in the respective inventory.
Items belonging to characters not linked to MapleStory N cannot be viewed. Link the character to MapleStory N first if you want to enhance those items.
### **3.1. Character Inventory**
Character Inventory shows items belonging to characters linked to MapleStory N.
Your currently selected character appears in the first filter on the left side of the item list. To change characters, click that filter and select a different one.
Use the search and filter functions to easily find items you want to enhance. When you find an item, hover over it to display the available enhancement options.
You can now choose between **“Starforce”** and “**Potential**” to open the respective enhancement window.
### **3.2. Wallet Inventory**
In Wallet Inventory, you can view all items stored in your wallet. This includes items purchased from the marketplace and items moved from your characters in MapleStory N.
The list initially shows the "Weapon" category selected. Make sure to check the selected category when browsing items.
The process of exploring items and entering the enhancement window works the same as in Character Inventory.
#### **3.3 Power Crystal Exchange**
Just like in MapleStory N, you need Power Crystal to proceed with enhancement in Smithy.
**What is Power Crystal?**
An off-chain material that can be exchanged with NESO at a 1:1 rate.
At the top of the inventory, you can check the enhancement-related materials currently held in your wallet.
Click the "Exchange" button to open the exchange window.
Here, you can exchange Power Crystal in advance for your enhancement needs.
If you don't have enough Power Crystal when enhancing an item, you can also replenish it at that time.
If you don't have enough NESO to proceed with enhancement, click the "Swap" button to go to the Swap & Warp service to replenish your NESO.
## **4. How to enhance in Smithy**
When you select an item to enhance from the inventory, you'll be taken to a screen where you can proceed with enhancement.
Smithy uses the same enhancement system as MapleStory N, so the processes and probabilities are identical. Enhancement results are automatically synchronized between both services.
### **4.1 Star Force Enhancement**
In Star Force Enhancement, you can see your selected item's current Star Force grade, success and failure probabilities, and the stats you'll gain upon success.
The system displays helpful tip messages based on your current enhancement state. Use these tips to guide your enhancement decisions.
For example, when enhancements have failed twice in a row, a "CHANCE TIME!" message appears. This means your next enhancement is guaranteed to succeed.
Important features like "Chance Time" sync with your last enhancement attempt in MapleStory N, so your progress carries over to Smithy.
Review the displayed item information and enhancement details. If everything looks correct, click the "Enhance" button to proceed.
You can also enable the "Disable Star Catching" and "Major Failure Prevention" options before enhancing. When activated, these settings will apply to your enhancement attempt.
### **4.1.1 Dynamic Pricing**
Enhancement prices in Smithy use Dynamic Pricing, the same system as MapleStory N.
Dynamic Pricing is MapleStory N's unique enhancement pricing system where prices change in real-time based on user enhancement demand.
Both Star Force and Potential enhancements follows this system, with prices varying depending on the specific enhancement type.
[\[Learn more about Dynamic Pricing\]](https://docs.maplestoryn.io/msn-101/learn-more/dynamic-pricing)
### **4.1.2 Star Catch**
When you proceed with Star Force enhancement, a mini game called Star Catch automatically starts. This mini game can increase your Star Force success probability.
The game gives you 5 seconds to stop a moving star at a specific point by clicking the "STOP!" button. Successfully stopping the star at the correct spot gives you a buff that increases your enhancement success probability.
If you don't want to play Star Catch, click the "Disable Star Catching" button above the enhance button. When disabled, you won't receive the success probability bonus.
### **4.1.3 Major Failure Prevention**
If your current Star Force grade is 12 stars or higher, enhancement attempts can result in a "Major Failure."
For items between 12-17 stars, you can enable the "Major Failure Prevention" feature to avoid this outcome. However, enabling this feature doubles your enhancement cost, and you'll see a notice explaining the increased price.
### **4.1.4 Pop-up Disable**
To provide an enhancement experience similar to MapleStory N in-game, Smithy lets you temporarily disable all confirmation messages.
When enhancing, you'll see a message showing the enhancement cost. At the bottom of this message, you can activate "Don't show again during this enhancement." Once enabled, all future enhancement attempts on that page will execute immediately without confirmation messages.
Note that Star Catch will still appear unless you also activate "Disable Star Catching."
Be careful when using this feature, as rapid enhancement attempts can lead to unexpected costs.
### **4.2. Potential Enhancement**
In Potential Enhancement, you can enhance both an item's Potential and its Bonus Potential.
* Potential can be enhanced using Occult Cubes, Red Cubes, or Black Cubes.
* Bonus Potential can be enhanced using Bonus Occult Cubes or Bonus Potential Cubes.
When attempting enhancement, the grade will either increase or remain the same — it will never decrease. \
Enhancement probabilities can be checked by clicking the “Probability Info” button.
To proceed, select the desired Potential type and the cube item you want to use, then click the “Enhance” button to complete the process.
### **4.2.1. Memorial Feature**
The Memorial feature allows you to choose between the current option and the newly rolled option. \
This feature is only available when enhancing with a Black Cube.
After a Black Cube enhancement, both the current and new options are displayed side by side. \
You must select one to finalize the enhancement.
### **4.2.1.1. Notes on the Memorial Feature**
Black Cubes always trigger the Memorial feature, allowing you to choose between keeping your current potential option or accepting the new one.
The “Enhance” button stays active during this selection for smoother enhancement. If you don’t make a choice, the system automatically keeps your current potential option. To accept new potention options, select them before proceeding.
If an item in your selected Character or Wallet Inventory has an unfinished Memorial selection, \
a ‘Potential Enhancement Pending’ popup will appear, prompting you to complete the enhancement first.
Until you make a choice and finish the pending Memorial selection, no other items in that inventory can be enhanced. \
Make sure to finalize the selection before starting any new enhancement attempts.
***
# Swap & Warp
Source: https://docs.msu.io/msu-services/swap-and-warp
**Precautions for Safe Token Transfers**
* Please note that native NXPC tokens acquired through Swap or any other features on Henesys L1 network ***cannot*** be directly deposited to exchange addresses or transferred to other networks.
* If you transfer NXPC tokens across networks without using Warp, the recipient address may not recognize them, resulting in permanent loss of your digital assets.
* To avoid loss of digital assets, you must bridge your NXPC tokens to a compatible network (such as the Avalanche C-Chain) using the official dedicated bridging path including Warp.
* Before using Warp, please verify the following:
* The network and recipient address
* That the bridge service provider is the official website or a verified source
* Successful transaction with a small test transfer
* Additionally, check bridge fees and processing times in advance, and ensure you have sufficient gas to cover any transaction fees.
Failure to follow these precautions may result in irreversible loss of your digital assets, so please proceed with caution.
## **1. Swap**
### **1.1. What is Swap?**
Swap is a token exchange service on the Henesys L1 network that allows you to swap NXPC and NESO at a fixed rate. It is designed to support seamless use of both tokens across various features and services within the MapleStory Universe.
### **1.2. How to Swap tokens with Swap**
1. **Connect your wallet**
* Visit Swap ([https://msu.io/swapnwarp](https://msu.io/swapnwarp)) and connect your wallet.
2. **Select Swap direction**
* To receive NESO, select NXPC as ‘PAY’ → NESO as ‘RECEIVE’
* To receive NXPC, select NESO as ‘PAY’ → NXPC as ‘RECEIVE’
3. **Enter Swap details**
* Amount: Enter the amount you want to swap.
When NXPC is selected as the “PAY” token, the amount must not be less than 0.00001 or below the estimated gas fee. When NESO is selected as the “PAY” token, the minimum amount allowed is 1.
**Minimum exchange amount**
NESO = 1
NXPC = 0.00001
**4. Review and confirm**
* Fees & Confirmation: Review the estimated network gas fees and confirm all swap details.
* Initiate Swap: Approve and sign the transaction in your wallet to start the swap process.
### **1.3. Understanding rates and fees**
* Exchange rate: Fixed at 1 NXPC = 100,000 NESO.
* Fees: Network gas fees apply. Make sure your wallet has sufficient balance to cover them.
* Gas support: Enjoy two (2) free NESO → NXPC swaps per day designed for a smoother user experience.
### **1.4. Monitoring your Swap details**
* Transaction Tracker: After initiating the transaction, use the pop-up, block explorer link, or the Transaction tab to check progress.
* Transaction History: View all past swaps with direction, amount, and confirmation status. You can filter by wallet address or transaction hash, or click My Transactions to see only your own swap transactions.
## **2. Warp**
### **2.1. What is Warp?**
Warp is a cross-chain bridging service that enables you to transfer tokens or NFTs between Henesys L1 and other supported networks. Warp allows you to move your digital assets securely while maintaining a seamless experience within MapleStory Universe ecosystem.
### **2.2. How to bridge using Warp**
1. **Connect your wallet**
* Visit Warp ([https://msu.io/swapnwarp/warp](https://msu.io/swapnwarp/warp)) and connect your wallet.
2. **Choose your Warp parameters**
* Select Warp Direction: Choose your source network and destination network.
* Select Asset: Choose the token (NXPC or USDT) you wish to bridge.
* Amount: Enter the amount you want to transfer
* Recipient Address: Enter the wallet address to receive the tokens
* Please double-check the address. Entering an incorrect address may result in permanent loss of your tokens.
3. **Review and approve the transaction**
* Fees & Confirmation: Review the estimated network gas fees and bridge fees and confirm all details.
* Initiate Warp: Approve and sign the transaction in your wallet to start the warp process.
### **2.3. Understanding fees and transaction status**
* Fees: Warp shows estimated network gas fees and bridge fees before you confirm. Make sure your wallet has sufficient balance to cover them.
* Transaction status: Transaction status varies depending on network congestion on both the source and destination networks. The status tracker will update you in real time.
### **2.4. Monitoring your Warp details**
* Transaction Tracker: After initiating the transaction, use the pop-up, block explorer link, or the Transaction tab to check progress.
* Transaction History: View all past warps and confirmation statuses. You can filter by wallet address or transaction hash, or click My Transactions to see only your own warp transactions.
### **2.5. Warp from Henesys L1**
* Outbound vs Inbound: Bridging out (from Henesys L1) works differently from bridging in (to Henesys L1)
* Daily limits: Daily outbound limits depend on your account verification level.\\
* There is no limit on inbound (bridge-in) transactions.
* For more information, please refer to the [KYC FAQ](https://support.msu.io/hc/en-us/categories/12689000323727-KYC).
* When bridging out, you must confirm that you are not located in, or otherwise subject to, any jurisdiction where access is restricted by applicable laws.
| **Contact Address** | | |
| ------------------------- | ------------------------------------------ | - |
| NXPC on Avalanche C-Chain | 0x5E0E90E268BC247Cc850c789A0DB0d5c7621fb59 | |
| NXPC on BNB Chain | 0xf2b51CC1850fEd939658317a22d73d3482767591 | |
MVP Bronze rank or higher is required to use Warp-Out. Unranked users can only use the Swap and Warp-In features.
## **3. DEX**
### **3.1. What is a DEX?**
* A DEX (Decentralized Exchange) is an exchange that facilitates direct, peer-to-peer cryptocurrency transactions without a central intermediary.
* You can access a DEX to swap NXPC and USDT on the Henesys Network by selecting the ‘[DEX](https://henesys.algebra.finance/swap)’ menu in Swap\&Warp.
This DEX is provided and operated by Algebra Labs. For any related inquiries, please contact [Algebra Labs](https://algebra.finance/form/).
**Important Notice**
* Cross-chain transfers (i.e., Warp) are executed via smart contracts and only support eligible digital assets as specified by the protocol.
* Make sure you have approved the Swap or Warp contract to spend your tokens. Failing to do so will block your transaction until you manually approve.
* Conversion mechanisms (rates, fees, caps, etc.), bridge limits, and supported networks are subject to change at any time without prior notice.
* All Swap and Warp transactions are irreversible. Carefully review all transaction details including, but not limited to, the transaction amounts and addresses before signing.
* Users are solely responsible for gas fees and fees for Swap and Warp. Insufficient gas fees or failure to meet protocol conditions may result in partial or complete transaction failure.
* Always perform swaps and bridges through official Swap and Warp UI. Using unverified third-party tools or websites may not support the correct routes or contract addresses. Use only official, verified bridge interfaces, and perform a small test transfer first.
* For support or inquiries related to Swap or Warp, please use our support channel at [support.msu.io](http://support.msu.io).
***
# Web Common Features
Source: https://docs.msu.io/msu-services/web-common-features
## **1. Navigation Bar**
All web pages provided by MapleStory Universe share a consistent set of common features that are applied across the platform.
These shared features ensure a unified user experience and convenient navigation, regardless of which MapleStory Universe service page you are accessing.
### **1.1. Service Selector Button**
At the top-left corner of every MapleStory Universe webpage, you will find a **service selector button**, represented by nine dots arranged in a 3x3 grid.
When clicked, a dropdown menu appears showing a list of available services.
You can conveniently navigate to their desired service by selecting from this list.
### **1.2. Notifications**
The Notifications feature allows you to view service-specific alerts related to the MapleStory Universe service.
Notifications are stored for 7 days, after which they are automatically deleted on a daily basis.
* You can manually delete any alert by clicking the \[X] button on the right side of each item.
* All notifications are listed in chronological order, with the most recent appearing at the top.
#### **1.2.1. Notification Categories**
Notifications are divided into the following 6 categories:
1. **All**: Displays all alerts across MapleStory Universe services.
2. **Account:** Shows account-related notifications.
3. **Marketplace:** Notifies you of marketplace activity (purchases, sales, offers, bids, etc.).
4. **Swap & Warp:** Displays alerts related to token swap and warp actions.
5. **MSU:** System-sent notifications about MapleStory Universe services.
6. **MSN:** System-sent notifications specific to MapleStory N.
#### **1.2.2. Notification Management**
Click the three-dot icon in the top right corner of the notification window to access notification deleting options.
1. **Delete Individually:** Activates a selection mode where you can choose one or more notifications to delete in bulk.
2. **Delete All:** Deletes all notifications within the selected notification category at once.
#### **1.2.3. Emergency Notifications**
Emergency alerts are sent when there is critical information that you must be aware of while using the MapleStory Universe service.
* Emergency alerts are pinned at the top of all notification categories.
* They will remain pinned until the **“Confirm”** button is clicked.
* You cannot delete a pinned emergency alert using the **\[X]** button.
* Only after confirming via the **“Confirm”** button can the alert be removed.
### **1.3. My Page**
By clicking your profile image on the top-right (next to Notifications), you can access a summary of your account details:
* Profile Image
* MapleStory Universe Username
* Wallet Address
* NESO Balance
You can also click buttons within the profile section to navigate to your full account details page.
#### **1.3.1. Overview**
You can view the detailed information of your account.
* **Profile Card**
* **Profile Image**
* **MapleStory Universe username**
* **Wallet address**
* **Connected email address**
* **Account Status:** Indicates whether the account is Normal (not restricted) or Restricted
* **Verification & Withdrawal Limit:** Your withdrawal(warp-out & transfer) availability depends on both your MVP status and verification level.
* If you do not have an MVP rank, all withdrawals are unavailable regardless of your verification level.
* If you have an MVP rank, your daily withdrawal limit is determined by your verification level as shown below.
| **Verification Level** | **NFT Transfer** | FT Transfer | Daily Withdrawal(Warp-out\&Token Transfer) Limit |
| ------------------------ | ---------------- | ----------- | ------------------------------------------------ |
| Lv.0) Wallet connection | Unavailable | Unavailable | \$1,000 |
| Lv.1) ID Verification | Available | Available | \$10,000 |
| Lv.2) Proof of Residence | Available | Available | \$30,000 |
**If you do not have an MVP rank, all withdrawal types are blocked regardless of your verification level.** For more details, see the [MVP System Guide](https://docs.msu.io/welcome-to-msu/mvp-system).
* **Social Account:** Your Discord account that is a member of MapleStory Universe Discord server and connected to the MapleStory Universe Web
* **Last Login:** Most recent login time
* You can click “View All” button on the right to view the entire list of login records.
* **Item / NESO Overview**
* **Total Item Minted:** Displays the total number of NFT items minted.
* **Total NESO Minted:** Shows the total amount of NESO minted by the user.
* **Total Trading Volume (NESO):** Indicates the cumulative total of both buying and selling amounts in NESO.
* **Asset Status**
* **Total NXPC Holdings:** Total NXPC held, along with its USD equivalent.
* **Total NESO Holdings:** Total NESO held, along with its USD equivalent.
* **Total Characters Owned:** Number of characters owned, including both on-chain and off-chain.
* **Total NFT Items Owned:** Number of NFT items held across both the wallet and characters, including on-chain and off-chain.
* **Total Consumable Items Owned:** Number of FT items (consumables) held across both the wallet and characters, including on-chain and off-chain.
#### **1.3.2. Verification**
In this tab, you can check the verification status of your account.
**Your withdrawal availability depends on both your MVP status and verification level.**
If you do not have an MVP rank, all transfers are unavailable regardless of your verification level.
If you have an MVP rank, your NFT/FT transfer availability and daily withdrawal limits are determined by your verification level.
You can view your daily withdrawal limit and remaining capacity according to your verification level under the "Withdrawal limit" section at the top.
* **Transfer Availability/Daily Withdrawal Limit** The withdrawal limit resets daily at 00:00 (UTC +0).
* **Users with MVP rank**
| **Verification Level** | **How to Verify** | **NFT Transfer** | **FT Transfer** | **Daily Withdrawal Limit** |
| :----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | :--------------- | :-------------- | :------------------------- |
| Lv.0) Wallet connection | Connect your Wallet to the MapleStory Universe Web. | Unavailable | Unavailable | \$1,000 |
| Lv.1) ID Verification | Sumsub KYC supports template OCR and accepts ID documents from over 210 countries. Typically, verify with a passport or government-issued ID. | Available | Available | \$10,000 |
| Lv.2) Proof of Residence | Not available yet; will be available later. | Available | Available | \$30,000 |
* **Users without MVP rank**
| **Type** | **Availability** |
| :------------------------------- | :--------------- |
| Token(NXPC, USDT) Warp-out | **Unvailable** |
| Token(NXPC, NESO, USDT) Transfer | **Unavailable** |
| NFT Transfer | **Unavailable** |
| FT Transfer | **Unavailable** |
If you'd like to proceed to the next stage of account verification, please click the Proceed button.
* For example, if your current account verification level is Lv.0, you'll see the **Proceed** button under the Lv.1 ID verification section. Click this button to start the verification process.
**\[[Why do I need to verify?](https://support.msu.io/hc/en-us/categories/12689000323727)]**
Clicking this button will redirect you to an FAQ page explaining why account verification is necessary.
#### **1.3.3. Settings**
You can review and update your account's personal information in the Settings tab.
* **Profile**
* **Nickname:** Displays your current account username. You can update it by clicking the Change button.
* **Profile Image:** Your profile image can be set to one of your characters. If the character is transferred, it can no longer be used as your profile image.
* **Email Address:** If you're using MetaMask, your email can be verified and changed.
* **Socials**
* **Discord:** Shows your linked Discord account.
* If not linked, you will see a **Link** button. Click to connect your Discord account.
* **Only one Discord account** can be linked per MapleStory Universe account.
* If you unlink your Discord, a **24-hour cooldown** will apply before you can relink.
* **Delete Account**
* You may proceed with account deletion.
* Account deletion is subject to the following conditions:
* Cannot delete if there are items stored in the MapleStory N NFT Collection.
* Upon deletion, the following data will be **removed**:
* MSU Marketplace
* Registered sales
* Sent offers
* Received offers
* FT orders
* Bid orders
* Bookmarks
* Saved filters
* Bid favorites
- In accordance with the MapleStory Universe Privacy Policy, deleted account data is stored temporarily for 30 days before being permanently erased.
- During this period, you may restore your account but cannot re-register with the same wallet.
- Information required by law may still be retained after deletion for the legally mandated period.
## **2. Footer**
In the Footer, you can find detailed links and information related to the web services provided by MapleStory Universe.
Please note that MSU Explorer is officially supported by the digital asset data service provider CrossAngle, and therefore has a separate Footer from MapleStory Universe. The common Footer elements listed below do not apply to MSU Explorer.
The Footer is composed of **five** **key sections:**
### **2.1. Service Logo & Official Social Links**
On the left side of Footer, you can see the logo of the web service you are currently visiting.
Below the logo, you will find links to the five official social media channels through which MapleStory Universe shares information with Maplers.
### **2.2. Tabs equivalent to the Top Menu**
You can navigate to different pages by clicking on the **same tabs available in the Top Menu**, also shown in the Footer.
Example: In the MSU Marketplace, the Top Menu tabs such as **NFT Items, FT Items, Characters, and Bid** can also be accessed directly from the Footer.
### **2.3. Synergy App Select Dropdown**
At the right corner of the Footer, you can find a dropdown menu that allows you to select Synergy App, redirecting you to the corresponding service’s webpage.
### **2.4. User Support Section**
1. **WhitePaper:** You can check Nexpace whitepaper that encompasses all the aspects of the MapleStory Universe project and its vision forward.
2. **Support:** This link redirects you to the official MapleStory Universe Support webpage.
3. **Contact Us:** Clicking this link opens your default email application, pre-filled with the official email address of Nexpace, the service provider of MapleStory Universe.
### **2.5. Policy Section**
1. **Terms of use:** You can view the terms and conditions of using MapleStory Universe.
2. **Privacy policy:** You can review the privacy policy regarding how MapleStory Universe handles personal information.
3. **Cookie Policy:** You can check the web cookie policy used by MapleStory Universe.
4. **Legal Document:** You can access the legal documents related to MapleStory Universe.
To ensure fair and seamless game service, MapleStory N additionally provides an Operation Policy, which can be found at the bottom right corner of the footer.
***
# Getting Started with MSU Space
Source: https://docs.msu.io/msu-space/getting-started-with-msu-space
## 1. What is MSU Space?
MSU Space is a platform on Verse8 where anyone can build and publish MapleStory-themed games using AI and official MapleStory Universe (MSU) resources. No studio, no approvals, and no coding experience required.
The process from registration to publishing follows four stages:
* Stage 1: Join the Creator Program on MSU Space
* Stage 2: Build your game using AI in Verse8
* Stage 3: Publish your game to MSU Space
* Stage 4: Submit your entry to the MapleStory Vibe Camp form
## 2. Sign Up
To get started, create a Verse8 account and apply to the Creator Program.
1. Navigate to MSU Space (verse8.io/msu) and click Get Started.
2. On the Creator Program page, click Agree & Apply under Terms & Application.
3. In the sign-in modal, select a sign-up method. Email and Google are available for new accounts. X and Discord are for sign-in only.
## 3. Terms & Application
After signing in, a Terms & Application modal will appear. Review and agree to both sets of terms to proceed.
1. Read the MSU Space Terms and toggle on I agree to the MSU Space Terms.
2. Read the MapleStory Vibe Camp Terms and toggle on I agree to the MapleStory Vibe Camp Terms.
3. Click Agree & Continue.
## 4. Verification
Verify your identity with a one-time code to unlock MSU resources.
1. In the Verify your phone modal, select your country and enter your phone number.
2. Click Send Code. Enter the one-time code sent to your phone.
3. Click Done when the Verified confirmation appears.
Linking your MSU Builder account provides access to unlimited builder credits during the MapleStory Vibe Camp period.
**How to connect MSU Builder account with Verse8:**
1. Click 'Get started' on the \[[MSU Space](http://verse8.io/msu)] home screen.
2. Agree to the 'Terms & Application' on the Creator program page, then click 'Connect your MSU Builder account' under the Credit Refill policy.
3. Click 'Connect with MSU Builder' on the MSU Builder banner.
## 5. Creating a Game
After completing verification, return to the Creator Program page and click Go Create. If a MapleStory Vibe Camp welcome popup appears, click Get Started to enter the editor.
In the editor, describe the game you want to build in the prompt input and click Run. The AI will use official MapleStory Universe resources to generate a playable game.
You can browse MapleStory characters, monsters, items, and more using [MSU Resource Search](http://resource-search.msu.io) before writing your prompt.
For details on searching, previewing, and exporting assets, refer to the **[MSU Resource Search Guide](https://docs.msu.io/msu-resources/msu-resources-search-guide).**
Once the game is generated, review the preview and refine it with follow-up prompts until it plays the way you want.
For tips on writing effective prompts, refer to the [Prompt Tips](https://docs.msu.io/msu-space/prompts/prompt-tips).
To share your prompts with the community, refer to the [Sharing Effective Prompts](https://docs.msu.io/msu-space/prompts/sharing-effective-prompts).
## 6. Launching Your Game
When your game is ready, click Launch in the top-right corner of the editor to begin the launch process.
* **Step 1 — Info**
Enter the required fields including Game Title and Tag, then click Continue.
* **Step 2 — Visuals**
Add a Game Thumbnail (generate with AI or upload your own) and an optional Preview Video, then click Continue.
* **Step 3 — Notes**
Enter a Build Release Title, select a Release Type, and write a Release Description, then click Continue.
* **Step 4 — Launch**
Complete the basic settings and click Submit.
MSU games are reviewed before they go public. Track your review status on the Creator Program page.
***
# Prompt tips
Source: https://docs.msu.io/msu-space/prompts/prompt-tips
A practical reference of prompts for building games with MapleStory Universe resources in MSU Space.
**Note — Results May Vary**
The prompts and example videos in this guide were produced with the Verse8 Auto LLM model available at the time of writing (May 2026). The models offered by Verse8 may change over time, and by the nature of LLMs the same prompt does not always produce identical output. As such, the exact results shown in the videos are not guaranteed. Please treat the prompts as directional guidance and implementation references, not exact reproductions. If a result differs from your expectation, we recommend iterating on the prompts or trying a different model.
## **1. Base Setup Prompt**
Initial setup prompt that the feature prompts in the sections below build on top of.
```text theme={null}
Build a 2D side-view game featuring a MapleStory character using
Phaser 3 + TypeScript + Vite + Bun.
[Project setup]
- Canvas 1280×720, Arcade physics, gravity Y 1500
- Debug rendering togglable at runtime (D or F1)
[Maple character configuration]
- Use the Maple MCP to look up the following assets and save them as a render plan JSON:
- body id 2000, head id 12000
- one default face / one default hair
- one 1H Sword (AAT=1 recommended)
- one coat / pants / shoes
- Required action states (minimum):
stand1, walk1, jump, prone, proneStab, swingO1, swingO2, stabO1
- Merge the saved JSONs into a single render plan and preload all textures.
[Rendering]
- Use the MapleSprite / queueRenderPlan helpers under src/__system__/maple/
- Never modify src/__system__/ directly
- The player class extends MapleSprite
- scale 2, race "human", default facing "left"
- Control direction only via setFacing("left" | "right") — do not use setFlip
- Never hard-code Maple action names. Use weapon-aware methods (walk(), stand(), attack())
[Scene]
- A single MainScene
- A large static floor at the bottom + 2~3 platforms at varying heights
- Camera follows the player
[Hitboxes]
- Standing: 30×60, offset (-15, -40)
- Prone : 40×20, offset (-20, -17)
* The top edge is for visual alignment only — do not lower it further.
[Navel correction — IMPORTANT]
- Maple sprites render relative to the navel, so the visual floor differs per pose.
- Entering prone : first y += 17, then swap action / hitbox
- standUp : first y -= 17, then swap hitbox / action
```
## **2. Feature Prompts**
The prompts in this section build on top of the Base Setup in Section 1. Start with 2.1 to ensure MapleStory assets are applied correctly, then follow the sections in order.
### 2.1. Applying MapleStory Assets
If MapleStory assets are not being applied properly, prefix the prompt with instructions to use the proper MapleStory assets, such as "Using the Maple MCP, \[specific action]," so the AI can search for and apply the relevant MapleStory assets.
### 2.2. Character Actions
Copy each prompt below into Verse8 as-is. Applying them sequentially gives the best result.
#### 2-2-1. Horizontal movement
```text theme={null}
Use the Maple MCP
Horizontal movement
Move with the Left / Right arrow keys.
- Move speed 200
- ← / → : set horizontal velocity + update facing + (on ground) walk action
- No input : horizontal velocity 0 + (on ground) stand action
- Movement input is ignored while attacking or prone.
```
#### 2-2-2. Jump
```text theme={null}
Use the Maple MCP
Jump
Jump with the Up arrow key.
- Jump power 900
- Can only jump while on the ground
- jump action while airborne
- Jump input is ignored while attacking or prone.
```
#### 2-2-3. Prone
```text theme={null}
Use the Maple MCP
Prone
Press the Down arrow to lie down; release to stand up.
- Prone while ↓ is held; standUp on release
- Movement / jump input ignored while prone (for attacks, see the prone variant in the [Attack] section)
- Each prone entry / standUp triggers exactly once (no re-entry)
- Cannot enter prone or standUp while attacking
- Before standUp, check overhead collision: if any collidable body (excluding self) overlaps the area the standing hitbox would occupy, defer standUp
- standUp is disabled for 100ms after prone entry (debounce)
- If entering prone while moving, decelerate horizontal velocity to 0 over 300ms; otherwise stop immediately
- On prone enter / exit, always apply the navel correction (y ±17) from [Base Setup].
```
#### 2-2-4. Attack (ground / jump / prone)
```text theme={null}
Use the Maple MCP
Attack
Attack with Space. The variant for standing / airborne / prone is selected automatically.
Common rules
- One Space press = exactly one motion playback. No looping even while held.
- The next attack is only allowed after (a) the key is released and (b) the previous animation has finished.
- Use press-edge detection (e.g. JustDown). Do not use `isDown`.
- Call via weapon-aware methods. Do not hard-code action names.
- All other input (move / jump / prone / standUp / extra attack) is ignored during an attack.
- On attack end (~500ms), clear the attack flag / hitbox.
Basic attack (ground, standing)
- Auto-selects a swing / stab variant based on weapon AAT (e.g. 1H Sword → swingO1)
- Halve horizontal velocity (inertial weight)
- On end, if stopped and grounded → stand action
Jump attack (airborne)
- Triggered by Space while jumping or falling
- Preserve horizontal / vertical inertia (no velocity change; gravity / falling proceed normally)
- On end, return to `jump` if still airborne; stand / walk if landed
Prone attack
- Triggered by Space while prone
- Auto-selects a weapon-aware prone variant (e.g. 1H Sword → `proneStab`)
- Keep horizontal velocity at 0 (no inertial change)
- standUp input is locked during the attack — cannot stand up until the attack ends
- After end, remain prone — do not auto standUp.
Attack hitboxes
- Spawn ~50px ahead in the facing direction
- Ground attack : 60×100, centered on upper-body height
- Jump attack : 60×80, between upper body and legs (the swing range while airborne)
- Prone attack : 60×30, centered on the prone body height
- Visible only in debug mode (red, ~0.3 alpha); otherwise invisible but active
- Destroyed after ~300ms.
```
### 2-3. **Hitbox & Collision**
#### 2-3-1. Dynamic hitbox swap
```text theme={null}
On state transitions, swap size / offset within 1 frame. Prone entry is immediate; standUp runs only after the overhead collision check.
```
#### 2-3-2. Full hitbox system (beginner-friendly all-in-one prompt)
````text theme={null}
Build a hitbox system for this 2D platformer. Apply sensible defaults; only follow these principles.
1. Four distinct box types
- Hurtbox — the area where the character takes damage
- Hitbox — the area where a weapon / attack lands
- Collider — physical collision against walls / floors
- Trigger — overlap-only events such as portals / items / ropes
2. Pose-based auto switching
Hurtbox size / offset switches within 1 frame based on character state (stand / prone / jump). When standing up, run the overhead collision check first.
3. Active-frame gating
Attack hitboxes are off during the motion's startup / recovery and only on during active frames. Include frame-by-frame active information in the motion data.
4. Multi-hit prevention
The same enemy can only be hit once per attack motion. Cache hit enemyIds and reset the cache when active ends. Allow multi-hit (e.g. bosses) via an opt-in flag.
5. Automatic i-frames
On being hit, automatically grant invulnerability. While invulnerable, the hurtbox ignores hits from any hitbox / trigger — terrain colliders still apply.
6. Debug visualization — use Phaser built-ins
Physics bodies (collider / trigger) are handled automatically by Phaser arcade physics debug mode.
```
// game config
{ physics: { default: 'arcade', arcade: { debug: true, debugBodyColor: 0x00ffff } } }
// runtime toggle (F1)
scene.physics.world.drawDebug = !scene.physics.world.drawDebug;
scene.physics.world.debugGraphic.clear();
Once enabled, every physics body (player / monsters / projectiles / platforms / ropes / portals) is shown automatically, including newly created ones — no subscription pattern needed.
For custom hurtbox / hitbox (judgement zones that are not Phaser bodies), draw them separately via `scene.add.graphics()`, gated by the same debug flag.
- Hurtbox : translucent yellow (`fillStyle(0xffff00, 0.3)`)
- Hitbox : translucent red — drawn only during active frames
- Trigger area : green outline (for non-Phaser-body cases)
Pin graphics objects on top via setDepth(9999).
```
7. Data separation
Do not hard-code box sizes / offsets / active timings. Manage them in a config object / JSON, split per character and per motion for easy tuning.
8. Defaults
Use values typical for a side-scrolling platformer (e.g. 24×60 standing, 24×30 prone). Mark areas that need tuning with comments.
````
### 2-4. Monsters / Enemies
#### 2-4-1. Monster hit reaction
```text theme={null}
Use the Maple MCP
Monster hit reaction
hitstop 80ms + red tint 0.2s. Hitstun 300ms (action freeze), then return to the previous state. Damage number floats upward and fades.
```
#### 2-4-2. Monster death
```text theme={null}
Use the Maple MCP
Monster death
Invulnerable during the die motion. Fade-out 0.3s. Remove the collider after the sprite is gone.
```
#### 2-4-3. Contact damage
```text theme={null}
Use the Maple MCP
Contact damage
At most one hit per overlap (handled automatically by the player's i-frames). Spawn a shockwave ring ease-out 0.2s at the contact point. Add a knockback motion on impact.
```
***
# Sharing Effective Prompts
Source: https://docs.msu.io/msu-space/prompts/sharing-effective-prompts
## 1. Include relevant meta information
The same prompt can yield different results depending on the engine, physics / rendering setup, and MCP configuration. Include the following whenever possible:
* Engine and language used (e.g. Phaser 3 + TypeScript)
* Physics / rendering setup (e.g. Arcade Physics / Matter / custom, etc.)
* MCP / resources used (e.g. Maple MCP)
* LLM model used
## 2. Separate shared context from the Actual Prompt
Split prompts into a **common context** (the always-assumed environment) and the **actual prompt** (this specific task) for cleaner sharing.
**Common context example**
```text theme={null}
- Phaser 3 + TypeScript-based 2D action game
- Physics: Arcade Physics
- MapleStory assets are searched via the Maple MCP
- Preserve the existing code structure and file names
- Must build without errors
```
**Actual prompt example**
```text theme={null}
Implement horizontal movement and jumping for the player.
- Arrow keys to move, Space to jump
- Can only jump while on the ground
- Distinct idle / run / jump animation states
- Preserve the existing Scene structure
Completion criteria: no build errors, no terrain clipping, immediate input response
```
## 3. **Define Constraints and Limitations Clearly**
Prompts don't always reproduce perfectly, so don't hide the limits you know about — share them. Through others' feedback the prompt can improve over time.
* Tested environment and scope
* Areas that are still unstable
* Parts that may vary by model / version
* Values that still need tuning
## 4. Specify completion criteria and success metrics
What "works well" means differs from person to person. State the completion criteria so others can verify the result by the same standard.
* No build errors
* A specific behavior reproduces M out of N times (e.g. 4 out of 5)
* Maintains 60 FPS
* A specific UI shows up at the correct position and size
## 5. Clarify the expected output format and role assignment
Note what **role** you assigned to the LLM and in what **format** you received the result.
* Role examples: "senior Phaser game developer", "code reviewer", "QA engineer"
* Format examples: code blocks only, step-by-step explanation, JSON, diff / patch, etc.
## 6. Provide any relevant files, code, or reference context
Write down what context you passed to the model along with the prompt. The same prompt can produce completely different results when the context is different.
* Attached files / paths
* Code scope referenced (only a specific Scene file / the entire src / a specific function, etc.)
* MCP resource names and search keywords used
## 7. Share follow-up prompts and the iterative workflow
It's rare for a single prompt to finish the job. Share the follow-up prompts used to refine the result.
* What was wrong with the first result
* Which follow-up prompt fixed what, and how
* Example: "terrain clipping bug → fixed with 'reduce the player collider height by 8px and retry'"
## 8. Include examples of outcomes
If possible, share the prompt's execution result — text, screenshots, videos, etc.
## 9. Check for safety, copyright, and sensitive information
Run through this checklist before sharing:
* Remove sensitive info such as API keys, internal paths, account credentials
* If MapleStory IP or external assets were used, note the license scope (e.g. internal demo only)
* Make sure internal code / document links are not exposed externally
## 10. Share your prompts
Share your prompts and iterative workflows at [forum.msu.io](http://forum.msu.io).
***
# Credit Level System
Source: https://docs.msu.io/welcome-to-msu/credit-level-system
## **1. What is Credit Level?**
Credit Level is a system introduced to enhance the MapleStory Universe ecosystem.
The Credit Level system is designed to prevent abusive actors and ensure that verified Maplers can enjoy a safe service environment.
After connecting your wallet, you can check your current Credit Level by navigating to [My Page > Credit Level](https://msu.io/mypage/credit-level).
Credit Levels are assigned based on the requirements you meet, and your final Credit Level is determined by the highest requirement you qualify for.
## **2. Credit Level System**
### **2-1. Credit Level 0**
Accounts will receive Credit Level 0 if they meet any of the following conditions after the Credit Level system is introduced on June 25, 2025:.
1. Wallet accounts newly connected to MapleStory Universe after the Credit Level system is introduced,
2. Wallet accounts connected before the Credit Level system is introduced but do not have a history of accessing MapleStory N,
3. Wallet accounts with existing service restrictions at the time the Credit Level system goes live.
* Accounts with Credit Level 0 are restricted from accessing MapleStory N.
* If your Credit Level changes from 1 to 0 while playing MapleStory N, your access to the game will be suspended.
### **2-2. Credit Level 1**
**As of February 26, 2026**, new accounts will no longer be eligible for Credit Level 1 due to a system adjustment. The following information applies only to accounts that were created before this date and have maintained their Level 1 access. ([Detail](https://msu.io/maplestoryn/news/notices/3386312))
* Accounts will receive Credit Level 1 by holding 10 NXPC in their wallet.
* The NXPC balance must be held on the Henesys Chain, the mainnet for MapleStory Universe.
* If the NXPC balance on the Henesys Chain drops below 10, the Credit Level will revert to Level 0.
- Credit Level 1 accounts have access to all services within MapleStory Universe.
- NXPC held on the Avalanche C-Chain does not contribute to Credit Level requirements. To reflect NXPC on your Credit Level, make sure to Warp In your NXPC to the Henesys Chain via [Swap & Warp > Warp](https://msu.io/swapnwarp/warp).
**Credit Level 1 (Temporarily Active)**
* Accounts with a history of accessing MapleStory N prior to the June 25, 2025 update will receive Credit Level 1 (Temporarily Active).
* This is a temporary measure. Additional details regarding Credit Level adjustments for existing Maplers will be provided in a separate announcement.
### **2-3. Credit Level 2**
Accounts will automatically qualify for Credit Level 2 by satisfying at least one of the following verification requirements:
1. ID Verification (KYC)
2. Wallet accounts that complete ID Verification via [My page > Verifiacion](https://msu.io/mypage/verification) and obtain Verification Level 1.
3. Card Verification
1. Wallet accounts that successfully complete payment authentication using a VISA or MasterCard registered under the user's legal name.
* Credit Level 2 accounts have access to all services within MapleStory Universe.
* Card Verification requires a \$0 authorization check. This check is strictly for authentication purposes and does not incur any charges.
## **3. Re-verification**
We may request identity re-verification for wallet accounts suspected of having been verified through improper means or associated with abusive activity.
Accounts subject to re-verification will be temporarily restricted from all services until the process is successfully completed. Once identity is confirmed within the designated time frame, account access will be restored.
Re-verification will take place in the steps below:
* Users who receive a re-verification request must complete the process using either KYC or Card Verification.
* KYC re-verification
* When KYC is selected, the process will proceed based on your existing verification status:
1. If you previously completed KYC, you will be asked to perform selfie verification, which will be matched against your verified ID.
2. If you have not completed KYC before, you will go through the full KYC process, including submitting your ID and a selfie.
* Card Verification re-verification
* Re-verification using Card Verification requires completing authentication with a Visa or MasterCard (credit or debit) that supports payment authorization.
1. Re-verification must be completed within 14 days from the moment a verification method is selected. Failure to complete the process within this period will result in continued account restriction.
2. Users may attempt re-verification up to 3 times. If all attempts are exhausted, the account will remain restricted.
## **4. For more detailed information**
Please refer to the following resources:
* [\[Announcement on the Discontinuation of the Credit Level 1 System (Feb 26, 2026)\]](https://msu.io/news/notices/3386335)
* \[[Credit Level System Introduction](https://msu.io/news/notices/2984950)]
* \[[Credit Level FAQ](https://support.msu.io/hc/en-us/categories/13072792406543-Credit-Level)].
***
# MVP System
Source: https://docs.msu.io/welcome-to-msu/mvp-system
## **1. What is MVP?**
MVP is a system that converts fees paid within the MapleStory Universe ecosystem into NXPC units to assign ranks, providing various benefits based on your achieved rank.
Your spending is converted into NXPC-denominated points, and a rank from Bronze to Black is assigned based on your total points over the past 13 weeks.
You can check your MVP rank by connecting your wallet and navigating to [\[My page > Overview\]](https://msu.io/mypage).
### **1.1. What Benefits Does MVP Provide?**
The MVP System is designed to ensure that Maplers who actively contribute to the MapleStory Universe ecosystem are recognized and rewarded.
In MapleStory N, various in-game reward items are provided based on your MVP rank. For detailed benefit information, please refer to the \[[**MapleStory N MVP Guide**](https://docs.maplestoryn.io/msn-101/beginners-guide/features/maplestory-n-mvp-system)].
### **1.2. Differences Based on MVP Status**
| MVP Status | Rank | Token Transfer | Warp-Out | NFT / FT Transfer | MSU Marketplace |
| :--------- | :------- | :------------- | :------------ | :-------------------------------------------------- | :-------------------------------------------------------------- |
| Non-MVP | Unranked | Not Available | Not Available | Not Available | Character NFT purchase only. All other features are restricted. |
| MVP | Bronze | Available \* | Available \* | Verification Lv.0: Not Available / Lv.1+: Available | Full access |
| MVP | Silver | Available \* | Available \* | Verification Lv.0: Not Available / Lv.1+: Available | Full access |
| MVP | Gold | Available \* | Available \* | Verification Lv.0: Not Available / Lv.1+: Available | Full access |
| MVP | Diamond | Available \* | Available \* | Verification Lv.0: Not Available / Lv.1+: Available | Full access |
| MVP | Black | Available \* | Available \* | Verification Lv.0: Not Available / Lv.1+: Available | Full access |
* Daily limits for Token Transfer and Warp-Out are determined by your KYC verification level. Please refer to the \[[Verification Guide](https://docs.msu.io/msu-services/web-common-features#1-3-2-verification)] for details.
In MapleStory Universe, Token Transfer, Warp-Out, NFT/FT Transfer, and MSU Marketplace activity differ based on MVP status.
* Token Transfer (NXPC, NESO, USDT) and Warp-Out (NXPC, USDT) are only available to accounts with an MVP rank.
* NFT and FT transfers require both MVP rank and KYC Lv.1 or above.
* MVP accounts have full access to all Marketplace features, including buying, listing for sale, making offers, and placing bids.
* Non-MVP accounts can only purchase Character NFTs listed on the Marketplace. All other Marketplace features are restricted.
If your MVP rank drops to Unranked on a Thursday recalculation, you will no longer be able to buy, create new listings, make offers, or place bids from that point (Character NFT purchases excluded). However, existing listings, offers, and bids placed before the rank change will remain active.
Non-MVP accounts are restricted from Token Transfer and Warp-Out even if KYC verification has been completed.
## **2. How MVP Ranks Are Calculated**
| MVP Status | Rank | Points Required |
| :--------- | :------- | :---------------------- |
| Non-MVP | Unranked | 0 ≤ Points \< 30 |
| MVP | Bronze | 30 ≤ Points \< 750 |
| MVP | Silver | 750 ≤ Points \< 1,500 |
| MVP | Gold | 1,500 ≤ Points \< 3,500 |
| MVP | Diamond | 3,500 ≤ Points \< 7,000 |
| MVP | Black | 7,000 ≤ Points |
MVP ranks are determined by your total points accumulated over the past 13 weeks.
* Points are denominated in NXPC units (1 NXPC = 100,000 NESO).
* A minimum of 30 points is required to qualify for MVP status.
### **2.1. What Counts Toward MVP Points?**
MVP points are calculated based on spending across the MapleStory Universe ecosystem. The following activities count toward your points:
* Content fees and purchases related to MapleStory N
* Power Crystal purchases, Arcane Symbol enhancement, and more
* MSU Marketplace trade fees
* For Marketplace trades, MVP points are attributed to the buyer (the account that made the purchase), not the seller.
* MSU Web Shop purchases
Eligible spending types may be updated in the future. Any changes will be announced separately.
### **2.2. How Points Are Calculated**
Your points are updated each time eligible spending occurs. Only points from the past 13 weeks are counted, where one week is defined as Thursday through Wednesday.
Rank increases and decreases follow different rules:
* **Rank Increase:** Takes effect immediately when you meet the point requirement for a higher rank.
* **Rank Decrease:** Rank decreases are checked and applied every Thursday at 00:00 (UTC+0). If your 13-week total points at that time are below your current rank's threshold, your rank will be lowered.
**Rank Change Example**
* Current date: Friday, May 15
* Current MVP points: 0
* Current rank: Unranked\\
1. On May 15 (Fri), you spend 35 NXPC. Your total points become 35, which meets the Bronze threshold (30+). You are **immediately promoted to Bronze**.
2. The 35 NXPC was spent during the week of May 14 (Thu) - May 20 (Wed). This means those points will remain in the 13-week window until August 12 (Wed).
3. If no additional spending occurs by August 12 (Wed), the weekly recalculation on August 13 (Thu) will exclude the May 14-20 week. If the remaining points fall below 30, your rank will **drop to Unranked on Thursday**.
MVP only counts the past 13 weeks. As each new week begins, the oldest week drops off and those points are no longer counted. Maintaining your rank requires continued activity.
### **2.3. Checking MVP Rank Information**
You can view your current MVP rank status information on the [Overview](https://msu.io/mypage/overview) page.
The Overview page displays the following MVP information, updated in real time as your points change:
* **Current Points:** Your total points over the past 13 weeks.
* **Points to Keep Rank:** The extra points needed to maintain your current MVP rank after the upcoming Thursday recalculation.
* **Expected Rank:** Your expected MVP rank after the upcoming Thursday based on current points. If this differs from your current rank, a rank change will occur on the next recalculation.
You can monitor your points and MVP rank at any time and check in advance whether a rank change is expected on the upcoming Thursday.
***
# NESO & NXPC
Source: https://docs.msu.io/welcome-to-msu/neso-and-nxpc
**TL;DR.**
MapleStory Universe operates a dual-token system. NXPC is the native token of MSU — fixed-supply, used for asset creation and value exchange across the ecosystem, and the token used to pay network fees on Henesys (NXPC's home blockchain network). It is also the asset against which the quarterly burn operates. NESO is the on-chain in-game currency — used for item enhancement in MapleStory N and for transactions on the Marketplace, and minted at a 1:1 ratio from NESOLET (the unminted form earned through gameplay activities like hunting monsters or clearing bosses). NESO and NXPC are convertible at a fixed swap ratio of 100,000 NESO : 1 NXPC via the SWAP & WARP service.
**Why two tokens**
The split keeps short-term gameplay volume from distorting the value layer: high-frequency in-game transactions clear in NESO, while NXPC captures ecosystem value, governs the on-chain marketplace, and is the asset that scales with the burn mechanism. NXPC can be acquired three ways: through gameplay (earn NESO, then swap), through SWAP & WARP if you already hold NXPC on another chain, or directly through the on-ramp service (Transak and Mercuryo) for fiat purchases by credit card.
## **1. What is NESO?**
**NESO** is an **on-chain currency** used within **MapleStory Universe**.\
It is used to **enhance items** in **MapleStory N** and to conduct **transactions** on the **Marketplace**.
You can obtain NESO by **minting NESOLET**, and the two currencies have distinct icons, as shown below:
| **Icon** | **Name** | **How to Get** |
| --------------------- | ------------- | --------------------------------------------------------------- |
|
| NESO
| NESO can be obtained by minting NESOLET or swapping NXPC.
|
|
| NESOLET
| NESOLET can be obtained by playing in-game contents.
|
### **1.1. Earning NESO Through Gameplay**
You can obtain NESO by minting NESOLET, which is earned through various in-game activities such as hunting monsters and clearing boss content.
* NESOLET in its unminted state cannot be used for item enhancement or trading, so be sure to mint any NESOLET you acquire!
* The total amount of NESOLET and NESO you have accumulated is displayed at the bottom of your character’s inventory.
* You can view detailed values via the tooltip and use the NESO button at the bottom of the inventory to mint your NESOLET into NESO.
* The conversion rate from NESOLET to NESO is **1:1**.
- NESOLET is a character-bound currency and cannot be used by other characters in your wallet until it is minted.
- Only the character that completed the minting process can mint NESOLET into NESO. For more details, please refer to the \[[Manage Character Guide](https://docs.maplestoryn.io/msn-101/beginners-guide/get-started/manage-character)].
### **1.2. Earning NESO via SWAP & WARP**
If you have NXPC in your wallet, you can swap it for NESO using the **SWAP & WARP** feature.
Once the swap is complete, the converted NESO can be used on the MSU Marketplace, and if you play the game using the same wallet, it can also be used in-game.
Only minted characters can use the Wallet Inventory and perform item enhancements in MapleStory N. For more details, please refer to the respective guides.
### **1.3. Using NESO**
You can use NESO to:
* Purchase NFT items, characters, and consumables from the MSU Marketplace
* Exchange for Power Crystals, used for Star Force Enhancement of NFT items
* Exchange for Power Crystals, used to grant or reset Potential on NFT items
## **2. What is NXPC?**
NXPC is the native token of MapleStory Universe, powering asset creation and value exchange throughout the ecosystem.
You can acquire NXPC by swapping it with NESO earned from playing MapleStory N.
* The NESO:NXPC swap ratio is 100,000:1.
* Swapping NESO for NXPC may incur gas fees, depending on conditions.
* For more information, please refer to the \[[SWAP & WARP Guide](https://docs.msu.io/msu-services/swap-and-warp)].
### **2.1 Purchasing NXPC with Fiat Currency**
Our On-Ramp service enables you to buy NXPC (Henesys Chain) directly with fiat currencies, using payment methods such as a credit card.
Once purchased, you can immediately swap your NXPC for NESO or use it to reach Credit Level 1.
* Please note that all On-Ramp purchases are processed directly by the provider. NEXPACE does not handle or store any payment information.
* This service is currently offered through Transak and Mercuryo. Additional providers may be added in the future.
To get started, connect your wallet, click the 'Buy NXPC' button found on the following page, and select your desired provider:
* MapleStory Universe > My page > Overview > Asset Status
* MapleStory Universe > My page > Credit Level > Level 1 Criteria
* Swap\&Warp > Swap > NXPC
On the ‘Buy Crypto To Your Wallet’ screen, select your desired fiat currency and payment method to continue.
You may be asked to complete a KYC verification, depending on the transaction amount. You will be able to review applicable transaction fees before finalizing your purchase.
For detailed information on supported countries, currencies, fees, and payment methods, please consult the provider's official documentation, as these may vary.
| **Transak** | **Mercuryo** |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| - [How to Buy Crypto on Transak](https://www.google.com/url?q=https%3A%2F%2Fsupport.transak.com%2Fen%2Farticles%2F7846055-buying-crypto-at-transak)
- [Transak Fees & Payment Methods](https://www.google.com/url?q=https%3A%2F%2Ftransak.notion.site%2FOn-Ramp-Payment-Methods-Fees-Other-Details-b0761634feed4b338a69f4f186d906a5)
- [Transak's Global Coverage for KYC](https://www.google.com/url?q=https%3A%2F%2Ftransak.com%2Fglobal-coverage)
| - [How to Buy Crypto on Mercuryo](https://help.mercuryo.io/hc/en-gb/articles/26358055883165-How-do-I-buy-cryptocurrency-using-Mercuryo)
- [Mercuryo Payment Methods](https://help.mercuryo.io/hc/en-gb/articles/14495565199133-What-payment-methods-are-supported-with-Mercuryo)
- [Mercuryo's Supported Fiat Currencies](https://help.mercuryo.io/hc/en-gb/articles/14495507502749-Which-fiat-currencies-are-supported)
|
For any issues or inquiries that arise during the purchase process, please contact [Transak Customer Support](https://support.transak.com/en/) for assistance.
For any issues or inquiries that arise during the purchase process, please contact [Mercuryo Customer Support](https://help.mercuryo.io/hc/en-gb) for assistance.
***
# Advanced Security
Source: https://docs.msu.io/welcome-to-msu/security/advanced-security
## **1. What is Advanced Security?**
* Two-Factor Authentication must be enabled to access these additional security features.
* Once **Two-Factor Authentication is** enabled, you can lock Warp-Out and Transfer transactions to block outgoing transfers.
* When a feature is locked, all outgoing transfers from the wallet on the Henesys Chain are blocked, helping protect your assets from unauthorized transfers if your account is compromised.
### **1.1. How to Use the Lock Feature**
1. To use the Lock feature under Advanced Security, Two-Factor Authentication must be enabled. First, check your Two-Factor Authentication status under Account Security. [\[Guide\]](https://docs.msu.io/welcome-to-msu/security/two-factor-authentication)
2. Once Two-Factor Authentication is enabled, Advanced Security’s ‘Warp-Out Lock’ and ‘Wallet Transfer Lock’ features become available. Both are unlocked by default.
3. Click the ‘Lock’ button on the feature you want to lock. This activates a locked state that blocks that feature.
OTP verification is required to unlock a feature.
### **1.2. Manage Trusted Wallet Addresses**
* You can register trusted wallet addresses as exceptions that can still receive transfers while a feature is locked.
* You can register up to five trusted wallet addresses for each feature while it is locked.
* ‘Trusted Wallet Address’ entries remain available for transfers even when Wallet Transfer Lock is active.
* If your currently connected wallet address is registered under ‘Warp-Out Lock’ as a ‘Trusted Wallet Address’ and your account is compromised, an attacker could warp out your wallet’s assets to another network without any additional verification. Please proceed with caution.
OTP verification is required to update and save your trusted wallet registration.
***
# Permissions
Source: https://docs.msu.io/welcome-to-msu/security/permissions
## 1. What is Synergy App & Services?
Synergy Apps can be granted permission to use certain MSU features, allowing Maplers to take advantage of useful functions within those apps. For example, an exchange-related service app may request permission to access MSU Marketplace search functionality.
When a Synergy App requests permissions, the list of requested permissions is displayed on the consent screen. Maplers can choose to allow or deny each permission.
To grant access permissions to a Synergy App or service, you must be logged in to MSU. If your MSU account is deleted, all associated Synergy App connections will also be removed. Deleting a Synergy App account does not affect your MSU account.
### 1.1. Allowing Permissions
* **How to Allow Permissions**
* When a permission request page appears for a Synergy App or service, carefully review the request to understand what information and permissions are being requested.
* Approve the request to grant the Synergy App or service access to your information or features.
**Important**
* Exercise caution when allowing permissions for services developed by companies or developers other than MSU. Only grant permissions to services you trust. \
(Reference: MSU Builder Apps — [https://msu.io/builder-apps](https://msu.io/builder-apps))
* Allowing 'Asset Access Permission' in a Synergy App or service may compromise your account security. Always exercise caution when granting permissions, whether on screens provided by MSU or any other screen.
* **Scope of Access for Synergy Apps and Services**
* Synergy Apps and services can only access the data and permissions you have allowed.
* For example, if you grant a Synergy App permission to search MSU Marketplace, the app will only be able to search MSU Marketplace.
* For example, if you grant a Synergy App enhancement permission, the app will be able to enhance your items using the Power Crystals held in your account.
### 1.2. Managing Permissions
* The list of permissions you have granted can be viewed at any time under Synergy App & Services in your MSU account settings.
* Permissions granted to a Synergy App can be revoked at any time.
* Revoking a permission does not remove any features already used or data already stored by the app during the period when the permission was active. For more details, refer to the privacy policy of the relevant Synergy App.
## 2. Allow MSU Asset Access Permission
### 2.1. Settings
* **Allow MSU Asset Access Permission**: You can toggle between Allowed and Not Allowed.
* Granting access enables full use of the following MapleStory Universe service:
* MapleStory N: On-chain actions like item enhancement and minting
* MSU Marketplace: Trading items and characters
* Swap & Warp: NESO \<-> NXPC swapping and bridging services
* If set to Not Allowed, these features will be inaccessible.
\*\* \*\*
***
# Two-Factor Authentication
Source: https://docs.msu.io/welcome-to-msu/security/two-factor-authentication
## **1. What is Two-Factor Authentication?**
* Two-factor authentication is an extra layer of security that verifies your identity through an additional method beyond wallet connection.
* MapleStory Universe provides a two-factor authentication service using OTP (One-Time Password) to enhance account security.
* When enabled, you must authenticate through the authenticator app on your registered smartphone before accessing platform services, reducing the risk of unauthorized external access.
* We strongly recommend enabling two-factor authentication on all accounts for enhanced security.
### **1.1. How to Enable Two-Factor Authentication (OTP)**
1. Navigate to My Page > Security, then click 'Enable' under 'Two-Factor Authenticator' in the Account Security section to begin activation.
2. When redirected to the two-factor authentication activation page, follow Step 1 to install the 'Google Authenticator' application on your smartphone using the QR code.
3. Launch the 'Google Authenticator' application and use the 'Scan QR code' feature to scan your unique QR code displayed in Step 2. (Alternatively, you can use the 'Enter setup key' feature to manually input the Manual entry code.)
QR images and Manual entry codes are unique to each user, so please check your activation page.
4. Find the 6-digit code for MapleStory Universe and enter it in the Step 3 field.
5. Once activation is complete, the Account Security section will display 'Activated' status.
### **1.2. How to Configure Two-Factor Authentication (OTP) Settings**
* Two-factor authentication (OTP) can be selectively applied to the following features:
* When a feature is toggled on, OTP authentication will be required to use it.
* When initially enabling two-factor authentication (OTP), it is automatically applied to 'Wallet Connect'. At least one feature must be enabled when two-factor authentication is in 'Activated' status.
* To disable (Toggle-off) a feature that currently has two-factor authentication applied, OTP verification is required to confirm the change.
| **Two-Factor Authentication Features** | **Notes** |
| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wallet Connect | |
| MSU Marketplace | |
| Warp-Out | This feature is not available when connected with a social account. |
| MapleStory N Launch | This feature is not available for builder accounts. |
| Wallet Transfer Lock | When toggled on, this feature operates as a lock without requiring OTP authentication, blocking Transfers. Even while locked, you can register up to 5 trusted wallets to allow transfers. |
###
### **2. How to Use Two-Factor Authentication (OTP)**
* When attempting to use a feature with two-factor authentication (OTP) enabled, the OTP verification screen will appear.
* Enter the 6-digit OTP code from your registered device to authenticate. Successful authentication is required to proceed with the requested action.
* You have up to 5 authentication attempts. After 5 failed attempts, OTP authentication will be temporarily restricted.
* If you check 'Skip authentication for this wallet connection' before successfully authenticating, all OTP verifications will be skipped for the currently connected wallet.
* This skip feature only applies while the wallet connection is maintained. For security purposes, it is recommended only for use on personal devices.
* Authentication skip does not apply to security settings such as disabling two-factor authentication.
* Wallets with skipped authentication can be reset on the Security page, which will remove the skip status.
### **2.1. How to Reset Two-Factor Authentication (OTP)**
* If OTP authentication becomes unavailable due to issues with your personal smartphone, click 'Having trouble with authentication?' on the OTP verification screen to begin the two-factor authentication reset process.
* To reset two-factor authentication, you must successfully verify your identity through either email verification or card verification.
* Card verification is only available when registered card information exists for the account, and you must provide the same card used for authentication.
Upon successful reset, two-factor authentication will be disabled for the account.
***
# The Ecosystem: MapleStory Universe
Source: https://docs.msu.io/welcome-to-msu/the-ecosystem-maple-story-universe
MapleStory Universe is a Virtual Worlds ecosystem designed to host a variety of applications built on the backbone of the MapleStory IP. This ecosystem serves as a hub for creativity, collaboration, and community engagement, supported by integral components that form a comprehensive ecosystem.
MapleStory IP boasts over 250 million+ registered users globally. With its various content and extensive resource pool from 22 years of live operations, MapleStory has built a robust ecosystem filled with items that can be NFTized and strong community features, equivalent to 5B+ USD lifetime revenue, making it ideal for blockchain integration.
Spearheaded by industry veterans who’ve developed multi-billion-dollar franchises, including MapleStory, Mabinogi and Dungeon & Fighter, the MapleStory Universe has 100+ employees globally supporting the project.
MapleStory Universe is expanding the ways players interact with game IPs, broadening the user base and ensuring the longevity of the IPs for decades to come. It is committed to creating an ecosystem where players are not just consumers, but co-creators among the ecosystems.
***
## **FAQ**
**Q. What is MapleStory Universe?**
**A.** MapleStory Universe is a Virtual Worlds ecosystem designed to host a variety of applications built on the backbone of the MapleStory IP. It combines a 22-year-old MMORPG (250M+ registered users globally, 5B+ USD in lifetime revenue) with on-chain ownership, a dual-token model (NXPC and NESO), and a builder layer including MapleStory N, Synergy Apps (community-built applications that plug into MSU), the MapleStory SDK, and Reactor. NEXPACE — an Abu Dhabi-based affiliate of Nexon — is the operating entity, with 100+ employees globally.
**Q. Who builds MSU?**
**A.** MSU is spearheaded by industry veterans behind multi-billion-dollar gaming franchises including MapleStory, Mabinogi, and Dungeon & Fighter. The wider ecosystem brings in independent builders and partners through the up-to-US\$50M NEXPACE Ecosystem Fund and the MapleStory SDK, which lets third-party teams build standalone applications using MapleStory IP primitives.
**Q. Who participates in the MSU ecosystem?**
**A.** Three groups: players (engaging via MapleStory N and other Synergy Apps, optionally interacting with on-chain features); creators and builders (using the MapleStory SDK and Synergy Apps platform to develop content, games, and tools on MSU); and ecosystem partners (infrastructure, distribution, and integration partners). The MSU vision is for participants to operate as co-creators of the ecosystem rather than as consumers of a single product.
**Q. How is MSU different from other Web3 games?**
**A.** MSU starts from a 22-year-old MMORPG with an established economy and player base — most Web3 games start from zero. NXPC is governed by a fixed 1 billion supply, a halving emission schedule (new rewards reduce cycle by cycle), and a revenue-linked quarterly burn that removes 20% of platform revenue from circulation — designed to avoid the supply-driven collapse common to first-generation play-to-earn tokens. The Reactor's Fusion and Fission mechanics introduce protocol-level NFT-to-NXPC conversion, regulating supply through market behaviour rather than developer intervention.
***
# Wallet Connect
Source: https://docs.msu.io/welcome-to-msu/wallet-connect
To access MapleStory Universe services, you must first link your wallet
All services provided by MapleStory Universe require wallet connection, and connecting your wallet is also mandatory to download and play MapleStory N.
## **1. Creating a Wallet**
To connect to MapleStory Universe, Maplers need a crypto wallet. If a wallet has not been set up yet, follow the steps below to create one. For more information on what a wallet is, refer to \[[Learn More About Wallet](https://support.msu.io/hc/en-us/categories/12737191640463-Wallet)].
| **MapleStory Universe links all NFTs and FTs you own to your wallet.** |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| - Please keep in mind that all assets within the wallet account created for using MapleStory Universe must be managed by yourself only.
- Since MetaMask and Web3Auth are self-custodial wallet services, neither NEXPACE nor the wallet providers can manage or control your wallet. Only you have access to it. To keep your digital assets secure, you must safely store your sensitive information, such as your recovery phrase, private keys, or PIN code, in a place that only you can access.
- NEXPACE, MetaMask, and Web3Auth cannot restore any loss caused by misplacing or losing your private keys, Secret Recovery Phrase, or PIN code.
|
## **2. Signing up with a social account**
1. Click the Connect button at the top right corner of the MSU website.
2. Select Google, X, or Apple.
3. Once you complete the social login and the signature request, a Web3Auth wallet will be created automatically and linked to your MapleStory Universe account. You can start using the service immediately.
## **3. Signing up with a MetaMask wallet**
If you want to log in with MetaMask but the MetaMask extension is not installed
Please refer to the guide titled “How to log in with MetaMask when the extension is not installed” for QR login instructions.
### **3.1. Creating a MetaMask Wallet**
1. Visit [Download MetaMask: The Premier Blockchain Wallet App and Browser Extension](https://metamask.io/download/) and install it.
2. Launch MetaMask.
3. Once you have launched it, click Create Wallet.
4. Set a password.
5. Set up your secret recovery phrase.
6. List out your secret recovery phrase in the correct order to verify it.
7. You are all signed up!
### **3.2. Connecting a Wallet**
* Click the Connect button at the top right corner of the MSU service website.
* Select MetaMask.
* Sign the request to complete the wallet connection.
If you have completed wallet creation or already have a MetaMask wallet, you can connect your wallet to MapleStory Universe to create an account.
### **3.3 Connecting a MetaMask Wallet**
1. Click Connect Wallet.
2. Click Continue with MetaMask.
3. Sign and continue to connect your wallet.
If you wish to manually add the Henesys Mainnet on MetaMask, you can do so by following the steps and information provided below.
On the MetaMask main screen: \[Select a network > Add a custom network]
* Network : Henesys
* Network(RPC) URL : [https://henesys-rpc.msu.io](https://henesys-rpc.msu.io)
* Chain ID : 68414
* Symbol : NXPC
* Block explorer URL : [https://msu-explorer.xangle.io/](https://msu-explorer.xangle.io/)
***