Mechanics and Plugins (CivMC)

TODO: like almost everything

Namelayer

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.

Part of a series on
Mechanics and Plugins
Core Mechanics
Citadel NameLayer Bastion Snitch Exile Pearl
Common Mechanics
Orebfuscation HiddenOre Chat Factory Enchanting Realistic Biomes Item Exchange Brewery Essence Kira
Minor Mechanics
Spawning Chunk Limits RailSwitch Arthropod Egg Combat Tag Elevator CastleGate One Time Teleport Commands

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, 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

Citadel

Main article: Citadel

JukeAlert

Main article: JukeAlert

FactoryMod

Main article: FactoryMod

ItemExchange

Main article: ItemExchange

Brewery

Main article: Brewery

Bastion

Main article: Bastion

Exile Pearl

Main article: Exile Pearl

Combat

Civ servers often change combat to pre-1.8 mechanics, make players tankier, and generally rebalance all combat-affecting items. The plugin that handles this is often Finale.

Changes

Specific changes will vary heavily from server to server. On CivClassic, the following changes to combat were implemented:

• Revert combat to pre-1.8 mechanics
• Dual wielding is enabled.
• Clicking at rate higher than 8.5 (?) CPS will decrease the overall damages dealt.
• Ender Pearls have a cooldown of 15 seconds (vs. 1s in vanilla).
• Ender Crystals do not inflict damage on the player but will still destroy surrounding blocks.
• Snowballs and eggs do no inflict damage nor knock players back but will slightly damage armor.
• Buff bows by 20%
• Enchanted golden apples turn to normal golden apples when eat attempted.
• Increases damage reduction granted by the Protection enchantment
• Nerfs the strength potion back to pre-1.5 mechanics
• tripled added damage from strength potion levels
• 30% chance projectile causes slow debuff for 100 ticks.

In CivMC the following changes are applied:

• Sweeping attacks are disabled
• Attack cooldown is removed
• The cooldown of ender pearls and golden apples is set to 16 seconds
• Clicks per second are limited to 9
• Custom food health regeneration and knockback values are set
• All non-sword damage is reduced by 20%
• Instant health regenerates 12 points of hp (6 x ♥)

Logging out and Combat tag

When disconnecting from the server you leave behind a CombatLogger for at least 60 seconds, commonly referred to as logger, a CombatLogger is a player entity that can not move (or be moved) but can be killed, and it's death is treated as you dying meaning you can be pearled or lose your inventory. To avoid leaving this entity behind you can issue the /logout command, starting a 10 second process that, if not interrupted by PvP or movement, will disconnect you at the end without leaving a logger, this however is disabled while you're combat tagged

Besides entering PvP throwing an ender pearl also combat tags you

Misc

Main article: SimpleAdminHacks

Fixes, exploit prevention, disabled features, etc

• AntiStasisChamber - disables ender pearl stasis chamber by limiting ender pearl duration
• AttrHider - hides item attributes from other players so CIT texture packs only work on your own
• AutoRespawn - respawns the player after a set period of not pressing the respawn button so they can't continue to observe after dying
• BeeKeeping - replaces some mob spawns with bees
• BuffSpanker - disables certain buffs and debuffs
• disableIronFarms - disables iron golem farms
• disableEnderCrystalDamage - makes end crystals do no damage
• canEquipBanners - allow players to equip a banners on their heads by punching the ground with a banner
• preventPearlGlitching - prevent going through blocks with ender pearls, also prevents ender pearls from landing at times

disableGapples

what does this hack even do

= PortalSpawnModifier

- noooot sure if false here means it disable spawns or is vanilla

• ShipOutOfLuck - no ice boat
• enderChestUse - disables accessing enderchests
• grindstoneUse - disables accessing grindstones
• chorusFruitTeleportation - disables teleporting with chorus fruits
• stopBedBombingInHellBiomes - stops exploding beds in the nether
• stopAnchorBombing - disables exploding respawn anchors in the overworld

• chunkLimits - limits these blocks to certain numbers per chunk (should probably be a table but idk how to make one yet)

       HOPPER: 16
       DISPENSER: 16
       DROPPER: 16
       COMPARATOR: 12
       FURNACE: 40
       BLAST_FURNACE: 40
       BREWING_STAND: 40
       SMOKER: 40
       CAMPFIRE: 40
       SOUL_CAMPFIRE: 40

• daytimeBed - allows setting spawn in daytime (although it's now a vanilla feature)
• oneToOneNether: true

   stopTrapHorses: true
   killTrapHorses: true
   allowVillagerTrading: false

   allowEnchantedApples: false

 HorseStats:
   enabled: true
   wand: COMPASS

SaplingHack:
   enabled: true
   #Should we still roll the dice for people when using a fortune enchanted tool?
   allow_fortune: true
   blocks:
     JUNGLE_LEAVES: 0.025
     DARK_OAK_LEAVES: 0.05

todo format all this stuff under fixes and exploit prevention currently only copy pasting the info from github