Sapp Mapcycle

A map cycle puts the server on a continuous loop of games. Using the SAPP map cycle is advantageous in that it’s non-volatile (the map cycle is saved into a file), you can edit the map cycle as it’s being played, you can skip the map cycle, and you can automatically skip map cycle entries if there are too many or not enough players.

Note: Make sure your map cycle covers your entire possible range of players. If SAPP cannot find a game that can be loaded with the current number of players, the minimum or maximum player count may be ignored when picking the next game.

Note: Enabling the map cycle will disable map voting.

To set up your map cycle, you can edit your mapcycle.txt, or use SAPP’s map cycle commands. This is how each line in mapcycle.txt file is formatted:
map:game variant:minimum players:maximum players

Setting up the SAPP mapcycle:
changing from Halo's default mapcycle to SAPP's mapcycle:

There is a mapcycle.txt (ANSI encoding) in the gametypes\sapp folder.
Move the mapcycle options from your Halo's  init.txt to your mapcycle.txt file. Make sure to remove the "sv_mapcycle_add" part, so taht your map's are copied in the "map:mode" format.
Now you can specify the minimum and maximum players.

Finally put "mapcycle_begin" command (without the sv_) after the load command in your init.txt.
Add sapp_mapcycle 1 to Sapp's init.txt.


Example:
Halo format:
init.txt:

...
sv_mapcycle_add bloodgulch ctf
sv_mapcycle_add ratrace slayer
sv_mapcycle_add sidewinder ctf
sv_mapcycle_add carousel slayer

sv_mapcycle_begin
load


Sapp format:
mapcycle.txt:
bloodgulch:ctf:0:16
ratrace:slayer:0:16
sidewinder:ctf:0:16
carousel:slayer:0:16


init.txt:
...
load
mapcycle_begin

Sapp's init.txt:
...
sapp_mapcycle 1


Sapp Mapcycle Commands:

Command Usage Effect

map_next

Start the next game in the mapcycle.

map_prev

Start the previous game in the mapcycle.

map_spec <index>

Skip the mapcycle to a certain point.

mapcycle

Get a list of games in the map cycle and their indices.

mapcycle_add <map> <game variant> [minimum players] [maximum players] [index]

Insert a new mapcycle entry with a map and gametype variant.

Optionally, the minimum players and maximum players can be added (by default they’re 0 and 16, respectively), and the game can also be inserted at a certain index, moving games at the index and afterwards after the index.

mapcycle_begin

Begin the mapcycle from the beginning.

mapcycle_del <index>

Remove a mapcycle entry.

sapp_mapcycle [enabled]

This will enable SAPP’s mapcycle. mapcycle_begin will also automatically enable this if it isn’t already enabled.

Default: false

 

Copyright © 2024 SAPP: Halo and Halo Custom Edition Server App. All Rights Reserved.
SAPP is sponsored by Elite Game Servers