Skip to content

Custom map names

Lactozilla requested to merge custom-map-names into next

Backwards compatible:

  • Levels 1 to 1035 are named MAP01 to MAPZZ

Backwards incompatible:

  • Do not use level 1100 in G_ExitLevel or G_SetCustomExitVars; use "SCENE_TITLE" instead.
  • Do not use level 1101 in G_ExitLevel or G_SetCustomExitVars; use "SCENE_EVALUATION" instead.
  • Do not use level 1102 in G_ExitLevel or G_SetCustomExitVars; use "SCENE_CREDITS" instead.
  • Do not use level 1103 in G_ExitLevel or G_SetCustomExitVars; use "SCENE_ENDING" instead.

New:

  • Updated to support map names:
    • map console command
    • Lua functions:
      • G_BuildMapName
      • G_BuildMapTitle
      • G_ExitLevel
      • G_SetCustomExitVars
    • SOC LEVEL:
      • Header line
      • NEXTLEVEL
    • SOC EMBLEM:
      • MAPNUM
    • SOC UNLOCKABLE:
      • VAR (if TYPE is WARP)
    • SOC CONDITION:
      • MAPVISITED, MAPBEATEN, MAPALLEMERALDS, MAPULTIMATE, MAPPERFECT
      • MAPSCORE, MAPTIME, MAPRINGS
      • NIGHTSSCORE, NIGHTSTIME, NIGHTSGRADE
    • SOC MAINCFG:
      • SPSTAGE_START
      • SPMARATHON_START
      • SSTAGE_START
      • SMPSTAGE_START
      • TITLEMAP
      • BOOTMAP
      • TUTORIALMAP
  • Added G_GetMapThumbnail and G_GetMapThumbnailWide to Lua
  • For named maps:
    • Use [MAPNAME]_PIC instead of MAPXXP
    • Use [MAPNAME]_WIDEPIC instead of MAPXXW
    • Use [MAPNAME]_METALREPLAY instead of MAPXXMS
    • The default map music name matches the map name (example: O_MP_JADEVALLEY instead of O_MAPJVM.)
  • Increased maximum music name length from 6 to 64

Example addon: mp_jadevalley.pk3

Edited by Lactozilla

Merge request reports