Qrow: 1 revision imported

2026-02-24T05:59:05Z

1 revision imported

← Older revision	Revision as of 22:59, 23 February 2026
(No difference)

intermisc/gamedev>Flozi: Game development -> Game Dev

2013-03-25T20:18:09Z

Game development -> Game Dev

New page

==Location==
validmaps.lua is a file in the root folder of a Spring game.

==Purpose==
from http://springrts.com/wiki/The_Talking_Changelog
<pre>
Valid maps are listed in the mod's "ValidMaps.lua" file
A valid map count of 0 means that any map can be used with the mod
This can be used in concert with LuaRules to setup multi-player scenarios and tutorials
</pre>
Basically this means that a Spring game can create a whitelist of maps and the lobbies will only display these maps in their selection menu. In the end it depends on the lobby how maps are listed.
All map names that are returned are playabe.

To block a certain map, validmaps.lua has to loop through all maps to build a table of mapnames, not inserting the unwanted map, and then return that table. 

'''=>'''is it that correct? Or is there an easy way, ie returning a second table of unvalid maps or is there an unvalidmaps.lua?


==Source==

'''=>'''don't know, please add


==Simple Example==
Just returning a table of map names is the easiest example:

<pre>
return {
"DesertCliffsV1",
"Eye_Of_Horus_v2",
}
</pre>

'''Note:''' Use mapnames as returned by [[Lua_ConstGame|Game.mapName]]

===Example to filter maps by various aspects===
http://code.google.com/p/zero-k/source/browse/trunk/mods/zk/ValidMaps.lua by det
If I understand this correctly this not a working example (it is disabled with ''if (false)'' anyway) but more a reference:
<pre>
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--
-- ValidMaps.lua
--
-- This file can be added to a mod to dictate which maps
-- can (and can not) be used with it. The map information
-- is the map's default information, and is done before
-- MapOptions.lua can be used by maps.
--
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--
-- Map specific call-outs:
--
-- Spring.GetMapList() -> { 'map1.smf', 'map2.smf', 'map3.sm3', etc... }
--
-- Spring.GetMapInfo('map1') -> {
-- author = 'string',
-- desc = 'string',
-- mapX = number,
-- mapY = number,
-- tidal = number,
-- gravity = number,
-- metal = number,
-- windMin = number,
-- windMax = number,
-- extractorRadius = number,
-- startPos = {
-- [1] = { x = number, z = number },
-- [2] = { x = number, z = number },
-- [3] = { x = number, z = number },
-- etc ...
-- },
-- }
--
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--
-- Example filtering code
--

if (false) then
local mapList = Spring.GetMapList()
local validMaps = {}
for _, mapName in ipairs(mapList) do
if (mapName:lower():find('metal')) then
local mapInfo = Spring.GetMapInfo(mapName)
local minX = (16 * 512)
local minY = (8 * 512)
if ((mapInfo.mapX >= minX) and
(mapInfo.mapY >= minY)) then
validMaps[#validMaps + 1] = mapName
end
end
end
if (#validMaps == 0) then
return { 'FAKEMAP' }
else
return validMaps
end
end

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

return {} -- returning an empty table means *ALL MAPS* are valid
-- for *NO MAPS*, return a fake map name, ex: { 'FakeMap' }

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
</pre>

===Working exampe===

'''=>'''would be nice to have one 

<pre>
--this validmaps.lua:
--blocks all "speedmetal" variants by name
--only allows square sized maps
--also allows the map "Derpa Derp"
EXAMPLE SCRIPT
</pre>

==Compatible Lobbies==

'''=>'''What lobbies read and support this? 

'''TASClient''' - yes (?) Satirik: ''just fixed it in tasclient'' http://springrts.com/phpbb/viewtopic.php?f=11&t=19495 
'''Spring Lobby''' - No, _koshi_: ''yeah, we actually can build a list of valid maps, it's just not used in the frontend''
 
'''zeroK Lobby''' - ? 
'''Alpha Lobby''' - ? 

[[Category:Game Dev]]

Validmaps.lua - Revision history

Qrow: 1 revision imported

intermisc/gamedev>Flozi: Game development -> Game Dev