CivWiki

NameLayer: Difference between revisions

VisualWikitext
m (typo)
 
(2 intermediate revisions by one other user not shown)
Line 18: Line 18:
{| class="wikitable"
{| class="wikitable"
|+Base Namelayer Permissions
|+Base Namelayer Permissions
!Permission
! rowspan="2" |Permission
!Description
! rowspan="2" |Description
! colspan="4" |Default permission
|-
!Member
!Mod
!Admin
!Owner
|-
|-
|<code>LIST_PERMS</code>
|<code>LIST_PERMS</code>
|Allows seeing how the permissions are set up for the group
|Allows seeing how the permissions are set up for the group
|{{na}}
|{{na}}
|{{ya}}
|{{ya}}
|-
|-
|<code>GROUPSTATS</code>
|<code>GROUPSTATS</code>
|Gives access to various group statistics such as member counts by permission type, who owns the group etc
|Gives access to various group statistics such as member counts by permission type, who owns the group etc
|{{na}}
|{{na}}
|{{ya}}
|{{ya}}
|-
|-
|<code>OPEN_GUI</code>
|<code>OPEN_GUI</code>
|Allows opening the GUI for this group
|Allows opening the GUI for this group
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>JOIN_PASSWORD</code>
|<code>JOIN_PASSWORD</code>
|perm level given to members when they join with a password
|perm level given to members when they join with a password
|{{ya}}
|{{na}}
|{{na}}
|{{na}}
|-
|-
|<code>MEMBERS</code>
|<code>MEMBERS</code>
|Allows inviting new members and removing existing members
|Allows inviting new members and removing existing members
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>MODS</code>
|<code>MODS</code>
|Allows inviting/promoting new members and removing existing mods
|Allows inviting/promoting new members and removing existing mods
|{{na}}
|{{na}}
|{{ya}}
|{{ya}}
|-
|-
|<code>ADMINS</code>
|<code>ADMINS</code>
|Allows inviting/promoting new members and removing existing admins
|Allows inviting/promoting new members and removing existing admins
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|-
|-
|<code>OWNER</code>
|<code>OWNER</code>
|Allows inviting/promoting new members and removing existing owners
|Allows inviting/promoting new members and removing existing owners
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|-
|-
|<code>BLACKLIST</code>
|<code>BLACKLIST</code>
|Allows viewing this groups blacklist, adding players to the blacklist and removing players from the blacklist
|Allows viewing this groups blacklist, adding players to the blacklist and removing players from the blacklist
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>PASSWORD</code>
|<code>PASSWORD</code>
|Allows viewing this groups password and changing or removing it");
|Allows viewing this groups password and changing or removing it");
|{{na}}
|{{na}}
|{{ya}}
|{{ya}}
|-
|-
|<code>PERMS</code>
|<code>PERMS</code>
|Allows modifying permissions for this group
|Allows modifying permissions for this group
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|-
|-
|<code>DELETE</code>
|<code>DELETE</code>
|Allows deleting this group
|Allows deleting this group
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|-
|-
|<code>LINKING</code>
|<code>LINKING</code>
|(on servers that support it) Allows linking this group to another group as a supergroup or a subgroup
|(on servers that support it) Allows linking this group to another group as a supergroup or a subgroup
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|-
|-
|<code>MERGE</code>
|<code>MERGE</code>
|(on servers that support it) Allows merging this group into another or merging another group into this one
|(on servers that support it) Allows merging this group into another or merging another group into this one
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|}
|}
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 particular server includes.
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 particular server includes.
{| class="wikitable"
{| class="wikitable"
|+Additional Namelayer Permissions
|+Additional Namelayer Permissions
!Provided By
! rowspan="2" |Provided By
!Permission
! rowspan="2" |Permission
!Description
! rowspan="2" |Description
! colspan="4" |Default permission
|-
|-
!Member
! rowspan="5" |[[Bastion]]
!Mod
!Admin
!Owner
|-
! rowspan="7" |[[Bastion]]
|<code>BASTION_PEARL</code>
|<code>BASTION_PEARL</code>
|Can pearl into bastion fields
|Can pearl into bastion fields
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BASTION_ALLOW_EXILED</code>
|<code>BASTION_ALLOW_EXILED</code>
|Allows exiles inside bastion range
|Allows exiles inside bastion range
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BASTION_PLACE</code>
|<code>BASTION_PLACE</code>
|Can place in bastion ranges reinforced to group
|Can place in bastion ranges reinforced to group
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BASTION_LIST</code>
|<code>BASTION_LIST</code>
|Can list bastions on group (/bsl)
|Can list bastions on group (/bsl)
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BASTION_MANAGE_GROUPS</code>
|<code>BASTION_MANAGE_GROUPS</code>
|
|
|{{na}}
|{{na}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BASTION_BRIDGE_UNDRAW</code>
! rowspan="8" |[[Citadel]]
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>BASTION_ELYTRA</code>
|
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
! rowspan="14" |[[Citadel]]
|<code>DOORS</code>
|<code>DOORS</code>
|Can open and close reinforced doors
|Can open and close reinforced doors
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>ACIDBLOCK</code>
|<code>ACIDBLOCK</code>
|Can place acidblocks reinforced to group (/ctacid)
|Can place acidblocks reinforced to group (/ctacid)
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}

|-
|-
|<code>CROPS</code>
|<code>CROPS</code>
|Can place and destroy crops
|Can place and destroy crops
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>INSECURE_REINFORCEMENT</code>
|<code>INSECURE_REINFORCEMENT</code>
|Can use hoppers to take items out of reinforced containers /ctinsecure
|Can use hoppers to take items out of reinforced containers /ctinsecure
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>REINFORCEMENT_INFO</code>
|<code>REINFORCEMENT_INFO</code>
|Can use /cti and see group block reinforced to
|Can use /cti and see group block reinforced to
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>BYPASS_REINFORCEMENT</code>
|<code>BYPASS_REINFORCEMENT</code>
|Can use /ctb and break reinforcement, returning reinforcement item
|Can use /ctb and break reinforcement, returning reinforcement item
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>REINFORCE</code>
|<code>REINFORCE</code>
|Can /ctf, /ctb blocks
|Can /ctf, /ctb blocks
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>CHESTS</code>
|<code>CHESTS</code>
|Can use chests
|Can use chests
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>BEACONS</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>HANGING_PLACE_BREAK</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>ITEM_FRAME_PUT_TAKE</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>ITEM_FRAME_ROTATE</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>MODIFY_BLOCK</code>
|
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>REPAIR_REINFORCEMENT</code>
|
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
![[Exile Pearl]]
|<code>ALLOW_EXILE_BROADCAST</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
![[Item Exchange]]
|<code>PURCHASE_PERMISSION</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
! rowspan="2" |[[Factory|FactoryMod]]
! rowspan="2" |[[Factory|FactoryMod]]
|<code>UPGRADE_FACTORY</code>
|<code>UPGRADE_FACTORY</code>
|Can upgrade factories
|Can upgrade factories
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>USE_FACTORY</code>
|<code>USE_FACTORY</code>
|Can use factory reinforced to group
|Can use factory reinforced to group
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
! rowspan="8" |[[Snitch]]
! rowspan="8" |[[Snitch]]
|<code>CLEAR_SNITCHLOG</code>
|<code>CLEAR_SNITCHLOG</code>
|Can clear snitchlog with /jaclear
|Can clear snitchlog with /jaclear
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>SNITCH_NOTIFICATIONS</code>
|<code>SNITCH_NOTIFICATIONS</code>
|Can see chat messageswhen players trigger snitches
|Can see chat messageswhen players trigger snitches
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>SNITCH_IMMUNE</code>
|<code>SNITCH_IMMUNE</code>
|Will no longer cause snitch alerts when in range of snitches on group.
|Will no longer cause snitch alerts when in range of snitches on group.
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>READ_SNITCHLOG</code>
|<code>READ_SNITCHLOG</code>
|Can check snitchlogs with /ja
|Can check snitchlogs with /ja
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>SNITCH_TOGGLE_LEVER</code>
|<code>SNITCH_TOGGLE_LEVER</code>
|Can do /jaToggleLevers 1 to allow snitchs triggering redstone
|Can do /jaToggleLevers 1 to allow snitchs triggering redstone
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>LIST_SNITCHES</code>
|<code>LIST_SNITCHES</code>
|can /jalist to see all snitches on group
|can /jalist to see all snitches on group
|{{na}}
|-
|{{ya}}
|<code>LOOKUP_SNITCH</code>
|{{ya}}
|Can /jalookup a snitch giving coords
|{{ya}}
|-
|-
|<code>RENAME_SNITCH
|<code>RENAME_SNITCH
|Can rename snitches</code>
|Can rename snitches
|{{na}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|<code>DETECT_SNITCH</code>
|
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
! rowspan="2" |[[Chat]]
! rowspan="2" |[[Chat]]
|<code>READ_CHAT</code>
|<code>READ_CHAT</code>
|Can read chat messages sent in group
|Can read chat messages sent in group
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
|<code>WRITE_CHAT</code>
|<code>WRITE_CHAT</code>
|Can type messages in group
|Can type messages in group
|{{ya}}
|{{ya}}
|{{ya}}
|{{ya}}
|-
|-
![[Kira]]
![[Kira]]
|<code>KIRA_MANAGE_CHANNEL</code>
|<code>KIRA_MANAGE_CHANNEL</code>
|Can setup Kira relays on discord to relay group messages and alerts
|Can setup Kira relays on discord to relay group messages and alerts
|{{na}}
|{{na}}
|{{na}}
|{{ya}}
|}
|}


Latest revision as of 03:23, 23 June 2024

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.

The overview screen in the in-game NameLayer interface, as shown by /nl. Each chestplate is a group, and the material is the player's rank in that 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, snitches and bastions will not affect players on their group, and item exchanges can be locked to a specific group. Groups can also be used to send chat messages visible only to players on that group.

First introduced in Civcraft, NameLayer has been included in every mainline civ server since.

Mechanics

Rank

Groups come with a set of ranks, often primary owner > owner > admin > mod > member. Players cannot create, rename, or move the ranks themselves, but they can assign players to different ranks.

Each group can have only one primary owner, though primary ownership can be transferred by the current primary owner. Other ranks have no limit on the number of players in them.

Permissions

Each rank comes with a default set of permissions. The permissions each rank grants can be modified for a particular group.

Base Namelayer Permissions
Permission Description Default permission
Member Mod Admin Owner
LIST_PERMS Allows seeing how the permissions are set up for the group        
GROUPSTATS Gives access to various group statistics such as member counts by permission type, who owns the group etc        
OPEN_GUI Allows opening the GUI for this group        
JOIN_PASSWORD perm level given to members when they join with a password        
MEMBERS Allows inviting new members and removing existing members        
MODS Allows inviting/promoting new members and removing existing mods        
ADMINS Allows inviting/promoting new members and removing existing admins        
OWNER Allows inviting/promoting new members and removing existing owners        
BLACKLIST Allows viewing this groups blacklist, adding players to the blacklist and removing players from the blacklist        
PASSWORD Allows viewing this groups password and changing or removing it");        
PERMS Allows modifying permissions for this group        
DELETE Allows deleting this group        
LINKING (on servers that support it) Allows linking this group to another group as a supergroup or a subgroup        
MERGE (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 particular server includes.

Additional Namelayer Permissions
Provided By Permission Description Default permission
Member Mod Admin Owner
Bastion BASTION_PEARL Can pearl into bastion fields        
BASTION_ALLOW_EXILED Allows exiles inside bastion range        
BASTION_PLACE Can place in bastion ranges reinforced to group        
BASTION_LIST Can list bastions on group (/bsl)        
BASTION_MANAGE_GROUPS        
BASTION_BRIDGE_UNDRAW        
BASTION_ELYTRA        
Citadel DOORS Can open and close reinforced doors        
ACIDBLOCK Can place acidblocks reinforced to group (/ctacid)        
CROPS Can place and destroy crops        
INSECURE_REINFORCEMENT Can use hoppers to take items out of reinforced containers /ctinsecure        
REINFORCEMENT_INFO Can use /cti and see group block reinforced to        
BYPASS_REINFORCEMENT Can use /ctb and break reinforcement, returning reinforcement item        
REINFORCE Can /ctf, /ctb blocks        
CHESTS Can use chests        
BEACONS        
HANGING_PLACE_BREAK        
ITEM_FRAME_PUT_TAKE        
ITEM_FRAME_ROTATE        
MODIFY_BLOCK        
REPAIR_REINFORCEMENT        
Exile Pearl ALLOW_EXILE_BROADCAST        
Item Exchange PURCHASE_PERMISSION        
FactoryMod UPGRADE_FACTORY Can upgrade factories        
USE_FACTORY Can use factory reinforced to group        
Snitch CLEAR_SNITCHLOG Can clear snitchlog with /jaclear        
SNITCH_NOTIFICATIONS Can see chat messageswhen players trigger snitches        
SNITCH_IMMUNE Will no longer cause snitch alerts when in range of snitches on group.        
READ_SNITCHLOG Can check snitchlogs with /ja        
SNITCH_TOGGLE_LEVER Can do /jaToggleLevers 1 to allow snitchs triggering redstone        
LIST_SNITCHES can /jalist to see all snitches on group        
RENAME_SNITCH Can rename snitches        
DETECT_SNITCH        
Chat READ_CHAT Can read chat messages sent in group        
WRITE_CHAT Can type messages in group        
Kira KIRA_MANAGE_CHANNEL Can setup Kira relays on discord to relay group messages and alerts        

Special groups

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 /nlsdg command, or from the interface.

Global group

A global group is a group intended to provide a global chat, effectively bypassing the distance restriction of chat messages. This group is usually called ! or g.

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

 
The group screen in the /nl 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 /nl 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 default group.

The first /nl 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

Category Command Description Alias
Info /help namelayer [page] Lists all NameLayer commands. —
/nl Brings up the in-game NameLayer interface. —
Personal /nllg Lists all groups the player is in. /listgroups
/groups
/nljg <group> <password> Joins a group. Only groups with a password can be joined with this command. /joingroup
/nlleg <group> Leaves a group. /leave
/leavegroup
/nlgdg Gets the player's default group. —
/nlsdg <group> Sets the player's default group. —
/nllci Lists the player's pending invititations. /invites
/listinvites
/nlag <group> Accepts a pending invitation to a group. /join
/accept
/acceptgroup
/acceptinvite
/nlrg <group> Rejects a pending invitation to a group. /reject
/rejectinvite
/nltaai Toggles the auto-acceptance of group invitations. /autoaccept
Management /nlcg <group> [password] Creates a group. If [password] is not supplied, only players with an invitiation can join. /create
/creategroup
/nlip <group> <player> [rank] Invites a player to a group. [rank] defaults to member. /invite
/inviteplayer
/nlri <group> <player> Revokes an invitation of a player to a group. /revoke
/revokeinvite
/nlrm <group> <member> Removes a member from a group. /remove
/removeplayer
/nlbl <group> <player> Adds a player to the blacklist for a group. /blacklist
/nlubl <group> <player> Removes a player from the blacklist for a group. /unblacklist
/nlsbl <group> Lists blacklisted players for a group. /showblacklist
/nlmp <group> <add|remove> <rank> <permission> Adds or removes a permission from a rank in a group. /modifyperms
/nllp <group> <rank> Lists permissions of a rank in a group. /permissions
/nlpp <group> <player> <rank> Sets the rank of a player in a group. /promote
/promoteplayer
/nllm <group> [rank]
 Lists all members of a group. If [rank] is supplied, lists only members with that rank. /members
/listmembers
/nlsp <group> <password> Adds a password to an existing group. /setpassword
/nltg <group> <player> Transfers primary ownership of a group to another player. /transfer
/transfergroup
/nldg <group> Deletes a group. /delete
/deletegroup
Retrieved from "https://civwiki.org/wiki/NameLayer?oldid=73956"