Difference between revisions of "Map List"

From OdaWiki
m (formatting)
(addmap)
 
(22 intermediate revisions by 4 users not shown)
Line 1: Line 1:
One of the key features in Odamex is a dynamic maplisting functionality to create dynamic servers. Each entry in the map list currently contains a map name (such as E1M1 and MAP01) and a PWAD file. Currently, the map list supports only one pwad at a time. More special functionality for inputting and saving/loading the map list is under development.
+
One of the key features in Odamex is a dynamic maplisting functionality to create dynamic servers. Each entry in the map list currently contains a map name (such as E1M1 and MAP01) and a PWAD file. More special functionality for inputting and saving/loading the map list is under development.
  
 
===addmap===
 
===addmap===
Line 7: Line 7:
  
 
Note: You do not need to keep specifying the wad after its loaded for each subsequent addmap command, doing this will cause the server to reconnect any clients when the map changes, thus any clients which reconnect will have their "state" (weapons, ammo, points) reset.
 
Note: You do not need to keep specifying the wad after its loaded for each subsequent addmap command, doing this will cause the server to reconnect any clients when the map changes, thus any clients which reconnect will have their "state" (weapons, ammo, points) reset.
 +
 +
example: <br/>
 +
addmap map00 doom2.wad duel2015.wad      <--iwad followed by pwad first  <br/>
 +
addmap map01                                                      <--maplist  <br/>
 +
addmap map00  <br/>
 +
addmap map02    <br/>
 +
addmap map00    <br/>
 +
addmap map03  <br/>
 +
addmap map00  <br/>
 +
 +
- map00 is the lobby map of duel2015.wad, so after any map is played, you will be returned there
  
 
===clearmaplist===
 
===clearmaplist===
Line 14: Line 25:
  
 
===curmap===
 
===curmap===
Usage: '''nextmap'''
+
Usage: '''sv_curmap'''
 +
 
 
A read-only [[cvar]] for servers that checks the map number. Useful for [[if]] statements.
 
A read-only [[cvar]] for servers that checks the map number. Useful for [[if]] statements.
  
Line 27: Line 39:
 
Displays the entire map list in the console.
 
Displays the entire map list in the console.
  
===nextmap===
+
===nextmap (ccmd)===
 
Usage: '''nextmap'''
 
Usage: '''nextmap'''
  
 
Progresses to the next map in the current map list. Similar to [[forcenextmap]], only progresses naturally (with intermission).
 
Progresses to the next map in the current map list. Similar to [[forcenextmap]], only progresses naturally (with intermission).
 +
 +
===nextmap (cvar)===
 +
Usage: '''sv_nextmap'''
 +
 +
A read-only [[cvar]] for servers that checks the next map number. Useful for [[if]] statements.
 +
 +
===shufflemaplist===
 +
Usage: '''sv_shufflemaplist (0-1)'''
 +
 +
Turns on map shuffling. This will shuffle the map list order. (Not exactly random, as each map will be played once during each shuffle.)
 +
 +
==Other Useful Map Related Commands/CVARs==
 +
 +
===emptyfreeze===
 +
Usage: '''emptyfreeze (0-1)'''
 +
 +
When enabled, the server will become "frozen" and not process any game tics until a player joins the server. NOTE: This feature is experimental and maps will not progress while the server is frozen.
 +
 +
===emptyreset===
 +
Usage: '''emptyreset (0-1)'''
 +
 +
When enabled, this cvar will reload the map if all clients disconnect. This is ideal for frag-limited 1-on-1 servers where games may go unfinished.
 +
 +
===loopepisode===
 +
Usage: '''loopepisode (0-1)'''
 +
 +
A cvar used for cooperative games played on (Ultimate)Doom. If enabled, the server will return to ExM1 after completing ExM8.
 +
 +
===[[startmapscript]] & [[endmapscript]]===
 +
Startmapscript and endmapscript are ways of setting gameplay variables for the start and end of a map. Read [[Map Scripts]] for more information.
 +
 +
===map voting===
 +
''For full information on modifying and maintaining client vote privileges, refer to [[Voting]].''

Latest revision as of 14:37, 6 February 2019

One of the key features in Odamex is a dynamic maplisting functionality to create dynamic servers. Each entry in the map list currently contains a map name (such as E1M1 and MAP01) and a PWAD file. More special functionality for inputting and saving/loading the map list is under development.

addmap

Usage: addmap (map name) [...]

Adds a map to the map list, any following arguments are passed to the wad console command.

Note: You do not need to keep specifying the wad after its loaded for each subsequent addmap command, doing this will cause the server to reconnect any clients when the map changes, thus any clients which reconnect will have their "state" (weapons, ammo, points) reset.

example:
addmap map00 doom2.wad duel2015.wad <--iwad followed by pwad first
addmap map01 <--maplist
addmap map00
addmap map02
addmap map00
addmap map03
addmap map00

- map00 is the lobby map of duel2015.wad, so after any map is played, you will be returned there

clearmaplist

Usage: clearmaplist

Clears the map list. WARNING: No request for confirmation. Use at your own risk!

curmap

Usage: sv_curmap

A read-only cvar for servers that checks the map number. Useful for if statements.

forcenextmap

Usage: forcenextmap

Progresses to the next map in the current map list. Similar to nextmap, only progresses quickly (without intermission).

maplist

Usage: maplist

Displays the entire map list in the console.

nextmap (ccmd)

Usage: nextmap

Progresses to the next map in the current map list. Similar to forcenextmap, only progresses naturally (with intermission).

nextmap (cvar)

Usage: sv_nextmap

A read-only cvar for servers that checks the next map number. Useful for if statements.

shufflemaplist

Usage: sv_shufflemaplist (0-1)

Turns on map shuffling. This will shuffle the map list order. (Not exactly random, as each map will be played once during each shuffle.)

Other Useful Map Related Commands/CVARs

emptyfreeze

Usage: emptyfreeze (0-1)

When enabled, the server will become "frozen" and not process any game tics until a player joins the server. NOTE: This feature is experimental and maps will not progress while the server is frozen.

emptyreset

Usage: emptyreset (0-1)

When enabled, this cvar will reload the map if all clients disconnect. This is ideal for frag-limited 1-on-1 servers where games may go unfinished.

loopepisode

Usage: loopepisode (0-1)

A cvar used for cooperative games played on (Ultimate)Doom. If enabled, the server will return to ExM1 after completing ExM8.

startmapscript & endmapscript

Startmapscript and endmapscript are ways of setting gameplay variables for the start and end of a map. Read Map Scripts for more information.

map voting

For full information on modifying and maintaining client vote privileges, refer to Voting.