NameLayer: Difference between revisions
Jump to navigation
Jump to search
rewrite namelayer page
(rewrite namelayer page) |
|||
Line 1:
'''NameLayer''' is a common plugin on civ servers which allows for the creation of shared '''groups'''. Any player can create a group, and any player can be a member of as many groups as they want. 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 [[Chat|only certain players can see]].
== Mechanics ==
=== Rank ===
Groups come with a set of ranks. A widely used set is ''primary owner > owner'' > ''admin'' > ''mod'' > ''member'', but this is not universal across civ servers. 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.
{| class="wikitable mw-collapsible mw-collapsed"
|+Base Namelayer Permissions
!Permission
!Description
|-
|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 civ server includes.
{| class="wikitable mw-collapsible mw-collapsed"
|+Additional Namelayer Permissions
!Provided By
!Permission
!Description
|-
| rowspan="5" |[[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
|
|-
| rowspan="8" |[[Citadel]]
|DOORS
|Can open and close reinforced doors
|-
|ACIDBLOCK
|Can place acidblocks reinforced to group (/ctacid)
|-
|CROPS
|Can place and destroy crops
|-
|INSECURE_REINFORCMENT
|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
|-
| rowspan="2" |[[Factory|FactoryMod]]
|UPGRADE_FACTORY
|Can upgrade factories
|-
|USE_FACTORY
|Can use factory reinforced to group
|-
| rowspan="8" |[[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
|-
|LOOKUP_SNITCH
|Can /jalookup a snitch giving coords
|-
|RENAME_SNITCH
|Can rename snitches
|-
| rowspan="2" |[[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
|}
== GUI ==
NameLayer can be used entirely via commands, but there is a GUI which may be easier to use. use the <code>/nl</code> command to bring up the GUI.
[[File:Namelayer Main GUI Example.png|thumb|250px|The GUI opened by typing '/nl'.]]
The first screen of the Namelayer GUI shows rows of chestplates. Each chestplate corresponds to a Namelayer group, and the type of chestplate shows your permission level. Leather is member, gold is mod, iron is admin, and diamond is owner or primary owner. The enchanted chestplate shows your [[default group]].
== Unique Usernames ==
Line 25 ⟶ 164:
If a player logs in with a username which is already in use in a namelayer group on the server, that player's displayed name will have a "1" appended to it.
==
{|class="wikitable"
Line 121 ⟶ 260:
| /nlsbl <group>
|Shows all blacklisted players for a group
|}
|