Mission Voting – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{( *)Informative( *)\|" to "{{$1Feature$2|$2Informative$2|")
 
(7 intermediate revisions by the same user not shown)
Line 5: Line 5:


Global voting settings are used if no voting threshold defined in allowedVoteCmds or/and allowedVotedAdminCmds
Global voting settings are used if no voting threshold defined in allowedVoteCmds or/and allowedVotedAdminCmds
<syntaxhighlight lang="cpp>
<syntaxhighlight lang="cpp">
voteThreshold = <number>; // Percentage of votes needed to confirm a vote.  
voteThreshold = <number>; // Percentage of votes needed to confirm a vote.  
voteMissionPlayers = <number>; // Start mission-voting when ''X'' numberOfPlayers connect.
voteMissionPlayers = <number>; // Start mission-voting when ''X'' numberOfPlayers connect.
Line 16: Line 16:


: '''allowedVoteCmds[] = {{'''''<commandName>'', ''<preMissionStart>'', ''<postMissionStart>'', ''<votingThreshold>'''''}, ...};''', where:
: '''allowedVoteCmds[] = {{'''''<commandName>'', ''<preMissionStart>'', ''<postMissionStart>'', ''<votingThreshold>'''''}, ...};''', where:
:* ''<commandName>'': [[String]] - name of the command, for example <tt>"admin"</tt>
:* ''<commandName>'': [[String]] - name of the command, for example {{hl|"admin"}}
:* ''<preMissionStart>'' (Optional): [[Boolean]] - [[true]] to allow command before mission start. Default: [[true]]
:* ''<preMissionStart>'' (Optional): [[Boolean]] - [[true]] to allow command before mission start. Default: [[true]]
:* ''<postMissionStart>'' (Optional): [[Boolean]] - [[true]] to allow command after mission start. Default: [[true]]
:* ''<postMissionStart>'' (Optional): [[Boolean]] - [[true]] to allow command after mission start. Default: [[true]]
:* ''<votingThreshold>'' (Optional): [[Number]] - voting threshold 0...1. Default: value assigned to <tt>voteThreshold</tt> param. Otherwise 0.5
:* ''<votingThreshold>'' (Optional): [[Number]] - voting threshold 0...1. Default: value assigned to {{hl|voteThreshold}} param. Otherwise 0.5
:* ''<percentSideVotingThreshold>'' (Optional): [[Number]] - percent side threshold 0...1. Default: 0.5 (since Arma 3 1.90+ PerformaceBranch)
:* ''<percentSideVotingThreshold>'' (Optional): [[Number]] - percent side threshold 0...1. Default: 0.5 (since Arma 3 1.90+ PerformaceBranch)


{{Feature|Informative|Not using/specifying ''allowedVoteCmds[]'' param at all means every voting command is allowed!}}
{{Feature|informative|Not using/specifying ''allowedVoteCmds[]'' param at all means every voting command is allowed!}}


=== Examples ===
=== Examples ===
Line 36: Line 36:
{ "admin" }, // will default to {"admin", true, true, 0.5}
{ "admin" }, // will default to {"admin", true, true, 0.5}
{ "missions", true, false, 0.5 }, // not available after mission start
{ "missions", true, false, 0.5 }, // not available after mission start
{ "mission", true, true }, // will use global <tt>voteThreshold</tt>
{ "mission", true, true }, // will use global {{hl|voteThreshold}}
{ "kick", false, false, 0.75 }, // not available at all
{ "kick", false, false, 0.75 }, // not available at all
{ "restart", true, true, -1 }, // invalid threshold value. Will default to global <tt>voteThreshold</tt>
{ "restart", true, true, -1 }, // invalid threshold value. Will default to global {{hl|voteThreshold}}
{ "reassign", false, true, 0.5 }, // not available before mission start
{ "reassign", false, true, 0.5 }, // not available before mission start
{ "kick", true, true, 0.55, 0.30 } // means kicked in case either 55% of all players
{ "kick", true, true, 0.55, 0.30 } // means kicked in case either 55% of all players
Line 69: Line 69:
== See Also ==
== See Also ==


* [[server.cfg]]
* [[Arma 3: Server Config File|server config]]
* [[ArmA: Server configuration|Server Configuration]]  
* [[ArmA: Server configuration|Server Configuration]]  
* [[Armed Assault:Dedicated Server]]
* [[Armed Assault:Dedicated Server]]
* [[ArmA: Server Side Scripting]]
* [[ArmA: Server Side Scripting]]
* [[Operation Flashpoint:Dedicated Server]]
* [[Operation Flashpoint: Dedicated Server]]
* [[Arma 3 Headless Client]]
* [[Arma 3: Headless Client]]
* [[Arma 3: Server Security]]
* [[Arma 3: Server Security]]
* [[Arma: Mission rotation]]
* [[Arma: Mission rotation]]
Line 81: Line 81:




{{GameCategory|arma3| Multiplayer}}
{{GameCategory|arma3|Multiplayer}}

Latest revision as of 17:29, 26 July 2024

Documentation for server-side voting settings (since Arma 3 1.39 DEV)

Global voting settings

Global voting settings are used if no voting threshold defined in allowedVoteCmds or/and allowedVotedAdminCmds

voteThreshold = <number>;		// Percentage of votes needed to confirm a vote. 
voteMissionPlayers = <number>;	// Start mission-voting when ''X'' numberOfPlayers connect.


Advanced voting settings

Format

allowedVoteCmds[] = {{<commandName>, <preMissionStart>, <postMissionStart>, <votingThreshold>}, ...};, where:
  • <commandName>: String - name of the command, for example "admin"
  • <preMissionStart> (Optional): Boolean - true to allow command before mission start. Default: true
  • <postMissionStart> (Optional): Boolean - true to allow command after mission start. Default: true
  • <votingThreshold> (Optional): Number - voting threshold 0...1. Default: value assigned to voteThreshold param. Otherwise 0.5
  • <percentSideVotingThreshold> (Optional): Number - percent side threshold 0...1. Default: 0.5 (since Arma 3 1.90+ PerformaceBranch)
Not using/specifying allowedVoteCmds[] param at all means every voting command is allowed!

Examples

allowedVoteCmds[] = {}; // voting is disabled (not a single command is allowed)


allowedVoteCmds[] =
{
	{ "admin" },								// will default to {"admin", true, true, 0.5}
	{ "missions",	true,	false, 0.5 },		// not available after mission start
	{ "mission",	true,	true },				// will use global {{hl|voteThreshold}}
	{ "kick",		false,	false, 0.75 },		// not available at all
	{ "restart",	true,	true, -1 },			// invalid threshold value. Will default to global {{hl|voteThreshold}}
	{ "reassign",	false,	true, 0.5 },		// not available before mission start
	{ "kick",		true,	true, 0.55, 0.30 }	// means kicked in case either 55% of all players
												// or 30% of players from his side (west, east, resistance, civilian) voted to kick him
};

allowedVotedAdminCmds

Definition of available commands for voted-in admins (this doesn't affect abilities of normal server admins)
allowedVotedAdminCmds[] = { { "CMD1", pre-init, post-init },{ "CMD2", pre-init, post-init }, ... ,{ "CMDn", pre-init, post-init }};

Second and third parameter are optional. If not specified otherwise, they are true by default. (pre-init means prior to mission start, post-init means after a mission started)

Not listing any command ( allowedVotedAdminCmds[] = {}; ) means such commands are disabled for voted-in admin.
Not specifing allowedVotedAdminCmds at all means everything is allowed anytime for voted-in admin!

Commands available for voted admins:

allowedVotedAdminCmds[] =
{
	{ "mission",	true, true },
	{ "missions",	true, true },
	{ "restart",	true, true },
	{ "reassign",	true, true },
	{ "kick",		true, true }
};


See Also