Citadel: Difference between revisions

From CivWiki
Jump to navigation Jump to search
Content added Content deleted
VisualWikitext
m (1 revision imported: old Devoted Wiki pages)
 
(98 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[File:Citadel ctinfo example.png|thumb|An obsidian block reinforced with stone. From top to bottom, as shown by <code>[[Citadel#Info Mode|/cti]]</code>: durability, [[NameLayer]] group, reinforcement material. ]]
Citadel is an anti-grief plugin, built for multiplayer Minecraft servers. To use Citadel, simply hit a block with a reinforcing material (like a stone block, or a diamond). This will lock the chest or block and make it so others cannot easily break it, or use it until it is broken. People can still get into your chests if they are locked, but it requires raiders to break the same block until the reinforcement runs out. Citadel also has a numerous array of reinforcement types, each offering different functionality, maturation time, and durability.
{{Featured article}}
{{Mechanics series}}
'''Citadel''' is a common plugin on [[Civ]] servers which allows blocks to be reinforced at the cost of resources. Reinforced blocks must be broken many times before they are destroyed. The durability of a reinforced block can be increased by reinforcing it with a more expensive material. Reinforced blocks also prevent certain player interactions, such as a reinforced door from being opened.


Citadel interacts closely with the [[NameLayer]] plugin. Blocks are reinforced to a particular NameLayer group, and users on that group can bypass the protections of Citadel for that block.
== Basic Commands ==

{|
Citadel is primarily used as a defensive tool. Players generally reinforce their builds, or defensive structures like [[Vault|vaults]], to make them harder to grief or attack.
!Name

!Usage
First introduced in [[Civcraft]], Citadel has been included in every [[mainline]] civ server since.
!Description

== Mechanics ==

In vanilla minecraft, blocks need only be broken once to be destroyed. In contrast, blocks reinforced by Citadel must be broken repeatedly before the block is destroyed. The durability of a reinforced block depends on the material that block was reinforced with.

[[File:Citadel block break animation.gif|thumb|305px|A reinforced block being destroyed. Each time the block is broken, it reduces the reinforcement durability. The block is destroyed once the durability reaches zero.]]

=== Reinforcement Materials ===

<tabber>
|-|CivMC=
{| class="wikitable sortable"
!Material
!Durability
!Maturation time
!Acid maturation
!Dimension Restriction {{efn|On [[CivMC]], certain reinforcement materials could only be used in specific dimensions.}}
|-
|-
|Stone
|Bypass Mode
|50
|/ctb or /bypass
|30 minutes
|Bypasses a reinforcement and gives you the reinforcement back when you break it
|30 minutes
|Overworld
|-
|-
|Iron Ingot
|Fortify Mode
|300
|/fortify [groupname] or /ctf
|4 hours
|Fortifies blocks you place down.
|6 hours
|Overworld
|-
|-
|Diamond
|Reinforce Mode
|2000
|/reinforce [groupname] or /ctr
|12 hours
|Will reinforce blocks you punch while holding a reinforcement material.
|1 day
|Overworld
|-
|-
|Nether Brick
|Info Mode
|50
|/info or /cti
|30 minutes
|Will give you information about blocks you click on.
|30 minutes
|Nether
|-
|-
|Gold Ingot
|Toggle All Modes Off
|300
|/ctoff or /cto
|4 hours
|Turns off all reinforcement and information modes
|6 hours
|Nether
|-
|Gilded Blackstone
|2000
|12 hours
|1 day
|Nether
|-
|-
|Materials
|/ctm or /ctmaterials
|Lists all possible materials you can reinforce with.
|}
|}
|-|CivClassic 2.0=

{| class="wikitable sortable"
== Reinforcement Times ==
{|
!Material
!Material
!Durability
!Reinforcements
!Maturation time
!Maturation time
!Acid Break Time
!Acid maturation
|-
|Paper {{efn|Patreon reward paid by [[wjkroeker]]<ref>https://www.reddit.com/r/civclassics/comments/crz0fi/admins_chadmins_paper_is_real/</ref>}}
|1
|1 minute
|1 minute
|-
|-
|Stone
|Stone
|50
|50
|5 minutes
|60
|20 minutes
|120
|-
|-
|Iron
|Iron Ingot
|250
|300
|30 minutes
|750
|6 hours
|900
|-
|-
|Diamond
|Diamond
|2000
|2000
|4 hours
|2880
|2 days
|2880
|-
|}
|-|Devoted 3.0=
{| class="wikitable sortable"
!Material
!Durability
!Maturation time
!Acid maturation
|-
|Stone
|50
|1 hour
|2 hours
|-
|Iron Ingot
|250
|12 hours
|15 hours
|-
|-
|Emerald
|Emerald
|500
|500
|1 day
|1440
|1 day
|1440
|-
|-
|Diamond
|Stone Reinforced Obsidian
|2000
|1000
|2 days
|1880
|2 days
|1880
|-
|-
|}
|Iron Reinforced Obsidian
|-|Civcraft 3.0=
|2400
{| class="wikitable sortable"
|2880
!Material
|2880
!Durability
!Maturation time
!Acid maturation
|-
|-
|Stone
|Diamond Reinforced Obsidian
|50
|3000
|5 minutes
|2880
|30 minutes
|2880
|-
|-
|Basic reinforcement
|Diamond Reinforced Obsidian Spike
|250
|3000
|20 minutes
|60
|2 hours
|2880
|-
|-
|Decent reinforcement
|Emerald Reinforced Obsidian
|750
|4000
|3 hours
|2880
|8 hours
|2880
|-
|-
|Good reinforcement
|Emerald Reinforced Obsidian Spike
|1500
|4000
|10 hours and 40 minutes
|60
|1 day
|2880
|-
|-
|Rapid reinforcement
|Iron Reinforced Door
|1500
|3600
|5 minutes
|2880
|1 day
|2880
|-
|-
|Best reinforcement
|Diamond Reinforced Door
|2000
|6000
|42 hours and 40 minutes
|2880
|48 hours
|2880
|-
|-
|}
|Emerald Reinforced Door
|-|Civcraft 2.0=
|10000
{| class="wikitable sortable"
|2880
!Material
|2880
!Durability
!Maturation time
!Acid maturation
|-
|-
|Stone
|Diamond Reinforced Chest
|25
|9000
|10 minutes
|2880
|10 minutes
|2880
|-
|Iron Ingot
|250
|1 hour
|1 hour
|-
|Diamond
|1800
|1 day
|1 day
|-
|-
|Emerald Reinforced Chest
|12000
|2880
|2880
|}
|}
|-|Civcraft 1.0=
(Only the first four can be used without a factory)
{| class="wikitable sortable"

!Material
== Advanced Commands ==
!Durability
{|
!Maturation time
!Name
!Acid maturation
!Usage
!Description
!Aliases
|-
|-
|Stone
|Create Group
|25
|/nlcg <group-name> [group-type] [password]
|{{n/a}}
|Creates a group, default is private unless public is specified
|{{n/a}}
|nlcreategroup, create, ctcreate, creategroup, cg
|-
|-
|Iron Ingot
|Delete Group
|250
|/nldg <group-name>
|{{n/a}}
|Deletes a group
|{{n/a}}
|nldeletegroup, dg, delete, deletegroup, ctdelete
|-
|-
|Diamond
|Transfer Group
|1800
|/nltg <group-name> <target-player-name>
|{{n/a}}
|Transfer ownership of a group to a player
|{{n/a}}
|nltransfergroup, nltransfer
|-
|-
|}
|Merge Group
|-|CivRealms 2.0=
|/nlmg <group-name1> <group-name2>
{| class="wikitable sortable"
|Merges group1 into group2, leaving group1 as the remaining group
!Material
|nlmergegroups, nlmerge, merge
!Durability
!Maturation time
!Acid maturation
|-
|-
|Stone
|Set Password on Group
|100
|/nlsp <group-name> <password>
|10 minutes
|Sets a password on a group anyone can use with /nljg to join
|30 minutes
|nlsetpassword, nlsetpass, setpass
|-
|-
|Iron Ingot
|Join Group
|750
|/nljg <group-name> <group-password>
|1 hour
|Join a password protected group
|8 hours
|nljoingroup, nljoin, join
|-
|-
|Diamond
|Leave Group
|3000
|/nlleg <group-name>
|10 hours
|Leave a group
|36 hours
|nlleavegroup, nlleave, leavegroup, ctleave
|-
|-
|Bedrock
|List Your Groups
|3000000
|/nllg [page]
|5 minutes
|List groups that you are a member of
|5 minutes
|nllistgroups, nllistg, listgroups, ctlist, lg
|-
|-
|}
|List Members of Your Group
</tabber>{{Notelist}}
|/nllm <group-name> [rank]

|Lists all the members of a group, if no rank is specified it lists all rank types.
=== Restricted Usage ===
|nllistmembers, nllistm, lm, listmembers, ctmembers, members

Unless they have permissions on the NameLayer group the block is reinforced to, players cannot interact with reinforced blocks in any way. This includes:

* Opening reinforced containers, such as chests, barrels, or hoppers
* Pulling items out of — or putting them into — a reinforced container with a hopper (unless the container has been marked as [[Citadel#Insecure Mode|insecure]])
* Opening or closing reinforced apertures, such as doors or trapdoors
* Tilling reinforced grass or destroying reinforced farmland
* Initiating a redstone signal from a reinforced redstone component. Stepping on a reinforced pressure plate or clicking a reinforced button, for instance, will not send a redstone signal
* Harvesting or planting crops on top of a reinforced block

=== Tool Durability ===

Breaking a reinforced block will not take durability off a tool. However, performing the final break which destroys a reinforced block will. This means that destroying a reinforced block with a tool consumes the same durability as breaking a regular block.

=== Gravity ===

Reinforced blocks are not affected by gravity. This means that, for instance, reinforced sand will float, even when unsupported by blocks under it.

However, blocks which require a supporting block to be placed on — such as doors, rails, buttons, or torches — still have this requirement, even if they are reinforced.

== Modes ==
Citadel has several modes which players can enter into or exit from at any time. These modes change how players reinforce blocks or interact with reinforced blocks.
{| class="wikitable"
!Type
!Mode
!Command
|-
|-
! rowspan="6" |[[Citadel#Reinforcement Modes|Reinforcement Modes]]
|Global Stats
|[[Citadel#Reinforce Mode|Reinforce Mode]]
|/ nlgls
|<code>/ctr [group]</code>
|Lists the amount of groups on the server.
|
|-
|-
|[[Citadel#Fortify Mode|Fortify Mode]]
|Group Stats
|<code>/ctf [group]</code>
|/ nlgs
|Lists the members in a group.
|
|-
|-
|[[Citadel#Easy Mode|Easy Mode]]
|Info Dump
|<code>/cte</code>
|/ nlid [page]
|Dumps information for a Citadel client-side mod.
|
|-
|-
|[[Citadel#Advanced Mode|Advanced Mode]]
|List Permissions
|<code>/cta [group]</code>
|/nllp [groupname] [rank]
|Lists the permissions a rank has
|nllistpermissions, nllistperms
|-
|-
|[[Citadel#Patch Mode|Patch Mode]]
|Modify Permissions
|<code>/ctp</code>
|/nlmp <groupname> <add/remove> <rank> <PermissionType>
|Modify the permissions a rank has
|nlmodifyperms, nlmodifypermissions, nlmodperms
|-
|-
|[[Citadel#Normal Mode|Normal Mode]]
|List PlayerTypes
|<code>/cto</code>
|/nllpt
|Lists PlayerTypes
|nllistplayertypes, nllistptypes
|-
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|Default Group
|[[Citadel#Insecure Mode|Insecure Mode]]
|/nlsdg <group-name>
|<code>/ctin</code>
|Will set the group to your default group
|nlsetdefaultgroup, nlsetdefault, setdefault, default
|-
|-
|[[Citadel#Info Mode|Info Mode]]
|List Default Group
|<code>/cti</code>
|/nlgdg
|-
|Lists what your default group is
|[[Citadel#Bypass Mode|Bypass Mode]]
|nlgetdefaultgroup, nlgetdefault
|<code>/ctb</code>
|}
|}
<> = mandatory [] = optional


=== Member Management ===
=== Reinforcement Modes ===

{|
These modes change the mechanism by which players reinforce blocks.
!Name

!Usage
By default, players are in [[Citadel#Normal Mode|Normal mode]], which does not allow blocks to be reinforced.

==== Reinforce Mode ====
{{hatnote|<code>/ctr [group]</code>}}

Reinforce mode is the most basic reinforcement mode. While in Reinforce mode, left or rick clicking on a block with a reinforcement material in the player's hand will reinforce that block.

<code>group</code> is the NameLayer group blocks will be reinforced to. If not supplied, it will use the player's [[default group]].

==== Fortify Mode ====
{{hatnote|<code>/ctf [group]</code>}}

The command for Fortify mode must be run while holding a reinforcement material in the player's hand. While in Fortify mode, any blocks the player placees will automatically be reinforced with that material. If the player runs out of reinforcement material, or a reinforcement fails for any reason, Fortify mode will exit.

<code>group</code> is the NameLayer group blocks will be reinforced to. If not supplied, it will use the player's [[default group]].

==== Easy Mode ====
{{hatnote|<code>/cte</code>}}

While in Easy mode, left clicking a block with a reinforcement material in the player's hand will reinforce that block. Although similar to Reinforce mode, Easy mode allows players to right click blocks without the risk of accidentally reinforcing them. Additionally, Easy mode does not take a <code>group</code> argument, and can only reinforce to a player's default group.

==== Advanced Mode ====
{{hatnote|<code>/cta [group]</code>}}

The command for Advanced mode must be run while holding a block in the player's main hand and a reinforcement material in the player's offhand. Until Advanced mode exits, whenever that block type is placed, it will be reinforced with the corresponding material.

The command for Advanced mode may be repeated multiple times to tie different block types to different reinforcement materials. These associations last only until the player exits Advanced mode.

<code>group</code> is the NameLayer group the corresponding block type will be reinforced to. If not supplied, it will use the player's [[default group]].

==== Patch Mode ====
{{hatnote|<code>/ctp</code>}}

Used to repair existing reinforcements instead of creating them. While in Patch mode, left or right click an existing reinforced block. It will be repaired to full durability if you have the reinforcement material used to reinforce the block in your inventory. The chance of consuming the reinforcement material is proportional to how damaged the block is. For instance, a block at 95% durability would have a 5% chance of consuming the material.

==== Normal Mode ====
{{hatnote|<code>/cto</code>}}

Exits any reinforcement mode and returns to Normal mode. This is the default mode for all players. While in Normal mode, reinforcements cannot be created.

=== Toggle Modes ===

These modes allow you to retrieve information about reinforcements or affect reinforcements in some other way besides creating a reinforcement. These modes can be toggled on or off independently of a reinforcement mode or of each other. In other words, you could have info mode, bypass mode, and reinforce mode all active at the same time.

==== Insecure Mode ====
{{hatnote|<code>/ctin</code>}}

Insecure mode allows you to left click a reinforced container to turn it into an "insecure" reinforcement. An insecure reinforcement allows hoppers to move items in and out of the container, in contrast to a normal reinforcement, which will not.

==== Info Mode ====
{{hatnote|<code>/cti</code>}}

While in Info mode, left or right clicking a block will cause information about its reinforcement to be displayed, including its reinforcement material and durability. This can be used even on blocks reinforced to a group you do not have permissions on.

==== Bypass Mode ====
{{hatnote|<code>/ctb</code>}}

Bypass mode allows you to bypass reinforcements on a group have permissions on. This means that you can treat reinforced blocks as unreinforced blocks when in Bypass mode. When breaking a reinforced block in Bypass mode, the reinforcement material originally used will be returned to you.

== Acid Block ==
[[File:Icenia obbybomb acid.png|thumb|Acid (here gold) blocks being used to clean up an [[obbybombing]] of [[Icenia]] on [[CivMC]]. ]]
An acid block is the name given to a particular block which can be used to clear reinforced blocks at scale, without manually breaking each reinforced block. Servers have historically used gold blocks as acid blocks since their introduction on Civcraft.

To use an acid block, place it underneath a reinforced block, then reinforce the acid block with the same material that the block above it is reinforced with. Depending on this material, the acid block will take a certain amount of time to mature (see {{section link||Reinforcement Materials}}). Once matured, run <code>/ctacid</code> while looking at the acid block to destroy the block above it. This works regardless of how much durability the reinforced block has. Only users with permissions on an acid block's reinforcement group can run <code>/ctacid</code> on it.

<code>/ctacid</code> can be run on many acid blocks simultaneously, as long as they are all beneath the player's cursor when the command is issued.

Note that an acid block does not gradually do damage to the block above it. It only has an effect once it matures and someone runs <code>/ctacid</code> on it.

Acid blocks is one reason why almost all defensive infrastructure (such as [[Vaults]] and [[Bunkers]]) are built at bedrock. Building on an unbreakable block such as bedrock prevents acid blocks from being used against you.

Acid blocks are often used to clean up [[Obsidian Bombs]].

==Decay ==

Reinforcements can decay if nobody on the group they are reinforced to logs in for a certain amount of time. For instance, if nobody on a group logs in for 3 months, all blocks reinforced to that group will get a damage multiplier of 2 (meaning they require half the breaks to break).

Since a single player on the group logging in is enough to reset decay, decayed reinforcements are uncommon.

{| class="wikitable"
|+
!Decay state
!Inactivity
!Damage multiplier
|-
|Not decayed
|< 3 months
|x1 (normal)
|-
| Partially decayed
|> 3 months but < 1 year
|2-8
|-
|Highly decayed
|> 1 year but < 2 years
| 16-128
|-
|Heavily decayed
|> 2 years but < 3 years
|256-1024
|-
|Completely decayed
|> 3 years
| >= 2048
|}

On CivMC, decay follows https://www.desmos.com/calculator/awern3k4ol, where the y axis is the multiplier and the x axis is the time passed in months.

==Redstone Interactions==

TODO rewrite as paragraphs

* Reinforced buttons will only emit a signal if someone from the namelayer is nearby (distance?)
*Comparators cannot inspect the content of a reinforced container block (e.g: chests, furnaces, droppers)
*Droppers and hoppers will not transfer items if the destination block is not on the same reinforcement group.
*Blocks can not be attached to a reinforced redstone component (e.g dropper, dispenser, hopper?) if not on the reinforcement groups.
*Reinforced doors, trapdoors and fences gate will only respond to a redstone signal if someone on the reinforcement group is less than 7 blocks away from it <ref>https://www.reddit.com/r/civeconomics/comments/9qwas2/on_citadel_redstone/</ref>
== Command Reference ==

{| class="wikitable"
!Category
!Command
!Description
!Description
!Alias
!Aliases
|-
|-
! rowspan="2" |Info
|Invite Member
|<code>/help citadel [page]</code>
|/nlip <group-name> <player-name> [rank]
|Lists all Citadel commands.
|Invite player to the group, default is member unless another rank is specified
|{{n/a}}
|nlinviteplayer, nlinvite, invite, ctinvite, allow, cta
|-
|-
|<code>/ctdl</code>
|Revoke Invite
|Shows an interface of all reinforcement materials.
|/nlri <group-name> <player-name>
|{{n/a}}
|Revokes an invitation to a group
|nlrevokeinvite, nluninvite, revoke, uninvite
|-
|-
! rowspan="5" |[[Citadel#Reinforcement Modes|Reinforcement Modes]]
|Accept Invite
|<code>[[Citadel#Fortify Mode|/ctf [group]]]</code>
|/nlag <group-name>
|Enters fortify mode.
|Accept invitation to a group
|<code>/ctfortify</code>
|nlacceptinvite, nlacceptgroup, acceptinvite, acceptgroup, accept, join, ctjoin, ctj, ag
|-
|-
|<code>[[Citadel#Reinforce Mode|/ctr [group]]]</code>
|List Invites
|Enters reinforce mode.
|/nllci
|<code>/ctreinforce</code>
|Lists invitations you haven't accepted yet
|nllistcurrentinvites, nllistinvites, invites, ctinvites
|-
|-
|<code>[[Citadel#Advanced Mode|/cta [group]]]</code>
|Toggle Auto-Accept Invites
|Enters advanced mode.
|/nltaai
|<code>/ctadvanced</code>
|Will automatically accept invites, or toggle it off
|nlautoacceptinvites, nlautoaccept, autoaccept
|-
|-
|<code>[[Citadel#Normal Mode|/cto]]</code>
|Promote Player
|Enters normal mode.
|/nlpp <group-name> <player-name> <rank>
|<code>/ctoff</code>
|Promotes a player in a group to the specified rank
|nlpromoteplayer, nlpromote, ctpromote, ctaddmod, ctam, addmod, promoteplayer
|-
|-
|<code>[[Citadel#Easy Mode|/cte [group]]]</code>
|Remove Member
|Enters easy mode.
|/nlrm <group-name> <player-name>
|<code>/cteasy</code>
|Remove a player from a group
|nlremovemember, nlremove, nlkick, remove, kickmember, ctremove, ctkick
|-
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|List Members of Your Group
|<code>[[Citadel#Info Mode|/cti]]</code>
|/nllm <group-name> [rank]
|Toggles info mode.
|Lists all the members of a group, if no rank is specified it lists all rank types.
|<code>/ctinfo</code>
|
|-
|<code>[[Citadel#Bypass Mode|/ctb]]</code>
|Toggles bypass mode.
|<code>/ctbypass</code>
|-
|<code>[[Citadel#Insecure Mode|/ctin]]</code>
|Toggles insecure mode.
|<code>/ctinsecure</code>
|-
![[Citadel#Acid Block|Acid Block]]
|<code>/ctacid</code>
|Activates an acid block.
|{{n/a}}
|}
|}
<> = mandatory [] = optional


== History ==
=== Citadel / Building Management ===
{| class="wikitable"
{|
|+
!Name
! colspan="3" |[[CivMC]]
!Usage
!Description
!Aliases
|-
|-
!'''July 16, 2023'''
|Bypass Mode
|Acid maturation durations changed for Stone (2 hours -> 30 minutes), Iron Ingot (12 hours -> 6 hours), Nether Brick (2 hours -> 30 minutes), and Gold Ingot (12 hours -> 6 hours)
|/ctbypass or /ctb
|Bypasses a reinforcement and gives you the reinforcement back when you break it
|
|-
|-
!'''April 5, 2023'''
|Fortify Mode
|Maturation durations changed for Stone (5 minutes -> 30 minutes), Iron Ingot (30 minutes -> 4 hours), Diamond (4 hours -> 12 hours), Nether Brick (5 minutes -> 30 minutes), Gold Ingot (30 minutes -> 4 hours), and Gilded Blackstone (4 hours -> 12 hours).
|/ctfortify [groupname] or /ctf

|Fortifies blocks you place down.
Acid maturation durations changed for Stone (20 minutes -> 2 hours), Iron Ingot (6 hours -> 12 hours), Diamond (2 days -> 1 day), Nether Brick (20 minutes -> 2 hours), Gold Ingot (6 hours -> 12 hours), and Gilded Blackstone (2 days -> 1 day).
|
|-
|-
!'''September 19, 2022'''
|Reinforce Mode
|Diamond and Netherite blocks are added as acid blocks, which apply acid vertically and in all directions respectively. Gold blocks still only apply acid upwards.
|/ctreinforce [groupname]
|Will reinforce blocks you punch while holding a reinforcement material.
|ctr, reinforce, protect, ctprivate, lwc, private
|-
|-
!'''June 2, 2022'''
|Info Mode
|Server launches with Citadel.
|/ctinfo
|Will give you information about blocks you click on.
|cti, ctinformation, info
|-
|-
! colspan="2" |[[CivClassic 2.0]]
|Toggle All Modes Off
|/ctoff
|Turns off all reinforcement and information modes
|off, cto
|-
|-
!June 2, 2017
|Materials
|Server launches with Citadel.
|/ctm or /ctmaterials
|Lists all possible materials you can reinforce with.
|
|-
|-
! colspan="2" |[[Devoted 3.0]]
|Help
|/help Citadel
|
|
|-
|-
!September 17, 2016
|ctacid
|Server launches with Citadel.
|/ctacid
|-
|Activates an acid block
! colspan="2" |[[Civcraft 3.0]]
|
|-
!July 30, 2016
|Server launches with Citadel.
|-
! colspan="2" |[[Civcraft 2.0]]
|-
!May 19, 2013
|Server launches with Citadel.
|-
! colspan="2" |[[Civcraft 1.0]]
|-
!March 24, 2012
|Server launches with Citadel.
|}
|}

<> = mandatory [] = optional
== Notes ==

{{notelist}}

==References==
<references />
{{Mechanics}}

Latest revision as of 03:48, 1 May 2024

An obsidian block reinforced with stone. From top to bottom, as shown by /cti: durability, NameLayer group, reinforcement material.

Part of a series on
Mechanics and Plugins
Core Mechanics
Common Mechanics
Minor Mechanics

Citadel is a common plugin on Civ servers which allows blocks to be reinforced at the cost of resources. Reinforced blocks must be broken many times before they are destroyed. The durability of a reinforced block can be increased by reinforcing it with a more expensive material. Reinforced blocks also prevent certain player interactions, such as a reinforced door from being opened.

Citadel interacts closely with the NameLayer plugin. Blocks are reinforced to a particular NameLayer group, and users on that group can bypass the protections of Citadel for that block.

Citadel is primarily used as a defensive tool. Players generally reinforce their builds, or defensive structures like vaults, to make them harder to grief or attack.

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

Mechanics

In vanilla minecraft, blocks need only be broken once to be destroyed. In contrast, blocks reinforced by Citadel must be broken repeatedly before the block is destroyed. The durability of a reinforced block depends on the material that block was reinforced with.

A reinforced block being destroyed. Each time the block is broken, it reduces the reinforcement durability. The block is destroyed once the durability reaches zero.

Reinforcement Materials

Material Durability Maturation time Acid maturation Dimension Restriction [a]
Stone 50 30 minutes 30 minutes Overworld
Iron Ingot 300 4 hours 6 hours Overworld
Diamond 2000 12 hours 1 day Overworld
Nether Brick 50 30 minutes 30 minutes Nether
Gold Ingot 300 4 hours 6 hours Nether
Gilded Blackstone 2000 12 hours 1 day Nether
Material Durability Maturation time Acid maturation
Paper [b] 1 1 minute 1 minute
Stone 50 5 minutes 20 minutes
Iron Ingot 300 30 minutes 6 hours
Diamond 2000 4 hours 2 days
Material Durability Maturation time Acid maturation
Stone 50 1 hour 2 hours
Iron Ingot 250 12 hours 15 hours
Emerald 500 1 day 1 day
Diamond 2000 2 days 2 days
Material Durability Maturation time Acid maturation
Stone 50 5 minutes 30 minutes
Basic reinforcement 250 20 minutes 2 hours
Decent reinforcement 750 3 hours 8 hours
Good reinforcement 1500 10 hours and 40 minutes 1 day
Rapid reinforcement 1500 5 minutes 1 day
Best reinforcement 2000 42 hours and 40 minutes 48 hours
Material Durability Maturation time Acid maturation
Stone 25 10 minutes 10 minutes
Iron Ingot 250 1 hour 1 hour
Diamond 1800 1 day 1 day
Material Durability Maturation time Acid maturation
Stone 25 — —
Iron Ingot 250 — —
Diamond 1800 — —
Material Durability Maturation time Acid maturation
Stone 100 10 minutes 30 minutes
Iron Ingot 750 1 hour 8 hours
Diamond 3000 10 hours 36 hours
Bedrock 3000000 5 minutes 5 minutes
  1. ↑ On CivMC, certain reinforcement materials could only be used in specific dimensions.
  2. ↑ Patreon reward paid by wjkroeker[1]

Restricted Usage

Unless they have permissions on the NameLayer group the block is reinforced to, players cannot interact with reinforced blocks in any way. This includes:

  • Opening reinforced containers, such as chests, barrels, or hoppers
  • Pulling items out of — or putting them into — a reinforced container with a hopper (unless the container has been marked as insecure)
  • Opening or closing reinforced apertures, such as doors or trapdoors
  • Tilling reinforced grass or destroying reinforced farmland
  • Initiating a redstone signal from a reinforced redstone component. Stepping on a reinforced pressure plate or clicking a reinforced button, for instance, will not send a redstone signal
  • Harvesting or planting crops on top of a reinforced block

Tool Durability

Breaking a reinforced block will not take durability off a tool. However, performing the final break which destroys a reinforced block will. This means that destroying a reinforced block with a tool consumes the same durability as breaking a regular block.

Gravity

Reinforced blocks are not affected by gravity. This means that, for instance, reinforced sand will float, even when unsupported by blocks under it.

However, blocks which require a supporting block to be placed on — such as doors, rails, buttons, or torches — still have this requirement, even if they are reinforced.

Modes

Citadel has several modes which players can enter into or exit from at any time. These modes change how players reinforce blocks or interact with reinforced blocks.

Type Mode Command
Reinforcement Modes Reinforce Mode /ctr [group]
Fortify Mode /ctf [group]
Easy Mode /cte
Advanced Mode /cta [group]
Patch Mode /ctp
Normal Mode /cto
Toggle Modes Insecure Mode /ctin
Info Mode /cti
Bypass Mode /ctb

Reinforcement Modes

These modes change the mechanism by which players reinforce blocks.

By default, players are in Normal mode, which does not allow blocks to be reinforced.

Reinforce Mode

/ctr [group]

Reinforce mode is the most basic reinforcement mode. While in Reinforce mode, left or rick clicking on a block with a reinforcement material in the player's hand will reinforce that block.

group is the NameLayer group blocks will be reinforced to. If not supplied, it will use the player's default group.

Fortify Mode

/ctf [group]

The command for Fortify mode must be run while holding a reinforcement material in the player's hand. While in Fortify mode, any blocks the player placees will automatically be reinforced with that material. If the player runs out of reinforcement material, or a reinforcement fails for any reason, Fortify mode will exit.

group is the NameLayer group blocks will be reinforced to. If not supplied, it will use the player's default group.

Easy Mode

/cte

While in Easy mode, left clicking a block with a reinforcement material in the player's hand will reinforce that block. Although similar to Reinforce mode, Easy mode allows players to right click blocks without the risk of accidentally reinforcing them. Additionally, Easy mode does not take a group argument, and can only reinforce to a player's default group.

Advanced Mode

/cta [group]

The command for Advanced mode must be run while holding a block in the player's main hand and a reinforcement material in the player's offhand. Until Advanced mode exits, whenever that block type is placed, it will be reinforced with the corresponding material.

The command for Advanced mode may be repeated multiple times to tie different block types to different reinforcement materials. These associations last only until the player exits Advanced mode.

group is the NameLayer group the corresponding block type will be reinforced to. If not supplied, it will use the player's default group.

Patch Mode

/ctp

Used to repair existing reinforcements instead of creating them. While in Patch mode, left or right click an existing reinforced block. It will be repaired to full durability if you have the reinforcement material used to reinforce the block in your inventory. The chance of consuming the reinforcement material is proportional to how damaged the block is. For instance, a block at 95% durability would have a 5% chance of consuming the material.

Normal Mode

/cto

Exits any reinforcement mode and returns to Normal mode. This is the default mode for all players. While in Normal mode, reinforcements cannot be created.

Toggle Modes

These modes allow you to retrieve information about reinforcements or affect reinforcements in some other way besides creating a reinforcement. These modes can be toggled on or off independently of a reinforcement mode or of each other. In other words, you could have info mode, bypass mode, and reinforce mode all active at the same time.

Insecure Mode

/ctin

Insecure mode allows you to left click a reinforced container to turn it into an "insecure" reinforcement. An insecure reinforcement allows hoppers to move items in and out of the container, in contrast to a normal reinforcement, which will not.

Info Mode

/cti

While in Info mode, left or right clicking a block will cause information about its reinforcement to be displayed, including its reinforcement material and durability. This can be used even on blocks reinforced to a group you do not have permissions on.

Bypass Mode

/ctb

Bypass mode allows you to bypass reinforcements on a group have permissions on. This means that you can treat reinforced blocks as unreinforced blocks when in Bypass mode. When breaking a reinforced block in Bypass mode, the reinforcement material originally used will be returned to you.

Acid Block

Acid (here gold) blocks being used to clean up an obbybombing of Icenia on CivMC.

An acid block is the name given to a particular block which can be used to clear reinforced blocks at scale, without manually breaking each reinforced block. Servers have historically used gold blocks as acid blocks since their introduction on Civcraft.

To use an acid block, place it underneath a reinforced block, then reinforce the acid block with the same material that the block above it is reinforced with. Depending on this material, the acid block will take a certain amount of time to mature (see § Reinforcement Materials). Once matured, run /ctacid while looking at the acid block to destroy the block above it. This works regardless of how much durability the reinforced block has. Only users with permissions on an acid block's reinforcement group can run /ctacid on it.

/ctacid can be run on many acid blocks simultaneously, as long as they are all beneath the player's cursor when the command is issued.

Note that an acid block does not gradually do damage to the block above it. It only has an effect once it matures and someone runs /ctacid on it.

Acid blocks is one reason why almost all defensive infrastructure (such as Vaults and Bunkers) are built at bedrock. Building on an unbreakable block such as bedrock prevents acid blocks from being used against you.

Acid blocks are often used to clean up Obsidian Bombs.

Decay

Reinforcements can decay if nobody on the group they are reinforced to logs in for a certain amount of time. For instance, if nobody on a group logs in for 3 months, all blocks reinforced to that group will get a damage multiplier of 2 (meaning they require half the breaks to break).

Since a single player on the group logging in is enough to reset decay, decayed reinforcements are uncommon.

Decay state Inactivity Damage multiplier
Not decayed < 3 months x1 (normal)
Partially decayed > 3 months but < 1 year 2-8
Highly decayed > 1 year but < 2 years 16-128
Heavily decayed > 2 years but < 3 years 256-1024
Completely decayed > 3 years >= 2048

On CivMC, decay follows https://www.desmos.com/calculator/awern3k4ol, where the y axis is the multiplier and the x axis is the time passed in months.

Redstone Interactions

TODO rewrite as paragraphs

  • Reinforced buttons will only emit a signal if someone from the namelayer is nearby (distance?)
  • Comparators cannot inspect the content of a reinforced container block (e.g: chests, furnaces, droppers)
  • Droppers and hoppers will not transfer items if the destination block is not on the same reinforcement group.
  • Blocks can not be attached to a reinforced redstone component (e.g dropper, dispenser, hopper?) if not on the reinforcement groups.
  • Reinforced doors, trapdoors and fences gate will only respond to a redstone signal if someone on the reinforcement group is less than 7 blocks away from it [2]

Command Reference

Category Command Description Alias
Info /help citadel [page] Lists all Citadel commands. —
/ctdl Shows an interface of all reinforcement materials. —
Reinforcement Modes /ctf [group] Enters fortify mode. /ctfortify
/ctr [group] Enters reinforce mode. /ctreinforce
/cta [group] Enters advanced mode. /ctadvanced
/cto Enters normal mode. /ctoff
/cte [group] Enters easy mode. /cteasy
Toggle Modes /cti Toggles info mode. /ctinfo
/ctb Toggles bypass mode. /ctbypass
/ctin Toggles insecure mode. /ctinsecure
Acid Block /ctacid Activates an acid block. —

History

CivMC
July 16, 2023 Acid maturation durations changed for Stone (2 hours -> 30 minutes), Iron Ingot (12 hours -> 6 hours), Nether Brick (2 hours -> 30 minutes), and Gold Ingot (12 hours -> 6 hours)
April 5, 2023 Maturation durations changed for Stone (5 minutes -> 30 minutes), Iron Ingot (30 minutes -> 4 hours), Diamond (4 hours -> 12 hours), Nether Brick (5 minutes -> 30 minutes), Gold Ingot (30 minutes -> 4 hours), and Gilded Blackstone (4 hours -> 12 hours).

Acid maturation durations changed for Stone (20 minutes -> 2 hours), Iron Ingot (6 hours -> 12 hours), Diamond (2 days -> 1 day), Nether Brick (20 minutes -> 2 hours), Gold Ingot (6 hours -> 12 hours), and Gilded Blackstone (2 days -> 1 day).

September 19, 2022 Diamond and Netherite blocks are added as acid blocks, which apply acid vertically and in all directions respectively. Gold blocks still only apply acid upwards.
June 2, 2022 Server launches with Citadel.
CivClassic 2.0
June 2, 2017 Server launches with Citadel.
Devoted 3.0
September 17, 2016 Server launches with Citadel.
Civcraft 3.0
July 30, 2016 Server launches with Citadel.
Civcraft 2.0
May 19, 2013 Server launches with Citadel.
Civcraft 1.0
March 24, 2012 Server launches with Citadel.

Notes

References

  1. ↑ https://www.reddit.com/r/civclassics/comments/crz0fi/admins_chadmins_paper_is_real/
  2. ↑ https://www.reddit.com/r/civeconomics/comments/9qwas2/on_citadel_redstone/
Retrieved from "https://civwiki.org/wiki/Citadel?oldid=73155"