Hello Creators,

Please see the January 28 MapleStory Worlds patch update information below. You can find the Player version of the Patch Notes here.

Patch Information

Time:
- UTC: Wednesday, January 28 at 22:00 to Thursday, January 29 at 01:00
- PST (UTC -8): Wednesday, January 28 at 14:00 to 17:00
- KST (UTC +9): Thursday, January 29 at 7:00 to 10:00
- Type: Patch Update Maintenance (26.1.0)

Table of Contents

Service & App Updates
Bug Fixes

Service & App Updates

General

Changed the MapleStory Worlds App Update Version format.
- App version will be standardized to use the update year and month.
- Ex: January 2026 Update → Update Version: 26.1

Added a New status value “Blind” to avatar products.
- Blind refers to a status in which a product is hidden from the Avatar Shop listing while it is under review for potential violations of operational policies.
- Avatar products in a Blind state cannot be sold and may be converted to permanent sanctions depending on the review results.
- The status of avatar products can be checked on the official website under [Create Avatar Products].

Notifications are now sent when players get free World Coins, which are awarded for events or when certain conditions are met.

Added Japanese data settings in the “Create World” feature.
- Enabled Japanese language in notifications, translation management, settings, and more on both the official website and within the app.
- ✔ Official Website:
  - [Notification Delivery Management]
  - [Translation Management]
  - [Settings – Supported Languages] under World Creation
- ✔ App:
  - Language field added to the basic information on the World details page
  - [World Play – World Language] menu
  - Maker settings: [Release] and [WorldConfig – SourceLanguage]

Added AI tags to the avatar category in the Resource Finder.

Made improvements to allow <a> tag to be used within notifications.

Platform

Expanded the profile code issued when creating a profile from 5 to 6 digits.

Added the “World Insight” menu for Creators to view world-specific metrics and more.
- You can find the link under Create World → Private World/Group World → World Details.

MSW MCP will be added to help you develop in MapleStory Worlds.
- Creators can use MCP after issuing an API key from the World Insight menu.
- ✔ Instructions:
  - [World Insight] - Credentials - API Key Menu.
  - Click [+ Generate] on top right corner - Select MCP and receive API KEY.
  - In a tool where you can use MCP (Ex: VS Code), set MSW MCP.

Improved the system to block avatar product registration and display an error message if a Creator is attempting to register an avatar product that contains elements violating the operational policy.
- If Creators attempt to register an avatar product that includes elements that violate the policy, the product may be subject to permanent restrictions, along with graduated restrictions on product releases and cashouts based on the number of violations.

Lobby & Play

Added a feature to invite group members.
- You can invite members by searching in the group details page > Invite Members > Search and using either profile name or profile code.

You can revoke an invitation from the group details page > Sent Requests tab.

You can view the group invitations you've received in the Groups menu > Requests Received tab.

You can see a list of groups you've sent join requests to in the Groups menu > Sent Requests tab.
If you already know the group code for the group you want to join, you can click the Groups menu > Sent Requests > Join to send a join request with the Group Code button.

The number of Worlds displayed per row on the Lobby screen will be increased from 5 to up to 10, depending on the app’s screen size.

Japanese will be added to the list of supported languages for automatic translation.
- Automatic translation is available when a language is selected via [Menu – World Language] within a World.
- Creators can choose which languages to support for their World from the list of supported languages on the platform.
- Language options for which the Creator does not support will be offered and labeled as automatic translation.

Maker

Added an AI assistant, Madex, to help Creators develop in MapleStory Worlds.
- Use Guide
  - Click the AI Assistant (Preview) button within the Maker.
  - Select the desired model: Maple/May-I
    - Maple (Script Specific Model)
      - Describe the functionality you want to create, and it will create the script for you using mlua.
    - May-I (RAG-Based Universal Model)
      - Provides answers based on official documentation.
  - Enter a request and view the generated answer.
  - Apply the script immediately with the Execute Code button.
- As of the 26.1.0 update, the AI Assistant is limited to 30 uses per hour and 1,000 uses per day.
- The AI's responses may occasionally contain inaccurate information, so please double-check any important details.
- Created scripts can be applied immediately; however, there is no rollback feature to revert changes after application. Therefore, if you are modifying critical code, please back up and store the existing code in advance, and take care to avoid incorrect modifications due to inaccurate content.

Replaced the existing "High DPI" setting with a UI size scale setting in the Maker.

Hold down the Shift key while rotating an Entity to rotate it in 15-degree increments.

Changed Polygon-type colliders to be editable as handlers in the Model Editor.

Auto-scroll stops when you select Log in the Console window or adjust the scroll position above the bottom.
- It will work again when you move the scroll back to the bottom.

Entities in the Hierarchy can now be dragged into the Property Editor and Script Editor for reference.

Some entries in the Workspace, such as Model, Material, and Logic, can also be dragged for reference.

Increased the maximum Scale value from 3x -> 5x in the Maker UI Editor.

Added a menu in Scenes to control the visibility of 2D Light features.

Improved the ‘Collider Auto Fitter’ feature that automatically generates Colliders to fit the shape of a sprite.
- Also added the Collider Auto Fitter feature found in PhysicsColliderComponent to the following components.
  - TriggerComponent
  - HitComponent
  - InteractionComponent
- You can also use the Collider Auto Fitter feature when the ColliderType is Box or Circle.
- You can control how close the collider fits to the border using the ‘Concav’ if the ColliderType is Polygon.

Concav. = 1 (Perfect Shape for Borders)

Concav. = 0 (Rounded Shape)

You can assign conditional expressions, log messages (whether the code continues to run), and enable/disable BreakPoints in the Maker.

Improved the following for Worlds using Local Workspaces:
- If you try refreshing the Maker when scripts with the same name exist in different folders locally:
  - You won't be able to refresh. Instead, you'll see a message saying "There are multiple entries/entities with the same name. Please change the name in the local environment and refresh."
- If you load a World with mlua of the same name in different folders locally:
  - Duplicate mlua names in the Maker will be fixed temporarily. (This doesn't actually change the name of the local file. It just looks different in the Maker.)
  - You'll see a message saying "There were multiple scripts with the same name, so the names were temporarily changed in Maker. Please change the name in the local environment and refresh."

Components can now be added to entities by dragging them onto an empty space into the property inspector.

When you rename a script from the script editor, the input field in the rename window will be populated with the target name you want to change.

Changed the Property order of DamageSkinSettingComponent.

API

Added a new Method, Attribute InspectorButton, to allow Script Methods to be created and executed as buttons in the Property Inspector.

Added a property to TextRendererComponent, TextGUIRendererComponent.
- FaceDilate
  - Sets the outline position. If the value is 0, it matches the original font's outline. Negative values represent thinner lines, and positive values represent thicker lines.
- FaceSoftness
  - Set the softness of the edges. The higher the value, the softer and more blurred the corners. This setting applies to both body and outline.
- UnderlayDilate
  - Sets the outline position of shadows. If the value is 0, it matches the original font's outline. Negative values represent thinner lines and positive values represent thicker lines.
- UnderlaySoftness
  - Set the softness of the edges of shadows. The higher the value, the softer and more blurred the corners.

Added a Method to get the borders of a sprite to UtilLogic and a Method to calculate the Convex and Concave Hull.
- GetSpriteEdgePoints
- ConvexHull
- ConcaveHull

Added Property to Foothold.
- GroupID
  - This is the group ID that the foothold belongs to, and it’s granted when saving a foothold.
- SortingLayer
  - When two or more entities overlap, the order of priority is determined according to the Sorting Layer.
- FootholdWalkSpeedFactor
  - The coefficient is multiplied by the movement speed when the Entity with RigidbodyComponent is on the foothold. The greater the value, the faster the movement.
- FootholdForce
  - A force is applied to the Entity containing a RigidbodyComponent on the scaffold. If positive, the force is applied to the right, and if negative, to the left.
- FootholdDrag
  - A friction force is applied to an Entity containing a RigidbodyComponent on the scaffold. The larger the value, the faster it decelerates.
- IsBlockVerticalLine
  - Determines whether the Entity is blocked by vertical footholds in its TileMap. Only pertains to Entities with RigidbodyComponent.

Added a Light Component.

Changed the output of some particles in the BasicParticleComponent.
- BigExplosion
- SmallExplosion
- BigSplash

Added new components and services, OverlayLightComponent and OverlayLightService, that allow you to express 2D lighting effects.

Improves the value of a component's SyncTable Property to be modifiable through the Property panel.

Improved the Entity name mismatch error message in SpawnLocationComponent.
- The error message better explains the situation and identifies which Entity is causing the problem.

Changed the OnBeginPlay timeout for Components and Logic from 10 to 20 seconds.

Removed the following deprecated or unused events from Maker and documentation.
- EmbededSpriteAnimPlayerStartEvent
- EmbededSpriteAnimPlayerEndEvent
- EmbededSpriteAnimPlayerChangeFrameEvent
- EmbededSpriteAnimPlayerChangeStateEvent
- SpriteAnimClipContainerEvent
- SingleSpriteContainerEvent
- DisplayClearEvent
- SingleSpriteDecoderEvent
- SingleSpriteChangeOffsetEvent
- RequestStateActionLoadEvent
- StateActionLoadResultEvent
- SpriteAnimPlayerDecodeEvent
- SpriteAnimPlayerChangeStateEvent
- AnimClipEventTagFrameEvent
- SpriteAnimPlayerForMonoStartEvent
- SpriteAnimPlayerForMonoEndEvent
- SpriteAnimPlayerForMonoChangeFrameEvent
- SpriteAnimPlayerForMonoChangeStateEvent

Added ShortCode, a short string that can be used as an identifier for the World instance, to WorldInstanceInfo.

Improved Pivot settings to be available in the context menu of My Resources.

Added the feature to adjust the PlayRate when using AnimationClip on SpritePattern and PolygonSprite materials.

Deleted SpriteGUIRendererComponent from NativeModel - UITextGUIRenderer.
- TextGUIRendererComponent, TextGUIRendererInputComponent can now be used without SpriteGUIRendererComponent.
  - ‼️Advanced Guidance Information
  - If you are using a script to add a model to the UITextGUIRenderer (AddModel), you will need to add a SpriteGUIRendererComponent (AddComponent) as well.
  - In the existing UITextGUIRenderer model, the default value of SpriteGUIRenderComponent Color is (0,0,0,0). After the patch, the default value of the SpriteGUIRendererComponent is changed to the default value (White) of the SpriteGUIRenderComponent, not the model, because the SpriteGUIRendererComponent is removed from the model.
    - To avoid this, you need to modify the color value to a value other than (0,0,0,0)-- for example, (1,0,0,0).

Added a new ScreenTransitionService with the screen transition feature.
- You can set a Fade In/Fade Out effect when changing the map.
- You can run the Dissolve effect.

Added a feature that admits Creators to a specific World instance of the TeleportService.
- They can be admitted even if the World instance is at full capacity.
- WarpAdminToWorldInstanceAndWait
- WarpAdminToWorldInstanceAsnc

Changed the duration value of the CameraComponent:ShakeCamera( ) function to not work if it is 0 or a negative value.

Changed the reflection rule between directory entries and local folders via Refresh in the local workspace as follows:
- Before
  - Creating a folder locally and refreshing it in the Maker does not create directory entries.
- After Change
  - Creating a folder locally and refreshing it in the Maker creates directory entries.
  - If there is no folder in the local workspace, unnecessary .directory meta files that previously remained will now be automatically deleted.

Added MakeNativeTween functions to TweenLogic.

Added SetAlpha functions to SpriteRendererComponent.

Added SetAlpha functions to SpriteGuiRendererComponent.

Added Sprite to the BackgroundComponent Type.

Added BackgroundComponent FitWithAspect option.
- When this option is enabled, the background image will be resized to fit the game screen.
- Only Web and Sprite types are affected by this option.

Deleted the RigidbodyQuartviewJumpEvent.
- ‼️ If you are using RigidbodyQuartviewJumpEvent, please replace it with RigidbodyKinematicMoveJumpEvent.

Added profanity filtering to text-related components. You can enable profanity filtering by setting the EnableProfanityFilter property to true.
- TextComponent
- TextRendererComponent
- TextGUIRendererComponent
- ChatBalloonComponent

Added a new SetClientTimeScale function to UtilLogic, allowing control over the app’s time flow.

When an AIComponent is destroyed, the value of the BTNode’s ParentAI property will be set to nil.
- ‼️ Notes:
  - If you continue to use the same Behavior Tree or any BTNode included in it after the AIComponent has been destroyed, scripts that reference ParentAI may not function correctly.
  - Please add logic to check whether the ParentAI property value is nil.

Optimization

Improves the performance of server Lua Scripts.

Improved performance of the table.clear and table.initialize functions.

~~When remaking a World as a Group World, the initial save step will be skipped to improve speed.~~
- (Updated Jan 28) This change has been excluded from the 26.1.0 update following the discovery of additional items requiring review during implementation.

Bug Fixes

Lobby & Play

Fixed the issue where the app would occasionally launch at a resolution different from the one most recently set.

Fixed the issue on iOS where changing the app language would occasionally prevent logging out of the app.

Fixed the issue where the tab navigation button (>) in the Avatar Shop did not function properly.

Fixed the issue where searching for a World containing a ‘#’ would give a network error pop-up.

Fixed the issue where entering an invite code in the Friend Invitation Event would incorrectly treat the user as an already invited player.

Maker

Fixed the issue where the PlaceHolder would not be cleared while entering text into a TextInputComponent in the play environment.

Fixed the issue where the image would display when changing the Enable of the ScrollLayoutGroup component to false.

Fixed the issue where importing an existing animation and then clicking New to create and save a new animation would overwrite the default imported animation.

Fixed the issue of being able to make selections when the layer is locked.

Fixed the issue in the Virtual Player window where hotkeys can launch windows other than Property, Hierarchy, and Console.

Fixed the issue in the Property editor where the names of the key and value of a Dictionary would sometimes appear truncated.

Fixed the issue where, when changing the text of a TextComponent, the change would not be reflected if there was a TextInputComponent in the same Entity with a disabled state.

Fixed the issue where the width and height properties of the child Entity's UITransformComponent are disabled in the Property Editor panel even if the Type is Horizontal or Vertical instead of Grid in the ScrollLayout Component.

Fixed intermittent reflection when using Add/Remove Component of a model in the Property editor.

Fixed the issue where changing the Group order in the UI Groups panel would not change the order in the Hierarchy panel.

Fixed the issue where the Scene panel was sometimes focused instead of the Play panel when clicking Maximize Scene after play.

Fixed the issue of truncation of quickinfo and signature helpers in the script editor when they have a lot of content.

Fixes misalignment of child Entities when the GridView is resized.

Fixed the issue of RenderComponent's SortingLayer being changed when entering the Model Editor.

Fixed the issue where a pop-up would appear when creating a new animation clip after loading an existing animation in the AnimationClip Editor.

Fixed the issue where the font of a NameTagComponent would be applied as a Maker-specific font within the Maker.

Fixed the issue where, when editing an Animation Clip via a JSON file, changes were intermittently not applied.

API

Fixed an issue that causes the Lua profiler call tree to be generated incorrectly.

Fixed the issue where changes to material properties were not reflected when using certain material types in the ScrollLayoutGroupComponent child UI.

Fixed behavior of SkeletonRendererComponent and SkeletonGUIRendererComponent-related events.
- Fixed SkeletonAnimationStartEvent and SkeletonAnimationEndEvent being triggered multiple times when the AnimationNames Property is modified or a new animation is added with the AddAnimation method to an empty track.
- Fixed the issue where the wrong AnimationClip was being passed when a SkeletonAnimationEndEvent was raised by modifying the AnimationNames Property or calling the AddAnimation, SetAnimation, or ClearTrack methods.
- Fixed SkeletonAnimationStartEvent and SkeletonAnimationEndEvent being triggered multiple times when a SkeletonGUIRendererComponent is created.
- Fixed the issue where the value of the Time Property of SkeletonAnimationTimelineEvent would always be 0.

Fixed the issue where, when using the TextGUIRendererInput component, and the component is enabled, it would always be a RaycastTarget.

Fixed a crash when playing a single frame animation in a loop on a SkeletonRendererComponent or SkeletonGUIRendererComponent.

Fixed the issue where a Dynamic CustomFootholdComponent Entity could interact in different locations when using methods on a FootholdComponent.

Fixed the issue of the UITransformComponent's WorldPosition being incorrectly calculated before the screen size changes right after entering a world.

Fixed the issue where the Total Timer displayed in the Timer Service graph in MSW Profiler is the same as the Add Timer.

Fixed an issue where the Send Count of the Server Sync Property Count in MSW Profiler could be measured lower than it actually is.

Fixed the issue that could cause the workspace and local file structure being different when saving after moving a directory if there are directory entries with the same name in the local workspace.

Fixed intermittent teleportation when two CustomFootholdComponents share a point and are moved left and right relative to that point.

Fixed the issue where certain Materials would not release correctly when used in a SpriteGUIRendererComponent.

Fixed the issue of loading a sprite packed in Atlas when using the ResourceService:LoadSpriteAndWait( ) function, resulting in a different sprite than the one requested.

Fixed the issue where ScriptAssist - annotations could not be used for some types, such as DateTime and TimeSpan.

Fixed the issue where modifying the Property value of a SpriteRendererComponent would not be reflected correctly when SpriteRendererComponent.Enable is False.

IsWorldUI property from the API documentation that doesn't exist has been removed.
- ButtonComponent
- ScrollLayoutGroupComponent
- SliderComponent
- SpriteGUIRendererComponent
- TextComponent
- TextInputComponent
- YoutubePlayerGUIComponent

Thank you,

The MapleStory Worlds Team