NameLayer: Difference between revisions
link civ
(moar code blocks) |
(link civ) |
||
| (25 intermediate revisions by 2 users not shown) | |||
Line 1:
[[File:Namelayer Main GUI Example.png|thumb|250px|The overview screen in the in-game NameLayer interface, as shown by <code>[[NameLayer#Interface|/nl]]</code>. Each chestplate is a group, and the material is the player's rank in that group.]]
{{Mechanics series}}
'''NameLayer''' is a common plugin on [[Civ]] servers which allows for the creation of shared '''groups'''. Any player can create a group, and there is no limit on the number of groups a player can be a member of. Each group has a tiered rank structure, with players having varying level of permissions inside a particular group.
Groups interact closely with [[Citadel]], which allows reinforcing a block to a specific group. The group a block is reinforced to informs several other plugins. For instance, Citadel protections can be bypassed by players on their group, [[Snitch|snitches]] and [[Bastion|bastions]] will not affect players on their group, and [[Item Exchange|item exchanges]] can be locked to a specific group. Groups can also be used to send chat messages visible [[Chat|only to players on that group]].
Line 14 ⟶ 16:
=== Permissions ===
Each rank comes with a default set of permissions. The permissions each rank grants can be modified for a particular group.
{| class="wikitable
|+Base Namelayer Permissions
!Permission
Line 61 ⟶ 63:
|(on servers that support it) Allows merging this group into another or merging another group into this one
|}
Other [[plugins]] can add permissions to groups, which are not a part of the base NameLayer plugin. These permissions act the same as the base permissions in that they can be modified on a per-group basis. The permissions provided by the most common plugins are listed below. Note that there may be permissions in this table which are not present on a civ server, and vice versa, depending on which plugins a
{| class="wikitable
|+Additional Namelayer Permissions
!Provided By
Line 68 ⟶ 70:
!Description
|-
|<code>BASTION_PEARL</code>
|Can pearl into bastion fields
Line 84 ⟶ 86:
|
|-
|<code>DOORS</code>
|Can open and close reinforced doors
Line 109 ⟶ 111:
|Can use chests
|-
|<code>UPGRADE_FACTORY</code>
|Can upgrade factories
Line 116 ⟶ 118:
|Can use factory reinforced to group
|-
|<code>CLEAR_SNITCHLOG</code>
|Can clear snitchlog with /jaclear
Line 141 ⟶ 143:
|Can rename snitches</code>
|-
|<code>READ_CHAT</code>
|Can read chat messages sent in group
Line 148 ⟶ 150:
|Can type messages in group
|-
|<code>KIRA_MANAGE_CHANNEL</code>
|Can setup Kira relays on discord to relay group messages and alerts
|}
==
=== Personal group ===
Each player is automatically given a ''personal group'' upon joining the server for the first time, whose name is the same as the player. A personal group is no different from a normal group, except that it is automatically created for players.
By default, a player's personal group is also their default group.
=== Default group ===
Each player has a ''default group'', which is the group used by commands when no group is specified. This is the player's personal group by default, but can be changed with the <code>/nlsdg</code> command, or from [[NameLayer#Interface|the interface]].
===
A ''global group'' is a group intended to provide a global chat, effectively bypassing the [[Chat|distance restriction of chat messages]]. This group is usually called <code>!</code> or <code>g</code>.
The concept of a global group was first introduced in [[Devoted]], where the global group was player-owned and managed, requiring players to join with a publicly shared password. On [[CivClassic]] and proceeding mainline server, global chat was cemented as a gameplay mechanic, with the group being owned by the server and players automatically added to it when they first join.
== Interface ==
[[File:Namelayer group management.png|thumb|The group screen in the <code>/nl</code> interface. Each chestplate is a member of the group, with rank shown by the chestplate's material. Various group management and display options are shown in the top and bottom rows respectively.]]
While groups can be managed entirely via commands, there is also an in-game interface which can be brought up with the <code>/nl</code> command.
In this interface, the material of a chestplate correspond to a player's rank in a group. Leather is member, gold is mod, iron is admin, and diamond is owner or primary owner. An enchanted chestplate denotes the player's [[NameLayer#Default group|default group]].
The first <code>/nl</code> screen is the overview screen, which shows all groups the player is a member of. Chestplate material denotes the player's rank in that group. Clicking on a chestplate will bring up the group screen.
The group screen shows all members of that group and their respective ranks.
== Command Reference ==
Line 171 ⟶ 184:
{|class="wikitable"
|+ class="nowrap" |
!Category
! width="30%" | Command
!width="70%"| Description
!Alias
|-
! rowspan="2" |Info
|<code>/help namelayer [page]</code>
|Lists all NameLayer commands.
|{{n/a}}
|-
|
|Brings up the in-game NameLayer interface.
|{{n/a}}
|-
! rowspan="9" |Personal
| <code>/nllg</code>
|Lists all groups the player is in.
|<code>/listgroups</code><br><code>/groups</code>
|-
|
|Joins a group. Only groups with a password can be joined with this command.
|<code>/joingroup</code>
|-
|
|
|<code>/leave</code><br><code>/leavegroup</code>
|-
|
|Gets the player's [[#Default group|default group]].
|{{n/a}}
|-
|
|Sets
|{{n/a}}
|-
|
|Lists the player's pending invititations.
|<code>/invites</code><br><code>/listinvites</code>
|-
|
|Accepts a pending invitation to a group.
|<code>/join</code><br><code>/accept</code><br><code>/acceptgroup</code><br><code>/acceptinvite</code>
|-
|
|Rejects a pending invitation to a group.
|<code>/reject</code><br><code>/rejectinvite</code>
|-
|
|
|<code>/autoaccept</code>
|-
! rowspan="14" |Management
| <code>/nlcg <group> [password]</code>
| Creates a group. If <code>[password]</code> is not supplied, only players with an invitiation can join.
|<code>/create</code><br><code>/creategroup</code>
|-
|
|Invites a player to a group. <code>[rank]</code> defaults to member.
|<code>/invite</code><br><code>/inviteplayer</code>
|-
|
|Revokes
|<code>/revoke</code><br><code>/revokeinvite</code>
|-
| <code>/nlrm <group> <member></code>
| Removes a member from a group.
|<code>/remove</code><br><code>/removeplayer</code>
|-
| <code>
| Adds a player to the blacklist for a group.
|<code>/blacklist</code>
|-
| <code>
|
|<code>/unblacklist</code>
|-
| <code>
|
|<code>/showblacklist</code>
|-
| <code><nowiki>/nlmp <group> <add|remove> <rank> <permission></nowiki></code>
| Adds or removes a permission from a rank in a group.
|<code>/modifyperms</code>
|-
|
|Lists permissions of a rank in a group.
|<code>/permissions</code>
|-
| <code>
|
|<code>/promote</code><br><code>/promoteplayer</code>
|-
| <code>
| Lists all members of a group. If <code>[rank]</code> is supplied, lists only members with that rank.
|<code>/members</code><br><code>/listmembers</code>
|-
| <code>
|
|<code>/setpassword</code>
|-
| <code>
| Transfers primary ownership of a group to another player.
|<code>/transfer</code><br><code>/transfergroup</code>
|-
| <code>
|
|<code>/delete</code><br><code>/deletegroup</code>
|}
| |||