Difference between revisions of "Commshare"
(Create commshare page) |
m |
||
(8 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | [[ | + | == Overview == |
+ | Commshare (or Command Share) allows players to share control of units. Players who engage in Commsharing are assigned to a squad, which functions as if all the members of the squad were one player. Each squad member contributes all income and [[units]] to the squad. | ||
− | + | Enable Commshare by holding {{key press|Tab}} to open the player list, then pressing the <samp>[[File:Commshare.png|x16px|Commshare|link=]] Commshare</samp> icon to invite a player into your squad or to accept a player's invitation to a squad. | |
− | Commshare | ||
− | = | + | == Modes == |
Commshare has three modes of operation: | Commshare has three modes of operation: | ||
+ | ;All mode | ||
+ | :All players are merged at game start (specifically, ≈166ms into the game). Nobody may unmerge or kick anyone at any time. | ||
+ | ;Invite mode (Default) | ||
+ | :To merge with another player, you must first both agree to it. The player who invites the other first becomes the "squad leader," who acts as the representative of the squad. Squad leaders can kick anyone for any reason at any time. The players will receive their units back upon getting kicked. You may also leave a squad at any time as well. Issuing an invite is simple: Press {{key press|Tab}}, then click on the half teal/half green Commander. | ||
+ | ;None | ||
+ | :No commsharing is allowed. No commshare commands will be responded to. | ||
+ | |||
+ | == Privileges == | ||
+ | |||
+ | All members may accept, decline, or issue invites. Only the squad leader may kick anyone. | ||
− | + | == Developing == | |
− | |||
− | + | Commands to commshare should be issued using <syntaxhighlight lang="lua" inline>SendLuaRulesMsg</syntaxhighlight> with the following string: | |
− | + | <syntaxhighlight lang="lua">sharemode <command> <param></syntaxhighlight> | |
+ | This is not case sensitive. The following are valid commands: | ||
+ | {|class="wikitable sortable" | ||
+ | !Command!!Param!!class="unsortable"|Purpose | ||
+ | |- | ||
+ | |Accept || <var>playerID</var> || Accepts an invite from <var>playerID</var>. | ||
+ | |- | ||
+ | |Decline || <var>playerID</var> || Declines an invite from <var>playerID</var>. | ||
+ | |- | ||
+ | |Invite || <var>playerID</var> || Issues an invite to <var>playerID</var>. | ||
+ | |- | ||
+ | |Kick || <var>playerID</var> || Forces <var>playerID</var> to unmerge, requires teamleader. | ||
+ | |- | ||
+ | |Remerge || None || Causes you to remerge if you were disconnected or kicked from game. | ||
+ | |- | ||
+ | |Unmerge || None || Causes you to unmerge. | ||
+ | |} | ||
− | + | === Getting invites === | |
− | + | Invites are stored in <syntaxhighlight lang="lua" inline>TeamRulesParam</syntaxhighlight> as private data. It is stored as if it were an ordered table. | |
+ | {|class="wikitable sortable" | ||
+ | !Param!!class="unsortable"|Info!!class="unsortable"|Notes | ||
+ | |- | ||
+ | |<syntaxhighlight lang="lua" inline>commshare_invitecount</syntaxhighlight> || # of invites || Get this first, then do a <syntaxhighlight lang="lua" inline>for i = 1, commshare_invitecount</syntaxhighlight> loop. | ||
+ | |- | ||
+ | |<syntaxhighlight lang="lua" inline>"commshare_invite_" .. i .."_id"</syntaxhighlight> || ID of the player who sent the invite || | ||
+ | |- | ||
+ | |<syntaxhighlight lang="lua" inline>"commshare_invite_" .. i .."_timeleft"</syntaxhighlight> || Time remaining on this invite || You must check if this is different than last second's count to see if it's dead. | ||
+ | |} | ||
− | |||
− | + | {{Navbox manual}} |
Latest revision as of 22:33, 31 October 2022
Overview
Commshare (or Command Share) allows players to share control of units. Players who engage in Commsharing are assigned to a squad, which functions as if all the members of the squad were one player. Each squad member contributes all income and units to the squad.
Enable Commshare by holding Tab to open the player list, then pressing the
icon to invite a player into your squad or to accept a player's invitation to a squad.
Modes
Commshare has three modes of operation:
- All mode
- All players are merged at game start (specifically, ≈166ms into the game). Nobody may unmerge or kick anyone at any time.
- Invite mode (Default)
- To merge with another player, you must first both agree to it. The player who invites the other first becomes the "squad leader," who acts as the representative of the squad. Squad leaders can kick anyone for any reason at any time. The players will receive their units back upon getting kicked. You may also leave a squad at any time as well. Issuing an invite is simple: Press Tab, then click on the half teal/half green Commander.
- None
- No commsharing is allowed. No commshare commands will be responded to.
Privileges
All members may accept, decline, or issue invites. Only the squad leader may kick anyone.
Developing
Commands to commshare should be issued using SendLuaRulesMsg
with the following string:
sharemode <command> <param>
This is not case sensitive. The following are valid commands:
Command | Param | Purpose |
---|---|---|
Accept | playerID | Accepts an invite from playerID. |
Decline | playerID | Declines an invite from playerID. |
Invite | playerID | Issues an invite to playerID. |
Kick | playerID | Forces playerID to unmerge, requires teamleader. |
Remerge | None | Causes you to remerge if you were disconnected or kicked from game. |
Unmerge | None | Causes you to unmerge. |
Getting invites
Invites are stored in TeamRulesParam
as private data. It is stored as if it were an ordered table.
Param | Info | Notes |
---|---|---|
commshare_invitecount |
# of invites | Get this first, then do a for i = 1, commshare_invitecount loop.
|
"commshare_invite_" .. i .."_id" |
ID of the player who sent the invite | |
"commshare_invite_" .. i .."_timeleft" |
Time remaining on this invite | You must check if this is different than last second's count to see if it's dead. |
The images and links on this page may be broken at the moment. The cache on this page points to the test wiki.
Please purge the cache to try to restore images and fix those links. This will work only if the page is not on the test server (where this box should appear for now even when cache purging is not needed), which may lack the actual images. This page thinks that it resides on test.zero-k.info right now. |