Difference between revisions of "Galileo"

From AlliedModders Wiki
Jump to: navigation, search
m (→‎Weighted Admin Votes)
(→‎gal_vote_mapfiletype: no longer used)
 
(45 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Provides a variety of next map choosing features. Intended to be used in place of all other map choosing plugins such as Deagles' Map Manager and AMXX's own mapchooser.
+
This wiki entry is outdated, see [https://forums.alliedmods.net/showthread.php?t=77391 the plugin's forum thread] for an updated list of cvars.
  
−
None of the features are enabled by default. As such, it acts much like AMXX's mapchooser.  The power comes when you enable some of the features of MCP.
+
<div class="townBox" style="background-color:pink">It is <span style="color:red">'''strongly'''</span> recommended that you disable both '''nextmap.amxx''' and '''mapchooser.amxx''' from within your '''plugins.ini''' file when using this plugin.</div>
 +
Provides a variety of next map choosing features. Intended to be used in place of all other map choosing plugins such as Deagles' Map Manager and <span title="AMX Mod X" style="border-bottom:1px dotted">AMXX</span>'s own mapchooser.  It contains more customizable features than either of those.
  
 +
All the features of Galileo are described below. The biggest three are [[#Map Nominations|nominations]], [[#Rock the Vote|rock the vote]], and [[#Runoff Voting|runoff voting]].
 +
<br>
 +
<br>
 +
==General Voting==
 +
 +
These CVARs and commands may be used with or without enabling any of the other features. When specific features utilize any of these CVARs and commands, they'll be listed again in that feature's section.
 +
 +
===CVARs===
 +
====gal_vote_mapfile ''<cFile>''====
 +
:{|
 +
|-
 +
|
 +
|-
 +
|Specifies the file to use which either holds the names of the maps that players can nominate or is used in the map group feature to indicate how many maps to use from each group as determined by the ''gal_vote_mapfiletype'' CVAR.
 +
 +
There is no default value.
 +
 +
If left blank, which it is by default, addons/amxmodx/configs/galileo/votefill.ini will be used.  Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).
 +
 +
Example Values:
 +
 +
:* mapcycle.txt
 +
:* ../../common_configs/galileo/votefill.ini
 +
:* addons/amxmodx/configs/galileo/nominatable.ini
 +
|}
 +
 +
====gal_vote_mapfiletype ''<1|2>''====
 +
 +
{{note|This cvar is no longer used. Detection is done through a [groups] header. See [http://v.gd/Tv9T8b forum post].}}
 +
 +
Specifies the type of file ''gal_vote_mapfile'' is being used as.
 +
 +
{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 1
 +
| map listing
 +
|- class="t2td"
 +
| 2
 +
| map group listing
 +
|}
 +
 +
The default is '''1'''.
 +
 +
When the value is '''1''', the file specified by ''gal_vote_mapfile'' is a listing of maps.  Each map should be listed, one per line.  Just like is done in '''mapcycle.txt'''.
 +
 +
Here is a short example:
 +
 +
as_oilrig
 +
cs_747
 +
cs_assault
 +
cs_backalley
 +
cs_estate
 +
cs_havana
 +
 +
When the value is '''2''', the file specified by ''gal_vote_mapfile'' is formatted differently.  Instead of listing maps, you would list the count of maps to pick from each map group, one count per line.  You can have a maximum of 8 counts listed.  This allows you to prioritize different groups of maps to use in filling a vote.  It allows you to say, "pick up to X maps from this group first, then pick up to Y maps from this other group".  You can have a maximum of 8 groups.
 +
 +
Here is an example of 3 counts listed:
 +
 +
3
 +
3
 +
2
 +
 +
The counts should not total more than the number of maps you allow in the vote.  In the case of this example, the counts add up to 8, which happens to be the maximum number of maps that can be allowed in a vote.
 +
 +
Since I've listed three different counts, I'll need 3 different files to keep my map listings in.
 +
 +
The files must be named and located as such:
 +
 +
:./amxmodx/configs/galileo/votefill/1.ini
 +
:./amxmodx/configs/galileo/votefill/2.ini
 +
:./amxmodx/configs/galileo/votefill/3.ini
 +
 +
Each of those files, '''1.ini''', '''2.ini''', and '''3.ini''', should contain a listing of maps.
 +
 +
Galileo will first load any nominated maps into the vote.  It will then grab up to 3 maps from '''1.ini''', up to 3 from '''2.ini''', and up to 2 from '''3.ini'''.
 +
 +
====gal_vote_duration ''<iSeconds>''====
 +
Specifies how long a map vote should last.
 +
 +
The default is '''15''' seconds.
 +
 +
====gal_vote_expirationcountdown ''<0|1>''====
 +
Specifies whether the vote expiration countdown should be displayed when there are 10 or fewer seconds left in a vote. It will count down from 10 to 0, at which point the vote will be over.  It will only show to players that have not yet voted.
 +
 +
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| do not show the countdown
 +
|- class="t2td"
 +
| 1
 +
| show the countdown
 +
|}
 +
 +
The default is '''1'''.
 +
 +
====gal_vote_announcechoice ''<0|1>''====
 +
Specifies whether to announce each player's choice.
 +
 +
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| do not announce player's choice
 +
|- class="t2td"
 +
| 1
 +
| announce player's choice
 +
|}
 +
 +
The default is '''1'''.
 +
 +
====gal_vote_showstatus ''<0|1|2>''====
 +
Specifies when the vote progress should be shown to a player.  A value of 0 disables this feature.
 +
 +
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| never
 +
|- class="t2td"
 +
| 1
 +
| after player has voted
 +
|- class="t2td"
 +
| 2
 +
| after vote ends
 +
|}
 +
 +
The default is '''0'''.
 +
 +
====gal_vote_showstatustype ''<1|2>''====
 +
Specifies how to show the progress of a vote.
 +
 +
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 1
 +
| as vote count
 +
|- class="t2td"
 +
| 2
 +
| as percentage of all votes cast
 +
|}
 +
 +
The default is '''2'''.
 +
 +
====amx_extendmap_max ''<fMinutes>''====
 +
Specifies the maximum number of minutes a map can be played.
 +
 +
A value less than ''mp_timelimit'' will not let the map be extended. This is the same CVAR that AMXX provides.
 +
 +
The default is '''90''' minutes.
 +
 +
====amx_extendmap_step ''<fMinutes>''====
 +
Specifies the number of minutes a map will be extended each time the "Extend Map" option wins the map vote.
 +
 +
This is the same CVAR that AMXX provides.
 +
 +
The default is '''15''' minutes.
 +
 +
 +
===Console Commands===
 +
 +
====gal_startvote====
 +
Immediately starts a map vote.
 +
 +
====gal_createmapfile ''[cFlags|cFilename]''====
 +
Creates a map file listing all the maps located in the '''maps''' folder of the server.
 +
 +
There are various parameters that can be used with this command. 
 +
 +
*If the command is used without any additional parameters, it will create a file named "allmaps.ini" in your game mod folder (i.e. "cstrike", "dod", "czero", etc).
 +
*If a filename is specified, it will attempt to create that file.  It must be a full qualified filename starting from your game mod folder.  See the '''gal_nom_mapfile''' CVAR for examples of what you can enter as a filename.
 +
*If "n", "v", or "nv" is specified, the files created will be based on the CVARs for nominatable maps and/or votefill maps, as applicable.  See the '''gal_nom_mapfile''' CVAR to determine the name of the file that will be created when using the "n" flag.  See the '''gal_votefill_mapfile''' CVAR to determine the name of the file that will be created when using the "v" flag.
 +
 +
==Server Features==
 +
 +
A variety of features related to the server.
 +
 +
===CVARs===
 +
 +
====gal_srv_onrestart ''<iAction>''====
 +
Specifies which action to take when it is detected that the server has been restarted.
 +
 +
:{|
 +
|- class="t2th"
 +
| Flag
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| default HL1 behavior
 +
|- class="t2td"
 +
| 1
 +
| change to map being played at time of restart
 +
|- class="t2td"
 +
| 2
 +
| change to what would have been the next map if not for the restart
 +
|- class="t2td"
 +
| 3
 +
| start a map vote after the first two minutes
 +
|- class="t2td"
 +
| 4
 +
| change to a randomly selected map from your nominatable maps
 +
|}
 +
 +
The default is '''0'''.
  
 
==Map Nominations==
 
==Map Nominations==
Line 8: Line 224:
 
Allows players to nominate maps for inclusion in the next map vote.
 
Allows players to nominate maps for inclusion in the next map vote.
  
−
Not all nominations are guaranteed to be used.  If there are more nominations than are allowed in the vote, a random selection of the nominations will be used.  See the mcp_nom_qtyused CVAR description for more detail.
+
Not all nominations are guaranteed to be used.  If there are more nominations than are allowed in the vote, a random selection of the nominations will be used.  See the gal_nom_qtyused CVAR description for more detail.
  
 
If a player disconnects, any nominations they had made will be cancelled.
 
If a player disconnects, any nominations they had made will be cancelled.
Line 14: Line 230:
 
===CVARs===
 
===CVARs===
  
−
====mcp_nom_playerallowance ''<iNominationCnt>''====
+
====gal_nom_playerallowance ''<iNominationCnt>''====
 
Specifies how many nominations each player can make.  A value of 0 will disable this feature.
 
Specifies how many nominations each player can make.  A value of 0 will disable this feature.
  
 
The default is '''2''' nominations.
 
The default is '''2''' nominations.
  
−
====mcp_nom_mapfile ''<cFile>''====
+
====gal_nom_mapfile ''<cFile>''====
 
Specifies the file to use which holds the names of the maps that players can nominate.
 
Specifies the file to use which holds the names of the maps that players can nominate.
  
 
There is no default value.
 
There is no default value.
  
−
If left blank, which it is by default, '''addons/amxmodx/configs/mcp/nominatable.ini''' will be used.  Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).
+
If left blank, which it is by default, '''addons/amxmodx/configs/galileo/nominatable.ini''' will be used.  Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).
  
 
Example Values:
 
Example Values:
  
 
*mapcycle.txt
 
*mapcycle.txt
−
*../../common_configs/mcp/nominatable.ini
+
*../../common_configs/galileo/nominatable.ini
  
−
====mcp_nom_qtyused ''<iNominationCnt>''====
+
====gal_nom_qtyused ''<iNominationCnt>''====
−
Specifies how many of the nominations made will be used in the next map vote.  A value of 0 means all the nominated maps will be used.
+
Specifies how many of the nominations made will be considered for use in the next map vote.  A value of 0 means all the nominated maps will be considered.
  
 
The default is '''0''' (all nominations).
 
The default is '''0''' (all nominations).
  
−
====mcp_banrecent ''<iMapCount>''====
+
====gal_banrecent ''<iMapCount>''====
 
Specifies the number of recently played maps to disallow from being nominated.
 
Specifies the number of recently played maps to disallow from being nominated.
  
 
The default is '''3''' maps.
 
The default is '''3''' maps.
 +
  
 
===Console Commands===
 
===Console Commands===
  
−
====mpc_nom_listmaps====
+
====gal_listmaps ''[partial mapname]''====
−
Lists all the nominatable maps as defined in the nominatable map file.  See the '''mcp_nom_mapfile''' CVAR description for more detail.
+
Lists all the nominatable maps as defined in the nominatable map file.  See the '''gal_nom_mapfile''' CVAR description for more detail.
 +
 
 +
If a partial map name is given, only maps that contain the partial map name will be listed.
  
−
====mcp_createmapfile ''[cFlags|cFilename]''====
+
====gal_createmapfile ''[cFlags|cFilename]''====
 
Creates a map file listing all the maps located in the '''maps''' folder of the server.
 
Creates a map file listing all the maps located in the '''maps''' folder of the server.
  
Line 52: Line 271:
  
 
*If the command is used without any additional parameters, it will create a file named "allmaps.ini" in your game mod folder (i.e. "cstrike", "dod", "czero", etc).
 
*If the command is used without any additional parameters, it will create a file named "allmaps.ini" in your game mod folder (i.e. "cstrike", "dod", "czero", etc).
−
*If a filename is specified, it will attempt to create that file.  It must be a full qualified filename starting from your game mod folder.  See the '''mcp_nom_mapfile''' CVAR for examples of what you can enter as a filename.
+
*If a filename is specified, it will attempt to create that file.  It must be a full qualified filename starting from your game mod folder.  See the '''gal_nom_mapfile''' CVAR for examples of what you can enter as a filename.
−
*If "n", "v", or "nv" is specified, the files created will be based on the CVARs for nominatable maps and/or votefill maps, as applicable.  See the '''mcp_nom_mapfile''' CVAR to determine the name of the file that will be created when using the "n" flag.  See the '''mcp_votefill_mapfile''' CVAR to determine the name of the file that will be created when using the "v" flag.
+
*If "n", "v", or "nv" is specified, the files created will be based on the CVARs for nominatable maps and/or votefill maps, as applicable.  See the '''gal_nom_mapfile''' CVAR to determine the name of the file that will be created when using the "n" flag.  See the '''gal_votefill_mapfile''' CVAR to determine the name of the file that will be created when using the "v" flag.
 +
 
  
 
===Say Commands===
 
===Say Commands===
Line 68: Line 288:
 
====''<map>''====
 
====''<map>''====
 
Toggles between nominating and cancelling the specified map.
 
Toggles between nominating and cancelling the specified map.
−
 
  
 
==Rock the Vote==
 
==Rock the Vote==
Line 74: Line 293:
  
 
===CVARs===
 
===CVARs===
−
====mcp_rtv_start ''<fMinutes>''====
 
−
Specifies the number of minutes after a map starts, that players may begin to rock the vote.
 
  
−
The default is '''10''' minutes.
+
====gal_rtv_commands ''<iFlags>''====
 +
Specifies which say commands can be used to rock the vote.  A value of 0 will disable this feature.
  
−
====mcp_rtv_players ''<fPercentage>''====
+
:The flags are additive.
−
Indicates the percentage of players that need to rock the vote before a vote will be forced to occur.
+
:{|
 +
|- class="t2th"
 +
| Flag
 +
| Description
 +
|- class="t2td"
 +
| 1
 +
| standard "'''rockthevote'''" command
 +
|- class="t2td"
 +
| 2
 +
| shorthand "'''rtv'''" command
 +
|- class="t2td"
 +
| 4
 +
| dynamic "'''rockthe'''''<anything>'''''vote'''" command
 +
|}
  
−
The default is '''0.60''' (60%).
+
The default is '''3'''.
  
−
====mcp_rtv_commands ''<iFlags>''====
+
The dynamic "rockthe''<anything>''vote" command allows a player to type any one word (i.e. no spaces) that starts with "rockthe" and ends with "vote".  Some examples might be: "rockthedamnvote", "rockthesillylittlevote", or "rockthefreakingvote".  The total length of the word can not be longer than 31 characters.  That leaves 20 characters for creativeness once you factor in the lengths of "rockthe" and "vote".
−
Specifies which say commands can be used to rock the vote.  A value of 0 will disable this feature.
 
  
−
:The flags are additive.
+
====gal_rtv_start ''<fMinutes>''====
 +
Specifies the number of minutes after a map starts that players may begin to rock the vote.
  
−
:1: standard "'''rockthevote'''" command
+
The default is '''10''' minutes.
−
:2: shorthand "'''rtv'''" command
 
−
:4: dynamic "'''rockthe'''''<anything>'''''vote'''" command
 
  
−
The default is '''1'''.
+
====gal_rtv_ratio ''<fRatio>''====
 +
Indicates the ratio of players that need to rock the vote before a vote will be forced to occur.
  
−
The dynamic "rockthe''<anything>''vote" command allows a player to type any one word (i.e. no spaces) that starts with "rockthe" and ends with "vote".  Some examples might be: "rockthedamnvote", "rockthesillylittlevote", or "rockthefreakingvote".  The total length of the word can not be longer than 31 characters.  That leaves 20 characters for creativeness once you factor in the lengths of "rockthe" and "vote".
+
The default is '''0.60''' (60%).
  
 
===Say Commands===
 
===Say Commands===
 +
 
====rockthevote====
 
====rockthevote====
 
Registers the player's desire for an early map vote.
 
Registers the player's desire for an early map vote.
Line 105: Line 336:
  
 
====rockthe''<anything>''vote====
 
====rockthe''<anything>''vote====
−
Alias for "rockthevote".  This is the dynamic command.  See the '''mcp_rtv_commands''' CVAR description for more detail.
+
Alias for "rockthevote".  This is the dynamic command.  See the '''gal_rtv_commands''' CVAR description for more detail.
  
 +
==Runoff Voting==
  
−
==Runoff Voting==
 
 
Allows a secondary vote of the two highest vote getting maps if a single map doesn't win the first vote by more than 50% of the total votes.
 
Allows a secondary vote of the two highest vote getting maps if a single map doesn't win the first vote by more than 50% of the total votes.
  
−
The runoff vote will utilize the applicable '''mcp_vote_*''' CVARs, with the exception of '''mcp_vote_duration''', which is overridden by '''mcp_runoff_duration'''.
+
The runoff vote will utilize the applicable '''gal_vote_*''' CVARs, with the exception of '''gal_vote_duration''', which is overridden by '''gal_runoff_duration'''.
  
 
Runoff voting can only occur if there are more than two maps with votes in the first vote.
 
Runoff voting can only occur if there are more than two maps with votes in the first vote.
  
 
===CVARs===
 
===CVARs===
−
====mcp_runoff_enabled ''<0|1>''====
+
 
 +
====gal_runoff_enabled ''<0|1>''====
 
Specifies whether to allow runoff voting or not.
 
Specifies whether to allow runoff voting or not.
  
−
:0: Disable
+
:{|
−
:1: Enable
+
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| disable
 +
|- class="t2td"
 +
| 1
 +
| enable
 +
|}
  
 
The default is '''0'''.
 
The default is '''0'''.
  
−
====mcp_runoff_duration ''<iSeconds>''====
+
====gal_runoff_duration ''<iSeconds>''====
 
Specifies the number of seconds the runoff vote should last.
 
Specifies the number of seconds the runoff vote should last.
  
 
The default is '''10''' seconds.
 
The default is '''10''' seconds.
  
 +
==Ban Recent Maps==
  
−
==Vote Filler Groups==
+
Allows you to disallow recent maps from being voted on.
−
Allows you to prioritize different groups of maps to use in filling a vote.  It allows you to say, "pick up to X maps from this group first, then pick up to Y maps from this other group".  You can have a maximum of 8 groups.
 
  
 
===CVARs===
 
===CVARs===
−
====mcp_vote_mapfile ''<cFile>''====
 
−
Specifies the file to use which either holds the names of the maps that players can nominate or is used in the map group feature to indicate how many maps to use from each group as determined by the ''mcp_vote_mapfiletype'' CVAR.
 
−
 
−
There is no default value.
 
  
−
If left blank, which it is by default, addons/amxmodx/configs/mcp/votefill.ini will be used.  Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).
+
====gal_banrecent ''<iMapCount>''====
 +
Specifies how many of the most recent maps are disallowed from a map vote. A value of 0 will disable this feature.
  
−
Example Values:
+
The default is '''3'''.
  
−
:* mapcycle.txt
+
====gal_banrecentstyle ''<iStyle>''====
−
:* ../../common_configs/mcp/votefill.ini
+
Indicates the style in which the recent maps are displayed.
  
−
====mcp_vote_mapfiletype ''<1|2>''====
+
:{|
−
Specifies the type of file ''mcp_vote_mapfile'' is being used as.
+
|- class="t2th"
−
 
+
| Setting
−
:1: map listing
+
| Description
−
:2: map group listing
+
|- class="t2td"
 +
| 1
 +
| all maps on one line
 +
|- class="t2td"
 +
| 2
 +
| each map on a separate line
 +
|}
  
 
The default is '''1'''.
 
The default is '''1'''.
  
−
When the value is 1, the file specified by ''mcp_vote_mapfile'' is a listing of maps.  Each map should be listed, one per line.  Just like is done in '''mapcycle.txt'''.
+
==Weighted Admin Votes==
  
−
Here is a short example:
+
Allows admins to have a weighted (counted as more than 1) vote.
  
−
:as_oilrig
+
===CVARs===
−
:cs_747
 
−
:cs_assault
 
−
:cs_backalley
 
−
:cs_estate
 
−
:cs_havana
 
  
−
When the value is 2, the file specified by ''mcp_vote_mapfile'' is formatted differently.  Instead of listing maps, you would list the count of maps to pick from each map group, one count per line.  You can have a maximum of 8 counts listed.
+
====gal_vote_weight ''<iVoteWeight>''====
 +
Specifies how many votes a single admin vote should count as.  A value of 0 or 1 will disable this feature.
  
−
Here is an example of 3 counts listed:
+
The default is '''2'''.
  
−
:3
+
====gal_vote_weight_flags ''<cAdminFlags>''====
−
:3
+
Specifies the [[Adding Admins (AMX Mod X)#Access Levels|standard access flags]] needed to have weighted votes. You can specify multiple flags.
−
:2
 
  
−
The counts should not total more than the number of maps you allow in the vote.  In the case of this example, the counts add up to 8, which happens to be the maximum number of maps that can be allowed in a vote.
+
The default is "'''y'''" (the ADMIN_ADMIN flag).
  
−
Since I've listed three different counts, I'll need 3 different files to keep my map listings in.
+
==Disable "votemap" and "listmaps" Commands==
  
−
The files must be named and located as such:
+
Allows the standard HL1 '''votemap''' command, and it's associated '''listmaps''' command, to be completely disabled.
  
−
:./amxmodx/configs/mcp/votefill/1.ini
+
===CVARs===
−
:./amxmodx/configs/mcp/votefill/2.ini
 
−
:./amxmodx/configs/mcp/votefill/3.ini
 
  
−
Each of those files, '''1.ini''', '''2.ini''', and '''3.ini''', should contain a listing of maps.
+
====gal_disable_votemap ''<0|1>''====
 +
Indicates if players can use the standard HL1 '''votemap''' and '''listmaps''' commands.
  
−
MCP will first load any nominated maps into the vote.  It will then grab up to 3 maps from '''1.ini''', up to 3 from '''2.ini''', and up to 2 from '''3.ini'''.
+
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| enable (standard behavior)
 +
|- class="t2td"
 +
| 1
 +
| disable both commands
 +
|}
  
−
==Vote Status Display==
+
The default is '''0'''.
  
−
==Disallow Recent Maps from Votes==
+
==Change Map at End of Round==
  
−
==Weighted Admin Votes==
+
Allows map changes to happen either immediately or after the end of a round, when time runs out. Useful for round-based servers.
−
Allows admins to have a weighted (counted as more than 1) vote.
 
  
−
===CVARs===
+
===CVARS===
  
−
====mcp_vote_weight ''<iVoteWeight>''====
+
====gal_endonround ''<0|1>''====
−
Specifies how many votes a single admin vote should count as.  A value of 0 or 1 will disable this feature.
+
Indicates when a map should end when time runs out.
  
−
The default is '''2'''.
+
:{|
 +
|- class="t2th"
 +
| Setting
 +
| Description
 +
|- class="t2td"
 +
| 0
 +
| change map immediately (standard behavior)
 +
|- class="t2td"
 +
| 1
 +
| change map after a round ends
 +
|}
  
−
====mcp_vote_weight_flags ''<cAdminFlags>''====
+
The default is '''1'''.
−
Specifies the [[Adding Admins (AMX Mod X)#Access Levels|standard access flags]] needed to have weighted votes.
 
  
−
The default is "'''y'''" (the ADMIN_ADMIN flag).
+
[[Category:3rd Party Plugins (AMX Mod X)]]

Latest revision as of 13:05, 24 February 2015

This wiki entry is outdated, see the plugin's forum thread for an updated list of cvars.

It is strongly recommended that you disable both nextmap.amxx and mapchooser.amxx from within your plugins.ini file when using this plugin.

Provides a variety of next map choosing features. Intended to be used in place of all other map choosing plugins such as Deagles' Map Manager and AMXX's own mapchooser. It contains more customizable features than either of those.

All the features of Galileo are described below. The biggest three are nominations, rock the vote, and runoff voting.

Contents

General Voting

These CVARs and commands may be used with or without enabling any of the other features. When specific features utilize any of these CVARs and commands, they'll be listed again in that feature's section.

CVARs

gal_vote_mapfile <cFile>

Specifies the file to use which either holds the names of the maps that players can nominate or is used in the map group feature to indicate how many maps to use from each group as determined by the gal_vote_mapfiletype CVAR.

There is no default value.

If left blank, which it is by default, addons/amxmodx/configs/galileo/votefill.ini will be used. Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).

Example Values:

  • mapcycle.txt
  • ../../common_configs/galileo/votefill.ini
  • addons/amxmodx/configs/galileo/nominatable.ini

gal_vote_mapfiletype <1|2>

Note:This cvar is no longer used. Detection is done through a [groups] header. See forum post.

Specifies the type of file gal_vote_mapfile is being used as.

Setting Description
1 map listing
2 map group listing

The default is 1.

When the value is 1, the file specified by gal_vote_mapfile is a listing of maps. Each map should be listed, one per line. Just like is done in mapcycle.txt.

Here is a short example: 

as_oilrig
cs_747
cs_assault
cs_backalley
cs_estate
cs_havana

When the value is 2, the file specified by gal_vote_mapfile is formatted differently. Instead of listing maps, you would list the count of maps to pick from each map group, one count per line. You can have a maximum of 8 counts listed. This allows you to prioritize different groups of maps to use in filling a vote. It allows you to say, "pick up to X maps from this group first, then pick up to Y maps from this other group". You can have a maximum of 8 groups.

Here is an example of 3 counts listed: 

3
3
2

The counts should not total more than the number of maps you allow in the vote. In the case of this example, the counts add up to 8, which happens to be the maximum number of maps that can be allowed in a vote.

Since I've listed three different counts, I'll need 3 different files to keep my map listings in.

The files must be named and located as such:

./amxmodx/configs/galileo/votefill/1.ini
./amxmodx/configs/galileo/votefill/2.ini
./amxmodx/configs/galileo/votefill/3.ini

Each of those files, 1.ini, 2.ini, and 3.ini, should contain a listing of maps.

Galileo will first load any nominated maps into the vote. It will then grab up to 3 maps from 1.ini, up to 3 from 2.ini, and up to 2 from 3.ini.

gal_vote_duration <iSeconds>

Specifies how long a map vote should last.

The default is 15 seconds.

gal_vote_expirationcountdown <0|1>

Specifies whether the vote expiration countdown should be displayed when there are 10 or fewer seconds left in a vote. It will count down from 10 to 0, at which point the vote will be over. It will only show to players that have not yet voted.

Setting Description
0 do not show the countdown
1 show the countdown

The default is 1.

gal_vote_announcechoice <0|1>

Specifies whether to announce each player's choice.

Setting Description
0 do not announce player's choice
1 announce player's choice

The default is 1.

gal_vote_showstatus <0|1|2>

Specifies when the vote progress should be shown to a player. A value of 0 disables this feature.

Setting Description
0 never
1 after player has voted
2 after vote ends

The default is 0.

gal_vote_showstatustype <1|2>

Specifies how to show the progress of a vote.

Setting Description
1 as vote count
2 as percentage of all votes cast

The default is 2.

amx_extendmap_max <fMinutes>

Specifies the maximum number of minutes a map can be played.

A value less than mp_timelimit will not let the map be extended. This is the same CVAR that AMXX provides.

The default is 90 minutes.

amx_extendmap_step <fMinutes>

Specifies the number of minutes a map will be extended each time the "Extend Map" option wins the map vote.

This is the same CVAR that AMXX provides.

The default is 15 minutes.


Console Commands

gal_startvote

Immediately starts a map vote.

gal_createmapfile [cFlags|cFilename]

Creates a map file listing all the maps located in the maps folder of the server.

There are various parameters that can be used with this command.

  • If the command is used without any additional parameters, it will create a file named "allmaps.ini" in your game mod folder (i.e. "cstrike", "dod", "czero", etc).
  • If a filename is specified, it will attempt to create that file. It must be a full qualified filename starting from your game mod folder. See the gal_nom_mapfile CVAR for examples of what you can enter as a filename.
  • If "n", "v", or "nv" is specified, the files created will be based on the CVARs for nominatable maps and/or votefill maps, as applicable. See the gal_nom_mapfile CVAR to determine the name of the file that will be created when using the "n" flag. See the gal_votefill_mapfile CVAR to determine the name of the file that will be created when using the "v" flag.

Server Features

A variety of features related to the server.

CVARs

gal_srv_onrestart <iAction>

Specifies which action to take when it is detected that the server has been restarted.

Flag Description
0 default HL1 behavior
1 change to map being played at time of restart
2 change to what would have been the next map if not for the restart
3 start a map vote after the first two minutes
4 change to a randomly selected map from your nominatable maps

The default is 0.

Map Nominations

Allows players to nominate maps for inclusion in the next map vote.

Not all nominations are guaranteed to be used. If there are more nominations than are allowed in the vote, a random selection of the nominations will be used. See the gal_nom_qtyused CVAR description for more detail.

If a player disconnects, any nominations they had made will be cancelled.

CVARs

gal_nom_playerallowance <iNominationCnt>

Specifies how many nominations each player can make. A value of 0 will disable this feature.

The default is 2 nominations.

gal_nom_mapfile <cFile>

Specifies the file to use which holds the names of the maps that players can nominate.

There is no default value.

If left blank, which it is by default, addons/amxmodx/configs/galileo/nominatable.ini will be used. Otherwise, you must specify a fully qualified filename starting from your game mod folder (i.e. "cstrike", "dod", "czero", etc).

Example Values:

  • mapcycle.txt
  • ../../common_configs/galileo/nominatable.ini

gal_nom_qtyused <iNominationCnt>

Specifies how many of the nominations made will be considered for use in the next map vote. A value of 0 means all the nominated maps will be considered.

The default is 0 (all nominations).

gal_banrecent <iMapCount>

Specifies the number of recently played maps to disallow from being nominated.

The default is 3 maps.


Console Commands

gal_listmaps [partial mapname]

Lists all the nominatable maps as defined in the nominatable map file. See the gal_nom_mapfile CVAR description for more detail.

If a partial map name is given, only maps that contain the partial map name will be listed.

gal_createmapfile [cFlags|cFilename]

Creates a map file listing all the maps located in the maps folder of the server.

There are various parameters that can be used with this command.

  • If the command is used without any additional parameters, it will create a file named "allmaps.ini" in your game mod folder (i.e. "cstrike", "dod", "czero", etc).
  • If a filename is specified, it will attempt to create that file. It must be a full qualified filename starting from your game mod folder. See the gal_nom_mapfile CVAR for examples of what you can enter as a filename.
  • If "n", "v", or "nv" is specified, the files created will be based on the CVARs for nominatable maps and/or votefill maps, as applicable. See the gal_nom_mapfile CVAR to determine the name of the file that will be created when using the "n" flag. See the gal_votefill_mapfile CVAR to determine the name of the file that will be created when using the "v" flag.


Say Commands

nominations

Lists all the nominations already made.

nominate <map>

Nominates the specified map.

cancel <map>

Cancels the player's previous nomination of the specified map.

<map>

Toggles between nominating and cancelling the specified map.

Rock the Vote

Allows players to rock the vote, thus registering their desire to force a vote for the next map.

CVARs

gal_rtv_commands <iFlags>

Specifies which say commands can be used to rock the vote. A value of 0 will disable this feature.

The flags are additive.
Flag Description
1 standard "rockthevote" command
2 shorthand "rtv" command
4 dynamic "rockthe<anything>vote" command

The default is 3.

The dynamic "rockthe<anything>vote" command allows a player to type any one word (i.e. no spaces) that starts with "rockthe" and ends with "vote". Some examples might be: "rockthedamnvote", "rockthesillylittlevote", or "rockthefreakingvote". The total length of the word can not be longer than 31 characters. That leaves 20 characters for creativeness once you factor in the lengths of "rockthe" and "vote".

gal_rtv_start <fMinutes>

Specifies the number of minutes after a map starts that players may begin to rock the vote.

The default is 10 minutes.

gal_rtv_ratio <fRatio>

Indicates the ratio of players that need to rock the vote before a vote will be forced to occur.

The default is 0.60 (60%).

Say Commands

rockthevote

Registers the player's desire for an early map vote.

rtv

Alias for "rockthevote". This is the shorthand command.

rockthe<anything>vote

Alias for "rockthevote". This is the dynamic command. See the gal_rtv_commands CVAR description for more detail.

Runoff Voting

Allows a secondary vote of the two highest vote getting maps if a single map doesn't win the first vote by more than 50% of the total votes.

The runoff vote will utilize the applicable gal_vote_* CVARs, with the exception of gal_vote_duration, which is overridden by gal_runoff_duration.

Runoff voting can only occur if there are more than two maps with votes in the first vote.

CVARs

gal_runoff_enabled <0|1>

Specifies whether to allow runoff voting or not.

Setting Description
0 disable
1 enable

The default is 0.

gal_runoff_duration <iSeconds>

Specifies the number of seconds the runoff vote should last.

The default is 10 seconds.

Ban Recent Maps

Allows you to disallow recent maps from being voted on.

CVARs

gal_banrecent <iMapCount>

Specifies how many of the most recent maps are disallowed from a map vote. A value of 0 will disable this feature.

The default is 3.

gal_banrecentstyle <iStyle>

Indicates the style in which the recent maps are displayed.

Setting Description
1 all maps on one line
2 each map on a separate line

The default is 1.

Weighted Admin Votes

Allows admins to have a weighted (counted as more than 1) vote.

CVARs

gal_vote_weight <iVoteWeight>

Specifies how many votes a single admin vote should count as. A value of 0 or 1 will disable this feature.

The default is 2.

gal_vote_weight_flags <cAdminFlags>

Specifies the standard access flags needed to have weighted votes. You can specify multiple flags.

The default is "y" (the ADMIN_ADMIN flag).

Disable "votemap" and "listmaps" Commands

Allows the standard HL1 votemap command, and it's associated listmaps command, to be completely disabled.

CVARs

gal_disable_votemap <0|1>

Indicates if players can use the standard HL1 votemap and listmaps commands.

Setting Description
0 enable (standard behavior)
1 disable both commands

The default is 0.

Change Map at End of Round

Allows map changes to happen either immediately or after the end of a round, when time runs out. Useful for round-based servers.

CVARS

gal_endonround <0|1>

Indicates when a map should end when time runs out.

Setting Description
0 change map immediately (standard behavior)
1 change map after a round ends

The default is 1.

Retrieved from "https://wiki.alliedmods.net/index.php?title=Galileo&oldid=9816"