NameLayer: Difference between revisions
link civ
(link interface) |
(link civ) |
||
| (19 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.]]
'''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.▼
{{Mechanics series}}
▲'''NameLayer''' is a common plugin on
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 153 ⟶ 155:
|}
==
=== Personal group ===
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.▼
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 ===
The first screen of the interface shows rows of chestplates. Each chestplate corresponds to a group, and the type of chestplate shows your permission level in that group. Leather is member, gold is mod, iron is admin, and diamond is owner or primary owner. The enchanted chestplate shows your [[default group]]. Clicking on a chestplate will show more options for that 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]].
=== Global group ===
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.
▲
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 174 ⟶ 187:
! width="30%" | Command
!width="70%"| Description
!Alias
|-
! rowspan="2" |Info
|<code>/help namelayer [page]</code>
|Lists all NameLayer commands.
|{{n/a}}
|-
|<code>[[NameLayer#Interface|/nl]]</code>
|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>
|-
|<code>/nljg <group> <password></code>
|Joins a group. Only groups with a password can be joined with this command.
|<code>/joingroup</code>
|-
|<code>/nlleg <group></code>
|Leaves a group.
|<code>/leave</code><br><code>/leavegroup</code>
|-
|<code>/nlgdg</code>
|Gets the player's [[#Default group|default group]].
|{{n/a}}
|-
|<code>/nlsdg <group></code>
|Sets the player's [[#Default group|default group]].
|{{n/a}}
|-
|<code>/nllci
|Lists the player's pending invititations.
|<code>/invites</code><br><code>/listinvites</code>
|-
|<code>/nlag <group></code>
|Accepts a pending invitation to a group.
|<code>/join</code><br><code>/accept</code><br><code>/acceptgroup</code><br><code>/acceptinvite</code>
|-
|<code>/nlrg <group></code>
|Rejects a pending invitation to a group.
|<code>/reject</code><br><code>/rejectinvite</code>
|-
|<code>/nltaai</code>
|Toggles the auto-acceptance of group invitations.
|<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>
|-
|<code>/nlip <group> <player> [rank]</code>
|Invites a player to a group. <code>[rank]</code> defaults to member.
|<code>/invite</code><br><code>/inviteplayer</code>
|-
|<code>/nlri <group> <player></code>
|Revokes an invitation of a player to a group.
|<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>/nlbl <group> <player></code>
| Adds a player to the blacklist for a group.
|<code>/blacklist</code>
|-
| <code>/nlubl <group> <player></code>
| Removes a player from the blacklist for a group.
|<code>/unblacklist</code>
|-
| <code>/nlsbl <group></code>
| Lists blacklisted players for a group.
|<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>
|-
|<code>/nllp <group> <rank>
|Lists permissions of a rank in a group.
|<code>/permissions</code>
|-
| <code>/nlpp <group> <player> <rank></code>
| Sets the rank of a player in a group.
|<code>/promote</code><br><code>/promoteplayer</code>
|-
| <code>/nllm <group> [rank]</code><br>
| 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>/nlsp <group> <password></code>
| Adds a password to an existing group.
|<code>/setpassword</code>
|-
| <code>/nltg <group> <player></code>
| Transfers primary ownership of a group to another player.
|<code>/transfer</code><br><code>/transfergroup</code>
|-
| <code>/nldg <group></code>
| Deletes a group.
|<code>/delete</code><br><code>/deletegroup</code>
|}
| |||