MapleLegends Custom Client Mod Options

Last update: September 2025

MapleLegends client comes with some customizable options; changes to these can be done by editing Legends.ini, a settings file which can be found in your MapleLegends directory.

Changes made to Legends.ini will only reflect on the game clients opened after the changes are saved. They will not update your open client, if you have one.

Follows a list of all the currently available customizations, with a detailed description and a list of acceptable values for each.
Please note that this only includes client edits that players have agency on; we also have a lot of other client changes and improvements automatically applied.

To change a setting, you must find it in the file, and change the value written after the = symbol to the one of your choice (among the acceptable options).

• For example: HDClient = 0 will open your game as an 800x600 window.

Please note that changing anything on a line that starts with a ; will have no effect, as those lines are only comments and instructions.


HDClient

By changing this value, you will be able to switch between 3 game window resolutions: the default classic one, and two bigger screen options.

• HDClient = 0 [opens the game in an 800x600 window]
• HDClient = 1 [opens the game in a 1024x768 window]
  
• HDClient = 2 [opens the game in a 1366x768 window]

The default value for a new installation is 1.


Windowed

Changing this option will let you open the game in windowed mode or in full screen mode.
In-game, you can still toggle between the two options by holding ALT and then pressing ENTER.

• Windowed = true [the client will open as a window on screen]
  
• Windowed = false [the client will open in full screen]

The default value for a new installation is true.


DarkChat

Change this setting if you wish for the background color of your in-game chat to be darker.
A darker color may help with text readability, while the original lighter shade of gray is better is you prefer the UI to be less prominent on top of the game.

• DarkChat = true [the chat box will use a darker background]
• DarkChat = false [the chat box will keep the original lighter background]

The default value for a new installation is false.


DarkQuestAlarm

Much like the DarkChat, this option is about readability. Toggle its value to change whether the quest alarm window will show in the traditional semi-transparent grey tone, or if you prefer to use our custom dark mode version.


Regular light mode vs custom dark mode

• DarkQuestAlarm = true [the quest alarm window will sport a dark UI]
• DarkQuestAlarm = false [the quest alarm window will use the traditional UI]

The default value for a new installation is false.


StreamerMode

When enabled, this setting censors your Login ID, both in the login window and in the Cash Shop, to prevent accidentally showing it.

• StreamerMode = true [login ID is replaced by asterisks]
  
• StreamerMode = false [login ID is displayed as normal]

The default value for a new installation is false.


WeaponEffects

A lot of cosmetic weapon covers have big visual effects that may feel excessive for some players, yet may be appreciated by others.
This setting enables you to choose whether to view or hide most of these effects.


Weapon effects visible vs weapon effects hidden

• WeaponEffects = true [weapon visual effects are regularly displayed]
  
• WeaponEffects = false [weapon visual effects are hidden]

The default value for a new installation is true.


WeaponsBehindCharacter

Many two-handed weapons, especially Crossbows and 2H Swords, tend to cover a big portion of the character, while standing.
Toggle this setting to enable or disable two-handed weapons display behind the character instead.
Note: development of this setting is currently incomplete. Display may be incorrect for various weapons.

• WeaponsBehindCharacter = true [two-handed weapons appear behind your character while standing still]
  
• WeaponsBehindCharacter = false [two-handed weapons are held regularly]

The default value for a new installation is false.


SkipLogoAnimation

This setting enables or disables the logo animations that normally show right before being sent to the login window.

• SkipLogoAnimation = true [opening the client sends directly to the login screen]
  
• SkipLogoAnimation = false [the client displays the regular logo animation when opened]

The default value for a new installation is false.


AutoClearCache

Enables or disables the client ability to automatically clear parts of unused resources that are still sitting in the cache, thus potentially reducing memory usage during gameplay.
Useful if you experience crashes during bosses.

• AutoClearCache = true [the client will periodically perform a cache clean-up]
  
• AutoClearCache = false [the client will retain data in memory, the original behaviour]

The default value for a new installation is true.


FastLoading

When enabled, the client will initialize and load various resources in a parallel thread, while opening; this may speed up initial client launch times.
This setting may not be compatible with some computer configurations.
Should your client crash to desktop as soon as your selected character is entering the game, consider either waiting around 10 seconds in the login procedure, or turning this setting to false.

• FastLoading = true [the client will load resources in parallel while launching]
  
• FastLoading = false [the client will load resources before launching, the original behaviour]

The default value for a new installation is true.


Transition

Change this setting to switch between different speeds of map transition. This alters how fast the black screen will fade in/out while changing areas.

• Transition = 1 [classic slower screen fade]
• Transition = 2 [faster fading, similar to recent game versions]
  
• Transition = 3 [fastest fading, a custom MapleLegends option]

The default value for a new installation is 2.


InfiniteChatLog

If enabled, this setting allows your client to keep track of all the chat that happens during your game session, rather than keeping only the most recent 64 chat lines.

• InfiniteChatLog = true [the client keeps every chat message since your login]
  
• InfiniteChatLog = false [the client only keeps the latest 64 messages, the original behaviour]

The default value for a new installation is true.


ClickMode

If you prefer triggering NPCs and Merchants with one mouse click instead of two, then this setting is what you want to change.
You can choose whether to keep a vanilla double-click, or to apply the single click behaviour to either only NPCs or also Hired Merchants.

• ClickMode = 1 [classic: NPCs and Merchants require a double-click to open]
  
• ClickMode = 2 [NPCs require a single click to open]
  
• ClickMode = 3 [Both NPCs and Merchants require a single click to open]

The default value for a new installation is 1.


WhiteScrollPrompt

When enabled, this setting will show a special confirmation prompt when scrolling an item, via the Legendary Spirit skill, with White Scrolls in the inventory.
The value of the "use white scroll" checkbox is ignored, in this case.


The prompt allows you to choose whether to scroll with or without a WS, or to cancel the scrolling altogether.

• WhiteScrollPrompt = true [the special confirmation prompt is displayed]
  
• WhiteScrollPrompt = false [the checkbox in Legendary Spirit decides whether to use a WS or not]

The default value for a new installation is true.


CloseGameConfirmation

When this setting is enabled, a confirmation prompt is shown whenever you try to close the game, either via the Quit Game button, via Alt-F4, or via the X button in the corner of the game window.
It's a useful setting for players who want to prevent accidental client closures.

• CloseGameConfirmation = true [a prompt is shown to confirm the game closure]
  
• CloseGameConfirmation = false [the client closes normally without requiring confirmation]

The default value for a new installation is true.


FilterChatNotices

By default, MapleLegends already filters various system notifications (for example: "You have used up all of your arrows.", "You may not use the skill yet.") to let them display only once every two seconds each.
This may still be annoying for some players; for that reason, this setting allows you to completely disable the printing of those notifications.

• FilterChatNotices = true [chat notifications are completely disabled]
  
• FilterChatNotices = false [chat notifications appear up to once every two seconds]

The default value for a new installation is false.


AddMonsterLevelTag

Use this setting if you want monsters' name tags to include their level.
Only applies to the name tag under monsters in the maps.

• AddMonsterLevelTag = true [monster level is added to the name tag]
  
• AddMonsterLevelTag = false [only the monster name is shown]

The default value for a new installation is true.


RaiseDamageLines

This setting causes all damage lines above a monster's head to appear higher than normal, leaving more space for buff/debuff icons.
It's a useful setting in case you experience difficulty in keeping track of what a monster is affected by, during gameplay.

• RaiseDamageLines = true [damage lines appear higher than normal]
  
• RaiseDamageLines = false [damage lines appear at the default height]

The default value for a new installation is false.