Files
maplecontest/docs/integer-format.md

741 B

Integer Formatting Rules

MapleStory Worlds may serialize numeric properties as strings such as 1.0. This is valid numeric data, but it must never be used directly for UI entity names or paths because Card1.0 and DmgPop_1.0 do not exist.

  • Use self:IntStr(value) for every numeric suffix in a UI path or entity name.
  • Use string.format("%d", math.floor(value or 0)) or FormatNumber for an integer shown in UI text.
  • Do not concatenate tostring(number) into a /ui/... path.
  • tools/deck/gen-slaydeck.mjs normalizes exact integer strings such as 0.0 to 0 when regenerating Global/common.gamelogic.

Run this check after editing card-controller UI paths:

node tools/verify/integer-format.mjs