linktree Atrinik.org - Multiplayer Online Role Playing Game
Map Naming Convention
Development -> Map Naming ConventionMap Naming Convention

Atrinik uses the following rules for naming convention of map file names:

  • No spaces.
  • Only lowercase characters and numbers allowed.
  • Maps above or below another map should mark their position with _1-99 or _a-z respectively. If #4 is in effect, this should come first. See below for details.
  • Tiled maps must have _xxyy after the name denoting where they are tiled. See below for details.


Tiling convention

The convention for naming tiled maps is to add _xxyy at the end of the filename, where:

  • xx = X position
  • yy = Y position


The first map, 0101, is the most southwest map. It is possible to add map(s) south and/or west of this map by using aa01 for map west of 0101, 01aa for south or aaaa for southwest. This is not recommended for new mapsets, only if you need to add map(s) to the south or west at a later date. Map west of aa01 would use ab01 and one west of that would use ac01. Similarly for south, a map south of 01aa would be 01ab. If az is ever reached, ba would be next.

Example:

NW N NE
world_ab02 world_aa02 world_0102 world_0202 world_0302
world_ab01 world_aa01 world_0101 world_0201 world_0301
W world_abaa world_aaaa world_01aa world_02aa world_03aa E
world_abab world_aaab world_01ab world_02ab world_03ab
world_abac world_aaac world_01ac world_02ac world_03ac
SW S SE


Above/below convention

Simpler than the above, the convention used for non-surface maps is _level, where level denotes whether the map is above or below another one. 1-99 denotes map above another one, for example, a tower. a-z denotes map below another one, for example, a cave.

If used with tiling maps, this convention takes precedence, for example, world_1_0736. A map above world_1_0736 would be world_2_0736, while map below world_0736 would be world_a_0736.

Conclusion

It is important to follow the standard, but not strictly necessary in all places; for example, dungeons should use their own names (underground_city_0101 for example, instead of world_a_xxyy). This is known as the "long stairway" trick; it doesn't matter on which level the dungeon is located, because the length of the stairs/rope/etc can vary.

It should be noted though that it is important to follow the standard for things like upstairs/downstairs of buildings in the world maps, things like tunnels from one place to another, etc.