halo2 server

Upload: evan-woody

Post on 30-May-2018

217 views

Category:

Documents


0 download

TRANSCRIPT

  • 8/9/2019 Halo2 Server

    1/29

    Halo 2 for Windows Vista

    Running a Dedicated Server

    and Creating PlaylistsMarch 2007 2007 Microsoft Corporation. All rights reserved.Microsoft, Halo, Windows, Windows Vista, and Xbox are either registered trademarks or trademarks of MicrosoftCorporation in the United States and/or other countries.

    Running a Dedicated ServerYou can run a game ofHalo 2for Windows Vista for you and your friends in two ways. Oneway is peer hosting, where you also play in the game too. In this case, you create a gamespontaneously in the game user interface (UI) and invite your friends to join you.

    The second way is to set up a computer with the Halo2Dedicated Server application. In this

    case, you dont play on this computer, and the computer runs certain games off of a playlist.Dedicated servers can run either as a log-on state or as a Windows service. As a Windowsservice, a dedicated server can keep running even if you log off of the computer. If you keep yourcomputer connected to the Internet and logged into Games for Windows LIVE , a dedicatedserver can run on your computer 24-7.

    You can host a server game that supports up to 16 players at once, on LIVE or on the localnetwork. Players running Halo2for Xbox cannot connect to or play in Halo2for Windows Vistaserver games.

    Note:Halo 2Dedicated Server is not supported by Microsoft support services. For informationabout and help with Halo 2Dedicated Server, see www.xbox.com/en-US/games/h/halo2/.

    Server as HostWith Halo2Dedicated Server, the server acts as the host of the game. No one plays on the samecomputer as the server, so there is no host advantage and everyone gets the sameperformance from the host computer. Some players may still have better connectivity than others,so a perfectly level playing field is not guaranteed.

    You can run server software on computers in racks in colo (collocation centers) or server farms.Doing this can help with better network access and performance speeds.

    Playlist FunctionalityIn a peer-hosted game run by a player, one of the players acts as the leader and choosessettings, maps, and game types before each game. In a game run by Halo2Dedicated Server,

    these choices are preloaded in a playlist, then run in a loop over and over (or shuffled). Theplaylist can be small or large, with a maximum of 100 matches.

    For more on customizing your own playlist, see "Making a Playlist."

    System RequirementsYour server can run as a local area network (LAN) server or a LIVE server.

    http://www.xbox.com/en-US/games/h/halo2/http://www.xbox.com/en-US/games/h/halo2/http://www.xbox.com/en-US/games/h/halo2/
  • 8/9/2019 Halo2 Server

    2/29

    If you want to run a LAN server, you need:

    1.7 gigahertz (GHz) 32-bit (x86) or 64-bit (x64) processor. For more information, seehttp://www.microsoft.com/windows/products/windowsvista/buyorupgrade/capable.mspx.

    1 gigabyte (GB) of system memory.

    40 GB of hard drive capacity, with 15 GB free space.

    Network card.

    Either Windows Vista or Windows 2003 Server.

    If you want to run a LIVE server, you also need:

    A broadband Internet connection. If you are using a home router, make sure it iscompatible with the LIVE service. For more information, see http://www.xbox.com/en-US/support/connecttolive/xbox360/homenetworking/equipment.htm.

    A Silver or Gold Games for Windows LIVE account.

    A Halo 2for Windows Vista product key. You can use the same product key that you useto play the game.

    Getting a Silver Games for Windows LIVE AccountTo run the Halo 2Dedicated Server, you must have, at the minimum, a Silver Games for

    Windows LIVE account. You can also use a Gold Games for Windows LIVE account. To signup for Games for Windows LIVE, go to www.xboxlive.com. The gamertag you choose appearsas the servers displayed name in the Game Browser screen for LIVE games. If you run adedicated server over a network, your server name initially is your computer name (until youchange it).

    Installing Halo 2 Dedicated ServerTo install Halo 2Dedicated Server, place the game disc in your computer and click InstallDedicated Serveron the initial install menu. Doing this installs the dedicated server and all thedefault maps. If you have custom maps, copy those over.

    To log on to the server, you can either log on remotely using Remote Desktop or work directly atthe server console.

    Running a Dedicated Server ManuallyIf you want to manually start a server:1. Open a Command Prompt window.2. In the Command Prompt window, change your working directory to the location where you

    installed the server program files, for example:cd \Program Files\Microsoft Games\Halo 2 for Windows Vista Server

    3. Start the server by running one of the following commands:h2server liveorh2server -lan

    To run a LIVE server, a couple of additional instructions apply. The first time you start a LIVEserver, you also need to set your product key, as shown:h2server$ live key 12345-12345-12345-12345-12345

    To sign in to LIVE, use the following command:h2server$ live autosignin user@domainwhere user@domain is your Windows Live account.

    Your server continues running until you run the exit command or log off. For more on the exitcommand, see "H2Server Commands," following.

    http://www.microsoft.com/windows/products/windowsvista/buyorupgrade/capable.mspxhttp://www.microsoft.com/windows/products/windowsvista/buyorupgrade/capable.mspxhttp://www.xbox.com/en-US/support/connecttolive/xbox360/homenetworking/equipment.htmhttp://www.xbox.com/en-US/support/connecttolive/xbox360/homenetworking/equipment.htmhttp://www.xboxlive.com/http://www.microsoft.com/windows/products/windowsvista/buyorupgrade/capable.mspxhttp://www.xbox.com/en-US/support/connecttolive/xbox360/homenetworking/equipment.htmhttp://www.xbox.com/en-US/support/connecttolive/xbox360/homenetworking/equipment.htmhttp://www.xboxlive.com/
  • 8/9/2019 Halo2 Server

    3/29

    For more on customizing your servers playlist, see "Making a Playlist."

    Setting Up Your Server to Run AutomaticallyTo run the server automatically, you set up the server as a Windows service. Then, when you logoff of Windows, the server continues running. It is recommended that you create a Windows Vista

    user account to associate the game service with.

    To set up your server to start automatically:1. Open a Command Prompt window. (On Windows Vista, you need to open a window for an

    elevated command prompt by using the Run As Administratoroption.)2. In the Command Prompt window, change your working directory to the location where you

    installed the server program files, for example:cd \Program Files\Microsoft Games\Halo 2 for Windows Vista Server

    3. Create a Windows service to run your server by running one of the following commands:h2server -createservice -liveorh2server -createservice -lan

    4. Log out of Windows and then log back on for the changes to take effect.

    5. Connect to your new service by opening the server console with the following command:h2admin -liveorh2admin -lan

    To set up a LIVE server, a couple of additional instructions apply:

    Set your new services product key:h2server$ live key 12345-12345-12345-12345-12345

    Configure your service to sign in to LIVE automatically:h2server$ live autosignin user@domain

    The LIVE server runs 24-7 and automatically restarts if the computer it runs on is rebooted. Youonly need to log in to your LIVE server if you want to open the server administration console and

    make changes. The server loads and uses the Example.hpl playlist by default.

    For more on customizing your servers playlist, see "Making a Playlist."

    If you no longer want your server to automatically start, delete your server service. Forinstructions, see "H2Server Command-Line Options."

    Starting and Stopping a Server Configured to Run AutomaticallyTo start and stop a server configured to run automatically as a Windows service, you use theWindows Services Manager.

    To do so, first open the Windows Services Manager. Note that this process is different whenrunning Vista than when running Windows 2003.

    In the window displayed, find the service called Halo 2 Server. Use the Windows ServicesManager commands to start or stop the service. If you right-click the Halo 2 Server service andchoose Properties, you can change the service to start manually, or disable it completely.

    Swapping the PlaylistTo change a dedicated server's playlist while the server is running:1. Create a new playlist. The new playlist can have content copied from the old one and then

    modified.

  • 8/9/2019 Halo2 Server

    4/29

    2. Give the new playlist a new file name with the .hpl suffix.3. In the h2server command line, type

    Playlocation and name of new listwhere location and name of new listis the path to the new list. Paths that contain spaces canbe specified with quotation marks, for example:cd \Playlists\Halo 2 for Windows Vista Server\everymap.hpl

    The server switches to the new playlist as soon as the current match concludes.

    H2Server Command-Line OptionsH2Server is the Halo 2Dedicated Server application used to manually run a game server, or tocreate or delete a Windows service that runs the game server automatically. If you do not specifya Windows Vista user account to associate with that service, the H2server application createsone for you. Its command-line options are as follows:

    H2server -createservice -liveInstalls the server in LIVE mode. Example:H2server$ -createservice -live

    H2server -createservice -lanInstalls the server in LAN mode. Example:H2server$ -createservice

    H2server -deleteservice -liveUninstalls the current LIVE server. Example:H2server$ -deleteservice -live

    H2server -deleteservice -lanUninstalls the current LAN server. Example:H2server$ -deleteservice -lan

    H2server -live

    Runs the server as a console application in LIVE mode.

    H2server -lanRuns the server as a console application in LAN mode.

    H2Admin Command-Line OptionsH2Admin is the administration console forHalo 2Dedicated Server, when Dedicated Server runsas a Windows Vista service. You use this console to run server commands when you started aHalo 2Server service. It has two options, indicating a LIVE server and a LAN (network) server, asfollows:

    H2admin -liveH2admin -lan

    H2Server CommandsThe following lists and describes commands you can give the server. Note in the followingexamples that H2Server$ is the prompt you see on the command line while the server is running,instead of C:\.

    BanThe ban command displays or adds temporary or permanent bans for players (referred to asgamers) on LIVE dedicated servers. For non-LIVE (that is, LAN) games, it bans specific

  • 8/9/2019 Halo2 Server

    5/29

    computers specified by IP address, subnet, or network interface card (NIC) .

    ban display gamerDisplays the list of banned gamertags for this dedicated server.

    ban gamergamertagdurationBans the specified gamertag. The duration time setting is optional. If you dont set the duration ofthe ban, the default ban is permanent (from this dedicated server). For syntax on duration, seefollowing.

    ban display ipDisplays the list in effect of bans of IP addresses and Classless Inter-Domain Routing (CIDR)subnets.

    ban ip (ip-address |cidr-subnet-mask) durationBans an IP address (in the formatxxx.xxx.xxx.xxx) or subnet (in the formatxxx.xxx.xxx.xxx/xx).The time span indicated by duration is optional; the default is a permanent ban from thisdedicated server.

    ban display nic

    Displays the list of NIC bans in effect.

    ban nic Ethernet-address durationBans a NIC by Ethernet address (in the formatxx-xx-xx-xx-xx-xx). The time span indicated byduration is optional; the default is a permanent ban from this dedicated server.

    Setting duration forban is optional; a duration setting can be used to specify temporary bans.You can specify a duration in any combination of seconds, minutes, hours, or days.

    Examples:30s is 30 seconds.45m is 45 minutes.12h is 12 hours.

    30d is 30 days.3m 30s is 3 minutes and 30 seconds.2d 8h is 2 days and 8 hours.

    DescriptionThe description command sets or displays the description for the session. This command onlyworks in LIVE (not on a network). You can use quotes to enclose phrases that include spaces.These session descriptions appear in the LIVE Game Browsers detail dialog box. Eachdescription is limited to 31 characters long.

    Example:H2server$ description Mayhem and chaosThis command line sets the description to Mayhem and chaos. To see the current description,

    type at a command prompt:H2server$ descriptionMayhem and chaos

    ExitIf you are running the server manually through H2server.exe, the exit command terminates thegame and immediately disconnects everyone.

    If you are connected to the server using H2admin.exe, exit closes the administration console.The server continues to run, and gameplay is uninterrupted. If you want to stop the server and

  • 8/9/2019 Halo2 Server

    6/29

    disconnect the players, you need to stop the Halo 2 Server service as described previously.

    KickKickplayer-nameThe kick command ejects the specified player from the game. Replaceplayer-name with thegamertag of the player you want to kick off of that server.

    Example:Suppose the status of a game is as shown:H2server$ StatusNetwork mode: LiveCurrent state: online - pregame lobbySign-in: [email protected]: HappyServerDescription: Running small mapsPlaylist: C:/server playlists/smallmap.hpl

    Playing Slayer on Beaver Creek.Next: Team Slayer on Elongation.

    Players:RabidDogHyenaJackRabbit

    H2server$ kick RabidDogThis command ejects the player RabidDog from the game.

    HelpThe help command gives you more information about the list of commands or a particularcommand. Type help commandwhere commandis the item you want more information about.

    LiveThe live command sets the server's product key, Games for Windows LIVE identifier (ID), andpassword. The live command also lets you sign your server out of LIVE and get server status.

    Live autosignin live-idSecurely saves a LIVE ID (indicated by live-id) and password for automatic sign-in with theservers configured LIVE ID.

    Example:H2server$ live autosignin [email protected]

    live keyxxxxx-xxxxx-xxxxx-xxxxx-xxxxxSets your servers product key to the key specified byxxxxx-xxxxx-xxxxx-xxxxx-xxxxx.

    live signin live-idTells the server to sign in to LIVE manually, using the provided account.

    live signoutSigns the server to out of LIVE.

    NameThe name command only works with non-LIVE (that is, LAN) games. The default network nameis the computers name, displayed in the Network Browser. For LIVE server games, the gamertag

  • 8/9/2019 Halo2 Server

    7/29

    of the account is displayed in the LIVE Game Browser.

    nameDisplays the servers current game name.

    namenameSets the servers current game name to name.

    A name used with the name command is limited to 20 characters long. Any names longer thanone word (that is, with internal spaces) must be inside quotation marks.

    Examples:To check the current name:H2server$name

    In this case, the command returns:Large Map Server

    The game is currently called Large Map Server.

    To change the name to something else:H2server$name Squash Make Flat

    The game is now called Squash Make Flat.

    PlayThe play command loads a new playlist onto the server while the server is still running. You canmodify your current playlist, save it, then use this command to update the server without a restart.

    Any names longer than one word (that is, with internal spaces) must be inside quotation marks.

    playplaylist-filenamePlays the playlist specified asplaylist-filename.

    Examples:H2server$play default.hplH2server$ play every slayer variant.hpl

    PlayersThe players command displays or sets the maximum number of players allowed on the server (orserver instance) at one time. For example, if youre running small maps and want to restrict totalpeople per map to 6, you can use the players command to set players in all matches on theserver to 6. The maximum number of players possible is 16.

    H2server$ players16Returns the number of players allowed at once on the server. (Sixteen is the default.)

    players numberSets the number of players on the server to the specified maximum.

    Example:H2server$ players 6Set players to a maximum of 6 on the server.

  • 8/9/2019 Halo2 Server

    8/29

    PlayingThe playing command displays information about the current playlist. If there are any errors inthe playlist matches or custom variants, this command shows you those and lists the linenumbers that the errors occurred on. You can check those line numbers in Microsoft Wordpadto do so, turn off the word wrap option, click Status Baron the View menu, and check thenumber of the line at the bottom, in the status bar. A playlist can run with errors in matches and in

    the variants. In this case, the matches or custom variants that contain errors are skipped.

    Example:H2server$ playingPlaylist: C:\MyHaloPlaylists\LivePlaylists\wildwest.hpl

    PrivacyThe privacy command displays or sets the privacy settings for the server. You can allow anyoneto join with open, restrict your games to LIVE Gold members only with gold, or restrict people toa list of specific gamertags with vip. For more information on setting a VIP list, see the entry onvip, following.

    Example:

    H2server$ privacy gold

    This example sets the privacy level to LIVE Gold members only.

    SendmsgThe sendmsg command broadcasts a message to all the players active on the server throughtext chat in either the lobby or the game. This command is very useful if you need to do servermaintenance.

    sendmsg messageSends the specified message.

    Example:

    H2server$ sendmsg Server will be going down in about 30 minutes.

    SkipThe skip command ends the current game in the playlist and moves the players to the next gamein the playlist, or to the next random game if the playlist is shuffled.

    Example:H2server$ skip

    This command skips the game ahead and stop the current game immediately.

    StatsfolderThe statsfoldercommand displays or sets the location of the folder to which the server outputs

    game statistics. This command, if a folder is set, enables the ability to record statistics from theserver games. If a folder path is supplied, this command sets the stats folder path. Paths thatcontain spaces can be specified with quotation marks. Put in an empty string () to disableexporting stats.

    Stats are sent in XML format and can be used to set up your own ranked or leaderboard games,to be displayed on a Web site.

    Examples:H2server$ statsfolder c:\myfolder

  • 8/9/2019 Halo2 Server

    9/29

    H2server$ statsfolder c:\my documents\my Halo 2 for Windows Vista games\my serverstats

    StatusThe status command displays status information about the servers connection, state, and sign-ingamertag, as well as who is connected to the server, what game they are currently playing, how

    much time is left in the game, what game is next, and whether the network is a LIVE network.Players are listed by gamertag, which you can use for the kick command. If time is listed, theformat is hours:minutes:seconds. The network status includes details of LIVE or network, yourcurrent signed-in status, and your current LIVE ID credentials used to sign in.

    Examples:H2server$ statusNetwork mode: LiveCurrent state: online - pregame lobbySign-in: [email protected]: HappyServerDescription: Running small mapsPlaylist: C:/server playlists/smallmap.hpl

    Playing Slayer on Beaver Creek.Next: Team Slayer on Elongation.

    Players:RabidDogHyenaJackRabbit

    UnbanThe unban command removes a ban from a computer or a gamer (a player).

    unban gamergamertagSpecifies by gamertag a LIVE gamer to unban. This command is only valid with LIVE games.

    unban ip Specifies an IP address (in the formatxxx.xxx.xxx.xxx) or CIDR subnet mask (xxx.xxx.xxx.xxx/xx)to unban. This command is only valid for non-LIVE (that is, LAN) games.

    unban nic Specifies a NIC (xx-xx-xx-xx-xx-xx) to unban. This command is only valid for non-LIVE (that is,LAN) games.

    unban all gamerRemoves all LIVE gamer bans.

    unban all IP

    Removes all IP address and CIDR subnet bans.

    unban all NICRemoves all NIC bans.

    VIPThe vip command displays and edits the VIP gamer list. VIP gamers are the specific people youallow to play on your server, listed by gamertag. The vip command works for LIVE games andLIVE game servers only.

  • 8/9/2019 Halo2 Server

    10/29

    vip displayDisplays the list of VIP gamertags.

    vip add gamertagAdds the specified gamertag to the VIP list.

    vip remove gamertagRemoves the specified gamertag from the VIP list.

    vip clearClears the VIP gamer list.

    Making a PlaylistA playlist is a collection of matches to be played in order, or randomly, by a remote server,instead of hosted by a human. The playlist can also contain a game (known as match) that hasspecial rules set up ahead of time, known as a custom game variant.

    In Halo 2for Windows Vista, you can design your own playlist of games and custom variants to

    play games in sequence on the dedicated server.

    Creating a Playlist FileYou can run a playlist on the dedicated server by creating a properly formatted playlist file withthe suffix .hpl. An Example.hpl file is included with the game.

    Naming and Formatting the Playlist FileA playlist file can be named any name you like, as long as it ends in .hpl. Any plain text editorcan be used. If you want to use variant names or map names that contain non-ASCII characters,you need to use a text editor that supports saving plain text with UTF-8 or UTF-16 encoding.

    For each setting, the name and value need to be on the same linefor example, shuffle=On.

    Extra tabs and spaces in that line are finefor example, shuffle = On. You cant break headingsacross multiple lines either.

    This format works:Base Variant = Team Crazy King

    However, these do not:

    Base Variant=Team Crazy King

    Base Variant= Team Crazy KingVariant = Team Crazy King

    Some of the settings in the playlist file use yes orno, 0 or1, On orOff, ortrue orfalse todetermine if the feature is turned on or off. You can format these in a variety of ways. Foryes orno and true orfalse, only the first letter matters.

    The following examples all work to turn on a setting:Shuffle=TShuffle = tRuEShuffle = yes

  • 8/9/2019 Halo2 Server

    11/29

    Shuffle=YEAH ALL RIGHTShuffle = YShuffle=1Shuffle = On

    The following examples all work to turn off a setting:Shuffle=NShuffle=No wayShuffle=Nope!Shuffle=0Shuffle=FalseShuffle=FShuffle = Off

    Placing the FileYou can put the playlist files wherever you want. You can also have more than one playlist file.The server points to a single playlist file. When you start the server, that file is loaded and played.If you want to run a different playlist, you need to manually run the play command to change theservers playlist. When you run that command, you pass in the name of the playlist file and thepath to the playlist file. The server switches playlists after the conclusion of the current game.Hint: Use double quotes () around the playlist path if it contains spaces.

    Optional Section in the File: PlaylistA playlist must contain a [playlist] section.

    In the [playlist] section, you define the nature of the playlist to the server. This section mayappear once at the top of a playlist file. These are the options you can put in this section:

    [playlist];The Sample PlaylistShuffle=OnPregame Team Selection Delay=30Pregame Delay=10

    Postgame Delay=14

    Heres the breakdown on those options:

    [playlist]Defines the playlist section.

    ;The Sample Playlist (optional)Gives a name to the playlist in a comment. The user interface (UI) does not display the comment;the comment helps keep track of which file you are working in. You can make commentsanywhere in the file by preceding them with a semicolon.

    Shuffle = On (optional)

    Randomizes the lists of matches so that they dont play in order.

    Pregame Team Selection Delay (optional)Sets the delay, in seconds, that you want the lobby to pause between games if players need topick their teams or change teams. This option is used only when teams are present. Themaximum delay is 10 minutes.

    Pregame Delay (optional)Sets the delay, in seconds, that you want the lobby to wait between games in the playlist on theserver. This period is everyones opportunity to send text or voice chat, or decide if they want the

  • 8/9/2019 Halo2 Server

    12/29

    server admin to change the playlist to different maps or variants.

    Postgame Delay (optional)Sets the delay, in seconds, that the postgame Carnage Report is shown to the players. Theycheck their kills, medals, assists, and other information at this time.

    As described preceding, there are three timers that delay the start of a game for the dedicatedserver. They go in this order:

    Pregame Team Selection Delay (silent timer)the amount of time people have to changeteams (if there are teams), view the map, chat, and read the game rules before a game. Peoplecan join or leave the Pregame Lobby during this silent countdown. The default is 10 seconds. Themaximum is 10 minutes.

    Pregame Delay (audible and visible timer)the amount of time the server waits in the gamelobby for people to view the map, chat, and read the game rules before a match. The default is 10seconds. The maximum is 10 minutes.

    Postgame Delay (silent timer)the amount of time people have to spend viewing the postgameCarnage Report, before switching to the next Pregame Lobby. The default is 30 seconds.

    Required Sections in the File: MatchEvery playlist must have at least one match section. This section can be repeated to create along list of possible games to play. A list can have a maximum of 100 matches. The shuffle optionplays these matches in random order. If anything is wrong with a particular match, the serverskips it.

    The minimal required format looks like this:

    [match]variant=Team Crazy Kingmap=Sanctuary

    All the options in the match look like this:

    [match]variant=Team Crazy Kingmap=Geminiweight=700minimum players=2maximum players=16

    In these examples:

    [match]Defines the match listing

    variantNames the base variant or custom variant that you want to play in this match.

    There are several ways to state what match you want in your playlist (or to build upon in yourcustom variant). The name used with variant matches the game shell (UI) spelling of the variantexactly. (For a listing of all variants and their descriptions, see the end of this document.) You canuse custom variants; how to define those in the dedicated server playlist is explained in a latersection of this document. If you misspell a variant name, that match is skipped in the playlist.

  • 8/9/2019 Halo2 Server

    13/29

    mapSets the map for this particular game. You can use a Bungie-created map or a custom map, aslong as all the players have a copy of the map or are willing to get a copy of the map. If you havea Games for Windows LIVE Gold account, you can get the map downloaded to your client fromthe server while you wait in the Pregame Lobby.

    If you misspell a map or variant, that entry wont work and is skipped. Also remove any extraspaces added between the option words.

    weightHelps you set the probability higher or lower whether this match appears in the servers rotation.The weight value only matters if you set playlist shuffle to yes. The weight can be a number from1 to 1000. Matches with a higher weight are chosen more often than matches with a lower weight.For more information, see the "Setting Match Weight" section following.

    minimum playersSets the minimum number of players required for the match to be played. If you require 2, as inthe preceding example, and only one person is on the server, this entire match is skipped ratherthan played. If no match that fits the minimum and maximum settings specified can be found, thismatch is played with the available players regardless of the minimum and maximum settings for

    it.

    maximum playersSets the total number of players allowed in a match at once. The game has a maximum of 16, sothis value must be 16 or less. This option is very useful if youve designed a small map with 2 x 2teams, for example. If no match that fits the minimum and maximum settings specified can befound, this match is played with the available players regardless of the minimum and maximumsettings for it.

    Creating Custom Variants in the Playlist FileThe playlist file can also support custom variants that you define in the playlist file itself. Becausethe variants are defined on the servers list, everyone on the server automatically has access tothem (no downloading needed).

    You can define up to 100 custom variants per playlist. Custom variants are optional and do nothave to be included in the playlist file.

    Note: Custom variants must be listed before matches in a playlist file.

    Defining Your VariantTo create a variant, first you need to define it. You can use a game variant as a base and modifyit, similar to creating a new game variant in the game shell. Or you can create a variant fromscratch. The tables at the end of this document list options for a custom variant.

    Note: You must list either a Base Variant or a Game Type for each custom variant for it to work.

    The format looks like this example:

    [Custom Variant]Name=Snipers SpecialBase Variant=SnipersActive Camo = OnWeapons on Map = randomForce Even Teams = On

    In this example:

  • 8/9/2019 Halo2 Server

    14/29

    [Custom Variant]Provides the section header for a variant. You can have up to 100 custom variants in one playlist.

    NameNames your variant. This name appears on the Game Details page in the Game Browser, in theGame Browser variant column, and also in the Pregame Lobby while everyone is waiting for thegame to start. Maximum name length is 16 characters (including spaces).

    Base VariantProvides a base for a custom variant. There are two ways to start building your custom variant.You can start with a base variant, which is any of the subtypes or variations of the basic gametypes. For example, Slayer is a basic game type and Team Slayer would be the base variant. Anyadditional options you add supersede any base variant rules. This process is similar to creating anew game variant in the game UI by choosing one of the existing variants and then changingsettings.

    Game TypeProvides a game type to create a custom variant from. Instead of using a base variant, you canstart from scratch using one of the seven major types of games: Slayer, CTF, Assault, Territories,

    and so on. Doing this is similar to creating a new game variant in the game UI by choosing agame type, selecting the Create New command, and then changing settings.

    Active CamoMakes all the players invisible with active camo all the time. This is an example of one of thegame options you can set in the game.

    Weapons on MapSets the weapons used in games on this map. In this case, this option is set to place randomweapons on the map. Weapons can also be inherited from the base variant. For other options,see the tables following.

    Force Even Teams

    Sets whether you want the server to force the teams to be even for a match. This option for thevariant uses Y/N.

    Changing Playlists and Match Weight

    Changing PlaylistsYou can change the playlist on the server by running the play command at any time. Doing thisswitches the playlist at the conclusion of the current game without booting the players.

    If you modify your current playlist (say, in Notepad) while that playlist is being used, you can savethe changed Playlist.hpl file with the same name. Then, at the command line for the server, typeplay nameplaylist-name (whereplaylist-name is the list name). When the current game finishes,the server reloads the playlist.

    Setting Match WeightIn a random or shuffled playlist, you can set a match weight to help certain games be playedmore often. This weighting is done by distributing points to each of the matches to affect theprobability that a particular match will show up more often in a shuffled playlist.

    To do this, first you must first set your playlist to Shuffle = yes.

  • 8/9/2019 Halo2 Server

    15/29

    Second, you need to assign a match weight to each match in your list. Possible weight values arebetween 1 and 1000. Entries without a weight get a default weight of 100.

    For example:Match A 700Match B 100Match C 200

    This example picks A the most often, followed by C and occasional doses of B. Even though Ahas a much higher probability of being picked, the server tries to avoid playing the same matchback to back. A probable match pattern is something like: A C A C A B A C B A

    The following example is a bad example:Match A 100Match B 100Match C 100

    All these games, A, B, and C, would come up equally in a shuffle. In this case, dont use matchweight. Just shuffle the playlist.

    To play matches in order, turn off shuffle and order them in your playlist the way you want them tobe played. The syntax here is something like:

    [match]Base_variant=Team Crazy Kingmap=Sanctuaryweight=700

    [match]Base_variant=Team Crazy Kingmap=Geminiweight=100

    [match]Base_variant=Rocketsmap=Geminiweight=200

    Custom Variant Reference: Universal Game OptionsThe following settings are used for all game types unless otherwise noted. Options specific to agame type are listed later in the document in game-specific sections (such as "Slayer Options").

    NameRefers to the variant from a match section.

    Base VariantSets the base variant. This option can be used instead of game type. For more information, seethe table of base variants at the end of this document.

    Game TypeSets the game type. Following is a list of game types by name.

    Game What it does

    Slayer Kill as many of your opponents as you can. The player withthe most points wins.

  • 8/9/2019 Halo2 Server

    16/29

    King of the Hill Gain control of the hill to earn time. Keep your opponents off and earn the most time to win.

    Oddball Find the ball and hold on to it to earn time. The player with themost time wins.

    Juggernaut Work together to take down the Juggernaut. Beware, you killthe Juggernaut, you become the Juggernaut, and only the

    Juggernaut can win.Capture the Flag Capture the Flag: Invade your opponents stronghold, heist

    their flag, and bring it back to your base to score.

    Assault Carry your bomb into the enemy base and arm it. Oncearmed, drop it on the enemy bomb post to score.

    Territories Find and control territories on the map. The more territoriesyou control, the faster you earn time.

    Example:Game Type = Slayer

    Note that King of the Hill can also be King and KoTH, and Capture the Flag can also be CTF.Example:

    Game Type = KoTH

    Match OptionsOption Value What it does

    Number of Rounds 1 Round, 2 Rounds, 4Rounds, 6 Rounds, First to2, First to 3, First to 4

    A game can end after a single round,after a fixed number of rounds, or onlyafter someone wins a number ofrounds.

    Score to Win Round See specifics in each gametype section below.

    Round Time Limit None, 1 minute, 2 minutes, 3minutes, 4 minutes, 5

    minutes, 6 minutes, 7minutes, 8 minutes, 9minutes, 10 minutes, 12minutes, 15 minutes, 20minutes, 30 minutes, 45minutes, 1 hour

    A round can be set to end after a setamount of time has elapsed. Use this

    to prevent games from lasting toolong.

    Rounds Reset Map On/Off A new round can either keep the mapin its destroyed state from theprevious round or reset it to its originalpristine state.

    Resolve Ties On/Off When resolve ties is off a game canend in a tie. When it is on a winner willbe chosen based on secondary

    winning conditions.

    Example:Round Time Limit = 45 Minutes

    Player SettingsOption Value What it does

    Max ActivePlayers

    2-16 This setting controls how manyplayers are active in the game at

  • 8/9/2019 Halo2 Server

    17/29

    once. In non-team games this is totalplayers, in team games, players perteam. All other players must waittheir turn as active players.

    Lives Per Round 1, 2, 3, 7, 9, 99; unlimited The Lives Per Round settingdetermines how many chances youll

    have in the game. Once youre out oflives you no longer respawn.

    Respawn Time 3 seconds, 5 seconds, 10seconds, 15 seconds, 20 seconds,30 seconds

    Respawn Time controls the amountof time that a dead player must waitbefore getting another chance at life.

    Suicide Penalty None, 5 seconds, 10 seconds, 15seconds

    When you kill yourself you will haveto wait the time specified forSuicidePenalty in addition to any other waittime before you respawn.

    Shield Type Normal Shields, No Shields,Overshields

    Shield Type determines whetherplayers have energy shields, and ifso whether they are normal strength,turned off, or overcharged.

    Motion Sensor Off/On When the Motion Sensoris turnedoff it no longer detects or indicatesmovement.

    Active Camo Off/On When this is on, all players will beinvisible with Active Camo. Firing aweapon or taking damage makes youtemporarily visible again.

    Extra Damage On/Off When Extra Damage is on allplayers will inflict more damage thannormal.

    DamageResistance

    On/Off When Damage Resistance is on,everyone will be tougher thannormal.

    Example:Shield Type = No Shields

    Note that Shield Type can also be Normal, None, orOff.

    Team OptionsOption Value What it does

    Team Play See specifics in the gametype sections following.

    Team Scoring See specifics in the gametype sections following.

    Team Changing See specifics in the gametype sections following.

    Friendly Fire On/Off Unwary players can injure or even killteammates. Friendly Fire can beturned off so that teammates cannot bedirectly damaged by each other.

    Respawn TimeModifier

    Inheritance, Cycling,None

    Players either inherit dead teammatespawn times (inheritance), respawntogether at fixed intervals (cycling), or

  • 8/9/2019 Halo2 Server

    18/29

    respawn at a set amount of time afterthey die (none).

    Betrayal Penalty None, 5 seconds, 10seconds, 15 seconds, 30seconds, 1 minute, 2minutes

    This setting determines an additionalamount of time a team killer will haveto wait before respawning.

    Vehicle OptionsOption Value What it does

    Vehicle RespawnTime

    Map Default, Half As Often,No Respawn

    Vehicle respawn time determines howquickly dead vehicles come back tolife. Times are relative to the defaultsettings for the map.

    Primary Light Vehicle Map Default, Warthog,Gauss Warthog, Ghost,Spectre, Random, None

    This setting allows you to override themap-specific primary light land vehiclewith a vehicle of your choosing.

    Secondary LightVehicle

    Map Default, Warthog,Gauss Warthog, Ghost,Spectre, Random, None

    This setting allows you to override themap-specific secondary light landvehicle with a vehicle of your

    choosing.Primary HeavyVehicle

    Map Default, Scorpion Tank,Wraith, Random, None

    This setting allows you to override themap-specific primary heavy landvehicle with a vehicle of yourchoosing.

    Banshee Map Default, On, Off This setting allows you to specifywhether Banshees appear on a mapthat supports them.

    Primary Turret Map Default, Large MachineGun, Large Plasma,Random, None

    This setting allows you to override themap-specific primary turret with theturret of your choosing.

    Secondary Turret Map Default, Large MachineGun, Large Plasma,

    Random, None

    This setting allows you to override themap-specific secondary turret with a

    turret of your choosing.

    Equipment OptionsOption Value What it does

    Starting Weapon Map Default, None,Random, Battle Rifle,Magnum, SMG, PlasmaPistol, Plasma Rifle, BrutePlasma Rifle, RocketLauncher, Shotgun, SniperRifle, Brute Shot, Needler,Carbine, Beam Rifle,

    Energy Sword, SentinelBeam

    This setting determines which primaryweapon players start the game andrespawn with.

    Secondary Weapon Map Default, None,Random, Battle Rifle,Magnum, SMG, PlasmaPistol, Plasma Rifle, BrutePlasma Rifle, RocketLauncher, Shotgun, SniperRifle, Brute Shot, Needler,

    This setting determines which backupweapon players start the game andrespawn with. A backup weapon isoptional.

  • 8/9/2019 Halo2 Server

    19/29

    Carbine, Beam Rifle,Energy Sword, SentinelBeam

    Starting Grenades On/Off When this setting is on players willstart the game and respawn withgrenades.

    Weapons on Map Map Default, None,Rockets, Shotguns,Swords, Brute Shots, HaloClassic, New Classic,Heavy Weapons, AllDuals, No Duals, Rifles,Sniping, No Sniping,Pistols, Plasma, Human,Covenant, Random Set

    This setting determines the set ofweapons that is available on the map.Weapons on map can also be turnedoff entirely.

    Weapon RespawnTime

    Map Default, NoRespawn, Half Time,Double Time

    Weapon Respawn time determineshow much time it takes to respawnweapons. Times are relative to thedefault settings for the map.

    Grenades On Map On/Off If Grenades On Map is turned off there will be no grenades available forpickup on the map.

    Overshields On/Off This setting controls whether or notthe Overshield powerup is availableon the map.

    Active Camo on Map On/Off This setting controls whether or notthe Active Camouflage powerup isavailable on the map.

    Custom Variant Reference: Slayer SettingsThe following options help you create a custom variant of the Slayer game type. In Slayer, you killas many opponents as you can. Each kill is a point. The player with the most points wins.

    Slayer-Specific Match OptionsOption Value What it does

    Score to Win Round 1, 3, 5, 10,15, 20, 25,50, 100, 250,Unlimited

    Points are earned in Slayer for killing otherplayers. This setting determines how many pointsare needed to win a round.

    Slayer-Specific Team OptionsOption Value What it does

    Team Play On/Off This setting determines whether this is a teamgame or a free-for-all. The maximum number of

    teams for this game is determined by the map.Team Scoring Sum,

    Minimum,Maximum

    A teams score can be the sum of all its membersscores, the score of its lowest player (minimum), orthe score of its highest player (maximum).

    Team Changing On/Off When Team Changing is on players are allowedto change teams while the game is in progress.

    Force Even Teams On/Off When Force Even Teams is on, each team willonly have as many active players as the team withthe fewest players. All other team members must

  • 8/9/2019 Halo2 Server

    20/29

    wait for their turn to spawn.

    Slayer Game OptionsOption Value What it does

    Bonus Points On/Off When Bonus Points are enabled, players canearn additional points for notable acts like double

    kills and killing sprees. (Off by default.)Suicide Point Loss On/Off When Suicide Point Loss is enabled, a player will

    lose a point for committing suicide. (On bydefault.)

    Death Point Loss On/Off When Death Point Loss is enabled, a player thatdies will lose a point. Careful, this can lengthengames significantly! (Off by default.)

    Custom Variant Reference: King of the Hill SettingsThe following tables can help you customize the King of the Hill game type. In King of the Hill, yougain control of the hill to earn time. Keep your opponents off and earn the most time to win.

    King-Specific Match OptionsOption Value What it doesScore to Win Round Off, 30

    seconds, 1minute, 2minutes, 3minutes, 5minutes

    You accumulate time in King of the Hill by standingon the hill. This setting determines the amount oftime you must earn in order to win a round.

    King-Specific Team OptionsOption Value What it does

    Team Play On/Off This setting determines whether this is a teamgame or a free-for-all. The maximum number of

    teams for this game is determined by the map.Team Scoring Sum,

    Minimum,Maximum

    A teams score can be the sum of all its membersscores, the score of its lowest player (minimum),or the score of its highest player (maximum).

    Team Changing On/Off When Team Changing is on players are allowedto change teams while the game is in progress.

    Force Even Teams On/Off When Force Even Teams is on, each team willonly have as many active players as the team withthe fewest players. All other team members mustwait for their turn to spawn.

    King of the Hill Game OptionsOption Value What it does

    Uncontested Hill On/Off When this is on, you can only earntime on the hill when there are noenemies contesting it. (Off by default.)

    Moving Hill Off, 30 seconds,1 minute, 2minutes, 3minutes, 5minutes

    The hill will change to a new randomlocation at the set interval.

    Team Time Multiplier On/Off When on, you will earn time faster

  • 8/9/2019 Halo2 Server

    21/29

    when you have more teammates onthe hill. (default = off)

    Extra Damage on Hill On/Off When on, a player on the hill will bemore powerful than other players.(Default = off)

    Damage Resistance on Hill On/Off When on, a player on the hill will be

    tougher than normal. (default = off)Active Camo on Hill On/Off When enabled, a player standing on

    the hill will have Active Camo.(Default = off)

    Custom Variant Reference: Oddball SettingsThe following variant tables help you customize the Oddball game type. In Oddball, you find theball, which looks like a skull, and hold on to it to earn time. The player with the most time wins.

    Oddball-Specific Match OptionsOption Value What it does

    Score to Win Round Off, 30 seconds, 1

    minute, 2 minutes, 3minutes, 5 minutes, 7minutes, 10 minutes,15 minutes

    You accumulate time in Oddball by holding

    the ball. This setting determines theamount of time you must earn in order towin a round.

    Oddball-Specific Team OptionsOption Value What it does

    Team Play On/Off This setting determines whether this is ateam game or a free-for-all. The maximumnumber of teams for this game isdetermined by the map.

    Team Scoring Sum, Minimum,Maximum

    A teams score can be the sum of all itsmembers scores, the score of its lowest

    player (minimum), or the score of its highestplayer (maximum).

    Team Changing On/Off When Team Changing is on players areallowed to change teams while the game isin progress.

    Force Even Teams On/Off When Force Even Teams is on, each teamwill only have as many active players as theteam with the fewest players. All other teammembers must wait for their turn to spawn.

    Oddball Game OptionsOption Value What it does

    Ball Count 1 ball, 2 balls,

    3 balls

    This controls the number of balls in the

    game. More balls equals more chaos,but thats not always a good thing.

    Ball Hit Damage Normal,Massive

    The ball is a weapon. This settingdetermines whether melee attackingsomeone with it hurts a little or a lot.Default = massive.

    Speed With Ball Slow, Normal,Fast

    This setting determines the speed thatthe ball carrier moves in relation toother players.

  • 8/9/2019 Halo2 Server

    22/29

    Toughness With Ball On/Off When on, a player carrying a ball willbe tougher than normal. (Default = off)

    Active Camo With Ball On/Off Determines whether a ball carrier canbe seen by other players. (default = off)

    Vehicle Operation On/Off If off, the player carrying a ball cannotdrive vehicles or operate stationary or

    vehicle-mounted guns. (Default = off)Ball Indicator Always On,

    Dropped Ball,Team Control,Off

    This setting controls if and when yousee an indicator revealing the locationof the ball. (default = always on)

    Custom Variant Reference: Juggernaut SettingsThe following tables can help you customize the Juggernaut game type. In Juggernaut, worktogether to take down the Juggernaut. Beware: If you kill the Juggernaut, you become theJuggernaut, and only the Juggernaut can win.

    Juggernaut-Specific Match Options

    Option Value What it doesScore to Win Round Unlimited,1,3,5,10,15,20, 25, 50,75, 100

    Its everyone against the Juggernaut. TheJuggernaut earns a point for each kill, and only hecan score. Kill the Juggernaut to become theJuggernaut. This setting determines how manypoints the Juggernaut needs to win a round.

    Juggernaut Game OptionsOption Value What it does

    Betrayal Point Loss On/Off All players that are not the Juggernautare considered teammates. When thisoption is on, betraying a teammateresults in losing a point. (Default = on)

    Juggernaut Extra Damage On/Off When on, the Juggernauts weaponsdo more damage than normal.(Default = on)

    Juggernaut Infinite Ammo On/Off When on, the Juggernaut will never run out of ammunition. (Default = on)

    Juggernaut Overshield On/Off When on, Juggernaut has rechargingextra powerful shields. This settingoverrides the player shield setting.(Default = on)

    Juggernaut Active Camo On/Off When on, the Juggernaut has activecamo. This setting overrides theplayer Active Camo setting. (Default =off)

    Juggernaut Motion Sensor On/Off When on, Juggernaut has a motionsensor. Overrides the player motionsensor settings. (Default = on)

    Juggernaut Movement Slow, Normal,Fast

    Determines the speed of theJuggernaut relative to the otherplayers in the game. (Default =normal)

    Juggernaut DamageResistance

    On/Off When this option is on the Juggernautis extra tough. This setting overrides

  • 8/9/2019 Halo2 Server

    23/29

    the Player Damage Resistancesetting.

    Custom Variant Reference: Capture the Flag SettingsThe following tables help you customize the Capture the Flag (CTF) game type. In CTF, youinvade your opponents stronghold, steal the flag, and bring it back to your base to score.

    CTF-Specific Match OptionsOption Value What it does

    Score to Win Round Unlimited, 1,2, 3, 5

    How many points it takes to win a round of CTF. Apoint is earned each time you successfully capturean enemy flag and bring it back to your base.

    CTF-Specific Team OptionsOption Value What it does

    Team Changing On/Off When Team Changing is on players are allowedto change teams while the game is in progress.

    Force Even Teams On/Off When Force Even Teams is on, each team willonly have as many active players as the team withthe fewest players. All other team members mustwait for their turn to spawn.

    CTF Game OptionsOption Value What it does

    Flag Type Single Flag, Flag PerTeam, Neutral Flag

    In Single Flag there is only one defendingteam. In Flag Per Team (multi-flag), eachteam has a flag and must play offense anddefense at the same time. In Neutral Flagthere is a single flag that any team cancapture. (Flag per team = default.)

    Sudden Death On/Off When Sudden Death is enabled, a roundwill not end while a flag is being carried orcontested. This can lead to exciting finalmoments. (On by default.)

    Flag At Home ToScore

    On/Off When Flag at Home To Score is enabled,you cannot score a point unless your flag issafely on its flag stand. (On by default.)

    Flag Touch Return On/Off When Flag Touch Return is enabled, youmay return your flag to the base by touchingit. (Off by default.)

    Flag Reset Time 5 seconds, 10seconds, 15 seconds,30 seconds, 45

    seconds, 60 seconds

    The time that must elapse before a droppedflag returns home. An enemy near a flagpauses this timer, an enemy picking it up

    resets it. (Default = 30 sec)Slow With Flag On/Off When Slow With Flag is on, the flag carrier

    moves as a slower pace than other players.(On by default.)

    Flag Hit Damage Normal/Massive The flag pole is a weapon. Flag Hit Damagedetermines whether a melee attack with theflag hurts a little or is deadly. (On bydefault.)

    Damage Resistance On/Off When this is on, a player carrying the flag is

  • 8/9/2019 Halo2 Server

    24/29

    With Flag tougher than normal. (Off by default.)

    Active Camo WithFlag

    On/Off When this is on, a player carrying the flag isinvisible. (Off by default.)

    Vehicle Operation On/Off If this is disabled, a player carrying the flagcannot drive vehicles or operate stationaryor vehicle-mounted guns. (Off by default.)

    Flag Indicator When Uncontrolled,Always On, AwayFrom Home, Off

    Determines if and when you have anindicator showing the location of your flag.(Neutral by default.)

    Custom Variant Reference: Assault SettingsThe following tables help you customize the Assault (bomb) game type. In Assault, you carry yourbomb into the enemy base and arm it by standing over the marker. Once armed, the bomb isautomatically dropped on the enemy base to score.

    Assault-Specific Match OptionsOption Value What it does

    Score to Win Round Unlimited, 1,

    2, 3, 5

    How many points it takes to win a round of

    Assault. A point is earned each time yousuccessfully arm and detonate a bomb in anenemy base.

    Assault-Specific Team OptionsOption Value What it does

    Team Changing On/Off When Team Changing is on players are allowedto change teams while the game is in progress.

    Force Even Teams On/Off When Force Even Teams is on, each team willonly have as many active players as the team withthe fewest players. All other team members mustwait for their turn to spawn.

    Assault Game OptionsOption Value What it does

    Bomb Type Single Bomb,Bomb Per Team,Neutral Bomb

    In Single Bomb there is only onedefending team. In Bomb PerTeam, each team has a bomb andmust play offense and defense atthe same time. In Neutral Bombthere is a single bomb that anyteam may use.

    Enemy Bomb Indicator Always On, WhenDropped, When

    Armed, Off

    Determines if and when defendershave an indicator showing thelocation of an enemy bomb.(Default = when dropped)

    Sudden Death On/Off When enabled, a round will not endwhile a bomb is being carried orcontested. This can lead to tensefinal moments. (Default = on)

    Bomb Touch Return On/Off When on, you may reset an enemybomb to its original location bytouching it. (Default = Off)

    Bomb Reset Time 5 seconds, 10seconds, 15

    The time that must elapse before adropped bomb resets to its original

  • 8/9/2019 Halo2 Server

    25/29

    seconds, 20seconds, 30seconds, 45seconds, 60seconds

    location. Getting close to yourbomb freezes this timer; picking itup resets it. (Default = 30 seconds)

    Bomb Arm Time 5 seconds, 10

    seconds, 15seconds

    The time it takes to arm the bomb

    after youve carried it inside thearming zone near the enemy bombpost.

    Sticky Arming On/Off When on, you can pick up apartially armed bomb and resumearming it where someone else leftoff. (Default = on)

    Slow With Bomb On/Off When on, the bomb carrier movesat a slower pace than otherplayers. (Default = on)

    Assault Game Options (continued)Option Value What it does

    Bomb Hit Damage On/Off The Bomb is a weapon. Thisdetermines whether a melee attackwith the bomb hurts a little (normal)or is deadly (massive). (default =massive/deadly)

    Damage Resistance With Bomb On/Off When on, a player carrying thebomb is tougher than normal.(Default = off)

    Active Camo With Bomb On/Off When on, a player carrying thebomb is invisible with active camo.(Default = off)

    Vehicle Operation On/Off If off, a player carrying the bombcannot drive vehicles or operate

    stationary or vehicle-mountedguns. (Default = off)

    Custom Variant Reference: Territories SettingsThe following variant tables help you customize the Territories game type. In Territories, you findand control territories on the map. The more territories you control, the faster you earn time.

    Territories-Specific Match OptionsOption Value What it does

    Score to Win Round Off, 1 Minute, 2 Minutes,3 minutes, 5 minutes, 7minutes, 10 minutes, 15

    minutes, 20 minutes, 30minutes

    This setting determines the amount oftime need to win a Territories round.You gain time by controlling territories

    the more you control the faster yourtime increases.

    Territories-Specific Team OptionsOption Value What it does

    Team Changing On/Off When Team Changing is on players are allowedto change teams while the game is in progress.

    Force Even Teams On/Off When Force Even Teams is on, each team willonly have as many active players as the team with

  • 8/9/2019 Halo2 Server

    26/29

    the fewest players. All other team members mustwait for their turn to spawn.

    Territories Game OptionsOption Value What it does

    Territory Count 1 Territory, 2 Territories, 3

    Territories, 4 Territories, 5Territories, 6 Territories, 7Territories, 8 Territories

    This setting determines the

    maximum number of territories onthe map. Notes: Not all maps havethis many territories. (Default = 3)

    Contest Time 3 seconds, 5 seconds, 10seconds, 15 seconds, 20seconds, 30 seconds

    This setting determines the amountof time it takes to undo someoneelses control of a territory. (Default= 5 seconds)

    Control Time 3 seconds, 5 seconds, 10seconds, 15 seconds, 20seconds, 30 seconds

    This settings determines how long ittakes to gain control of a neutralterritory. Enemy territories must firstbe contested, then controlled.(Default = 5 seconds)

    Appendix A: Example Playlist FileYou can run a playlist on the dedicated server by creating a properly formatted file. The followingis an example of a playlist file.

    This playlist is not shuffled and includes two custom variants and three matches that are played inthe order listed in the file.

    [playlist]; Happy Go Lucky Playlistshuffle=no

    [custom variant]; name Happys Specialgame type=Slayernumber of rounds = 1score to win round=50round time limit=10 minutesrespawn time=5 secondssuicide penalty=10 secondsweapons on map= rocketsstarting weapon = Battle Riflesecondary weapon = SMG

    [custom variant]; name Standoffbase variant=Slayer

    max active players=2score to win round = 5weapons on map= Shotgunsstarting weapon = plasma pistolsecondary weapon = shotgun

    [match]variant=Oddballmap=Terminal

  • 8/9/2019 Halo2 Server

    27/29

    [match]variant=Happys Specialmap=Coagulation

    [match]variant=Standoffmap=Midship

    Appendix B: Default Maps ListingFollowing is the complete list ofHalo 2for Windows Vista default maps shipped with the game.You can use this list to create games in your playlist. The names must match the name of themap as it appears in the UI of the game.

    Name of map Size of map (for number of people in game)

    Lockout Medium

    Ascension Medium

    Midship Small

    Ivory Tower Small

    Beaver Creek Small

    Burial Mounds Large

    Colossus Large

    Zanzibar Medium

    Coagulation Large

    Headlong Large

    Waterworks Large

    Foundation Medium

    Containment Large

    Warlock Small

    Sanctuary Medium

    Turf Medium

    Backwash Small

    Elongation SmallGemini Medium

    Terminal Large

    District Large

    Uplift Large

    Appendix C: Default Variants ListingFollowing is the complete list of default game variants included in Halo 2for Windows Vista. Youcan use this list to create variations on your games in your playlist: Just match up the variant to amap.

    The variant name must match the variant name as it appears in the UI of the game.

    Game type Base variant name Description

    Slayer Slayer Prepare for a Classic Slayer duel to the death. 25 ptsto win.

    Slayer Team Slayer Take on a small team of enemies in a straight upSlayer throw down. 50 points to win.

    Slayer Rockets Get ready for an explosive game of Rockets. Allrocket launchers, no motion sensor. 25 points to win.

  • 8/9/2019 Halo2 Server

    28/29

    Slayer Swords Sharpen your Energy Sword and power up your overshields. 25 points wins this game.

    Default Variants Listing (continued)Game type Base variant name Description

    Slayer Snipers Steady your shot and aim high. All weapons aresniper rifles and there's no motion sensor. 15 pointswins.

    Slayer Phantoms Everyone has active camo, so watch your back. 15points wins this game.

    Slayer Team Phantoms Everyone has active camo and you can organize intoup to 8 teams. First team to 25 points wins.

    Slayer Elimination You have just one life per round. The last player standing wins a round. First to win 3 rounds wins thegame.

    Slayer Phantom Elim You have just one life and everyone is invisible. Lastplayer standing wins a round. First to win 3 roundstakes the cake.

    King of the Hill King Stay on the hill for a total of 2 minutes to win thegame. Hill does not move.

    King of the Hill Team King Your team must take the hill and control ituncontested for 1 minute to win. Hill does not move.

    King of the Hill Phantom King Control the hill uncontested to earn time. Everyonehas active camo and the hill does not move. 1 minutewins.

    King of the Hill Crazy King The hill moves once a minute. Be the first to earn 2minutes on it to take the crown.

    King of the Hill Team Crazy King Your team must earn just 1 minute uncontested onthe moving hill to take the crown.

    Oddball Oddball Get ready for a classic game of free-for-all Oddball.Hold the ball for 2 minutes to win.

    Oddball Rocketball This game of Oddball with nothing but rocketlaunchers is a real blast. Control the ball for 1 minuteto win.

    Oddball Swordball Tense rounds with swords and no motion sensor.Own the ball for 30 seconds to win a round. First to 3wins.

    Oddball Team Ball Up to 8 teams can go head to head in this game of team Oddball. First team with 2 minutes ball controlwins.

    Oddball Low Ball Team Oddball with a twist. Everyone on your teammust hold the ball for at least 30 seconds to win.

    Oddball Fiesta An odd game of ball with random weapons. Earn 2minutes ball control time to win.

    Juggernaut 2 on 1 One player is the Juggernaut, the other 2 areteammates. Only the Juggernaut can score and 10points wins the game.

    Juggernaut 3 on 1 One player is the Juggernaut while 3 others areteammates. Earn 10 points as the Juggernaut to winthe game.

    Juggernaut Ninjanaut The Juggernaut has active camo and a motionsensor. You don't, so work together to corner himand take him out. 10 points wins.

  • 8/9/2019 Halo2 Server

    29/29

    Juggernaut Phantom Fodder You're invisible but you have no motion sensor.You're being hunted, so watch out! 3 rounds wins, 5points wins a round.

    Default Variants Listing (continued)Game type Base variant name Description

    Juggernaut Dreadnaut The Dreadnaut is an unstoppable beast. Fear himbut work together to take him out. 20 kills asJuggernaut wins the game.

    Capture theFlag

    Multi Flag CTF Defend your flag while launching a coordinatedattack on your enemy's flag. 3 captures to win.

    Capture theFlag

    CTF Classic Defend your flag while capturing the enemy's. 3points wins, flag must be home to score, flag may bereturned.

    Capture theFlag

    1 Flag CTF Take turns on offense/defense. A capture wins around. Flag may not be returned. Rounds last 3minutes. First to 3 wins.

    Capture the

    Flag

    1 Flag CTF Fast Intense 2 minute rounds of alternating

    offense/defense. A capture wins a round. Flag maynot be returned. First to 3 wins.

    Assault Multi Bomb Defend your base while trying to deliver your bombinto the enemy's base. 3 successful bombings wins.

    Assault Single Bomb Take turns on offense/defense. A successfulbombing wins a round. First to 3 wins. No bombreturn. Rounds last 3 minutes.

    Assault Single Bomb Fast Intense 2 minute rounds of offense/defense. Asuccessful bombing wins a round. Bomb may not bereturned. First to 3 wins.

    Assault Neutral Bomb There's just one bomb that starts in the middle. Use itto bomb the enemy base 3 times to win.

    Assault Blast Resort You have just 1 life and no motion sensor in this

    single bomb game. 10 second arming, 3 minuterounds, first to 3 wins.

    Territories 3 Plots There are just 3 territories. Earn 3 minutes controltime before your opponents by owning a majority ofthem.

    Territories Land Grab Own a majority of territories to earn 5 minutes controltime before your opponents.

    Territories Gold Rush Grab your pistol and load your shotgun! 2 minuteswins a round. Rounds last 3 minutes. First to 3rounds wins.

    Territories Control Issues Bring out the big guns to fight for control of just 2territories. Everyone has overshields, 5 minutescontrol time wins.

    Territories Contention There's just one territory on the map. Work with your team to control it for 2 minutes to win.