GAMEMODE: Difference between revisions
(Added a section that explains the "GameSettings" and "LockedGameSettings" feature in 3.1-alpha, and some examples showing how to use them.) |
(Made a few changes to the "GameSettings" section, also added some information on a new flag in 3.1-alpha.) |
||
Line 3: | Line 3: | ||
<pre> | <pre> | ||
GAMEMODENAME { | GAMEMODENAME | ||
{ | |||
RemoveFlag FLAGNAME1 | |||
AddFlag FLAGNAME2 | |||
GameSettings | |||
{ | |||
flagname1 = true | |||
flagname2 = false | |||
} | |||
LockedGameSettings | |||
{ | |||
flagname3 = true | |||
} | |||
} | } | ||
</pre> | </pre> | ||
Line 34: | Line 46: | ||
*''USETEAMITEM'' | *''USETEAMITEM'' | ||
*''MAPRESET_RESETS_MAPTIME'' | *''MAPRESET_RESETS_MAPTIME'' | ||
*''DONTPRINTPLAYERSLEFT'' {{Devfeature|3.1|alpha}} | |||
Prevents the "x allies/opponents left" message from being drawn on the screen. | |||
=Gameplay and compatibility settings= | =Gameplay and compatibility settings= | ||
Line 50: | Line 64: | ||
* '''LockedGameSettings''' - flags can never be changed, and attempting to do so will print an error message. This is useful for mods that need certain flags enabled or disabled and don't want the host to mess with those settings. | * '''LockedGameSettings''' - flags can never be changed, and attempting to do so will print an error message. This is useful for mods that need certain flags enabled or disabled and don't want the host to mess with those settings. | ||
Flags are enabled using either <code>true</code> or <code>1</code>, or disabled using either <code>false</code> or <code>0</code>. | If you want to initialize flags universally for your mod, you can add the '''DefaultGameSettings''' or '''DefaultLockedGameSettings''' blocks at the beginning of the file, which are applied across all game modes. You may then override some of these flags by also adding them to specific game modes. Additionally, if you want to remove a flag from a game mode, use '''RemoveGameSetting''' followed by the flag's name. Flags are enabled using either <code>true</code> or <code>1</code>, or disabled using either <code>false</code> or <code>0</code>. | ||
'''Note:''' loading another '''DefaultGameSettings''' or '''DefaultLockedGameSettings''' block in a subsequent GAMEMODE lump will reset all the flags and their attributes back to zero. | |||
=Gamemode names= | =Gamemode names= |
Revision as of 12:16, 27 September 2021
This special lump allows the current SkullTag game modes to be reconfigured. Such game modes can be Deathmatch, Duel, SkullTag, Capture the Flag, Possession, etc.... The hard coded game modes internally use a bunch of flags to configure certain stuff and to share code. The GAMEMODE lump allows you to alter the flags a game mode uses so that you can combine game mode traits. The syntax for the lump is as follows:
GAMEMODENAME { RemoveFlag FLAGNAME1 AddFlag FLAGNAME2 GameSettings { flagname1 = true flagname2 = false } LockedGameSettings { flagname3 = true } }
Flags
- COOPERATIVE
Cooperative is a flag that distinguishes the coop modes (Cooperative, Survival, Invasion) from others game modes.
- DEATHMATCH
Players are spawned at deathmatch starts (needs Zandronum 3.0 to work properly).
- TEAMGAME
Players are spawned at team starts (needs Zandronum 3.0 to work properly).
- USEFLAGASTEAMITEM
- PLAYERSEARNKILLS
Display the players kills (monsters) on the scoreboard
- PLAYERSEARNFRAGS
Display the players frags on the scoreboard
- PLAYERSEARNPOINTS
Display the players points (score in ctf)
- PLAYERSEARNWINS
Display the players wins on the scoreboard (used in lms)
- DONTSPAWNMAPTHINGS
Items and weapons aren't spawned (monsters are still spawned)
- MAPRESETS
- DEADSPECTATORS
- PLAYERSONTEAMS
Display the team selection menu when pressing the spacebar (joining)
- USEMAXLIVES
- USETEAMITEM
- MAPRESET_RESETS_MAPTIME
- DONTPRINTPLAYERSLEFT (development version 3.1-alpha and above only)
Prevents the "x allies/opponents left" message from being drawn on the screen.
Gameplay and compatibility settings
(development version 3.1-alpha and above only) You can initialize any flags belonging to gameplay or compatibility flagsets for a particular game mode. The flagsets that are currently supported are:
- DMFlags
- DMFlags2
- ZaDMFlags
- CompatFlags
- CompatFlags2
- ZaCompatFlags
- LMSAllowedWeapons
- LMSSpectatorSettings
There are two different blocks that are used to initialize these flags, with different attributes:
- GameSettings - flags can still be changed during gameplay. This is useful for mods that want to change certain flags by default but still allow the host to change as they see fit.
- LockedGameSettings - flags can never be changed, and attempting to do so will print an error message. This is useful for mods that need certain flags enabled or disabled and don't want the host to mess with those settings.
If you want to initialize flags universally for your mod, you can add the DefaultGameSettings or DefaultLockedGameSettings blocks at the beginning of the file, which are applied across all game modes. You may then override some of these flags by also adding them to specific game modes. Additionally, if you want to remove a flag from a game mode, use RemoveGameSetting followed by the flag's name. Flags are enabled using either true
or 1
, or disabled using either false
or 0
.
Note: loading another DefaultGameSettings or DefaultLockedGameSettings block in a subsequent GAMEMODE lump will reset all the flags and their attributes back to zero.
Gamemode names
Must be one of the following:
- Cooperative
- Survival
- Invasion
- Deathmatch
- Teamplay
- Duel
- Terminator
- LastManStanding
- TeamLMS
- Possession
- TeamPossession
- TeamGame
- CTF
- OneFlagCTF
- Skulltag
- Domination
Example
For instance, if you would like to have teams in coop, the lump needs to be:
cooperative { addflag PLAYERSONTEAMS }
A cooperative-based mod might want players to be able to walk and shoot through their teammates, and also prevent their attacks from pushing them around. Note that here, the server host has the option to enable or disable these flags if they feel like it.
Cooperative { GameSettings { sv_unblockallies = true sv_shootthroughallies = true sv_dontpushallies = true } }
This initializes some LMSFlags for the Last Man Standing game mode. By default, players can't start with a pistol or chainsaw, but they are guarantee to start with a plasma rifle. In addition, spectators are free to view and chat with live players. Note that here, the server host is allowed to modify lms_allowpistol and lms_spectatorchat, but is forbidden from changing lms_allowchainsaw, lms_allowplasma, and lms_spectatorview.
LastManStanding { GameSettings { lms_allowpistol = false lms_spectatorchat = true } LockedGameSettings { lms_allowchainsaw = false lms_allowplasma = true lms_spectatorview = true } }