Mission Voting – Arma 3
Jump to navigation
Jump to search
(percentSideVotingThreshold) |
Lou Montana (talk | contribs) m (Text replacement - "Operation Flashpoint:Dedicated Server" to "Operation Flashpoint: Dedicated Server") |
||
(12 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{TOC|side}} | |||
Documentation for server-side voting settings (since 1.39 DEV) | Documentation for server-side voting settings (since {{arma3}} 1.39 DEV) | ||
== Global voting settings == | |||
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"> | |||
voteThreshold = <number>; // Percentage of votes needed to confirm a vote. | |||
voteMissionPlayers = <number>; // Start mission-voting when ''X'' numberOfPlayers connect. | |||
</syntaxhighlight> | |||
== Advanced voting settings == | |||
=== Format === | |||
:'''allowedVoteCmds[] = {{'''''<commandName>'', ''<preMissionStart>'', ''<postMissionStart>'', ''<votingThreshold>'''''}, ...};''', where: | : '''allowedVoteCmds[] = {{'''''<commandName>'', ''<preMissionStart>'', ''<postMissionStart>'', ''<votingThreshold>'''''}, ...};''', where: | ||
:* ''<commandName>'': [[String]] - name of the command, for example | :* ''<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 | :* ''<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!}} | |||
=== Examples === | |||
<syntaxhighlight lang=cpp> | |||
<syntaxhighlight lang="cpp"> | |||
allowedVoteCmds[] = {}; // voting is disabled (not a single command is allowed) | allowedVoteCmds[] = {}; // voting is disabled (not a single command is allowed) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang=cpp> | <syntaxhighlight lang="cpp"> | ||
allowedVoteCmds[] = | allowedVoteCmds[] = | ||
{ | { | ||
{"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 | { "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 | { "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 | |||
// or 30% of players from his side (west, east, resistance, civilian) voted to kick him | |||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===allowedVotedAdminCmds=== | === 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 }}; | ; 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) <br> | 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) <br> | ||
Line 48: | Line 55: | ||
Commands available for voted admins: | Commands available for voted admins: | ||
<syntaxhighlight lang=cpp> | <syntaxhighlight lang="cpp"> | ||
allowedVotedAdminCmds[] = | allowedVotedAdminCmds[] = | ||
{ | { | ||
{"mission", true, true}, | { "mission", true, true }, | ||
{"missions", true, true}, | { "missions", true, true }, | ||
{"restart", true, true}, | { "restart", true, true }, | ||
{"reassign", true, true}, | { "reassign", true, true }, | ||
{"kick", true, true} | { "kick", true, true } | ||
}; | }; | ||
</syntaxhighlight> | |||
== See Also == | |||
* [[Arma 3: Server Config File|server config]] | |||
* [[ArmA: Server configuration|Server Configuration]] | |||
* [[Armed Assault:Dedicated Server]] | |||
* [[ArmA: Server Side Scripting]] | |||
* [[Operation Flashpoint: Dedicated Server]] | |||
* [[Arma 3: Headless Client]] | |||
* [[Arma 3: Server Security]] | |||
* [[Arma: Mission rotation]] | |||
* [[Arma 2 Mission Rotation]] | |||
* [[Arma 2 OA: Multiple Mission Parameters Configuration]] | |||
{{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)
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 }
};