Citadel: Difference between revisions

From CivWiki
Jump to navigation Jump to search
Content added Content deleted
VisualWikitext
(add mechanics template)
 
(94 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 a plugin ([https://github.com/CivMC/Citadel source]) which allows blocks to be reinforced, making them hundreds or thousands of times harder to break. Reinforcements are tied to a [[Namelayer]] group and can be bypassed by players on that group. Many civ-specific blocks such as [[Snitches]] and [[Bastions]] only become active once reinforced.
{{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.
== Reinforcing ==


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.
Reinforcing blocks costs one item of the corresponding reinforcement material. This item is returned only when a player who is on the reinforcement group mines the block or uses the relevant Citadel command. Choice of reinforcement material is selected by punching the block with a chosen item or using Citadel commands.


First introduced in [[Civcraft]], Citadel has been included in every [[mainline]] civ server since.
It is possible to double reinforce a double chest by placing it while using <code>/ctf</code>.


=== Materials ===
== 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.
{| class="wikitable"

|+Reinforcement materials {{refn|group=note|There also exists a bedrock reinforcement that takes 147483646 breaks to destroy, accessible only to server operators.}}
[[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
|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
|-
|}
|-|CivClassic 2.0=
{| class="wikitable sortable"
!Material
!Material
!Durability
!Number of breaks to destroy
!Maturation time
!Maturation time
!Acid maturation
!Acid maturation
|-
|-
|Paper {{refn|group=note|Patreon reward paid by [[wjkroeker]]<ref>https://www.reddit.com/r/civclassics/comments/crz0fi/admins_chadmins_paper_is_real/</ref>}}
|Paper {{efn|Patreon reward paid by [[wjkroeker]]<ref>https://www.reddit.com/r/civclassics/comments/crz0fi/admins_chadmins_paper_is_real/</ref>}}
|1
|1
|1 minutes
|1 minute
|1 minutes
|1 minute
|-
|-
|Stone
|Stone
Line 26: Line 81:
|20 minutes
|20 minutes
|-
|-
|Iron
|Iron Ingot
|300
|300
|30 minutes
|30 minutes
Line 37: Line 92:
|-
|-
|}
|}
|-|Devoted 3.0=

{| class="wikitable sortable"

!Material
=== Insecure Reinforcement ===
!Durability

!Maturation time
A reinforcement can be set to insecure by using <code>/ctin</code> or <code>/ctinsecure</code> and hitting it. This allows hoppers to move items in and out.
!Acid maturation


=== Unreinforceable blocks ===

Some blocks cannot be reinforced. This includes blocks with unique properties such as TNT, bedrock and portal blocks. Most plants cannot be reinforced. Liquids and entities are also not reinforceable, as they are not blocks.

{| class="wikitable mw-collapsible mw-collapsed"
|+ class="nowrap | Non reinforceable blocks
!Block name
|-
|-
|Stone
|BEDROCK
|50
|1 hour
|2 hours
|-
|-
|Iron Ingot
|END_GATEWAY
|250
|12 hours
|15 hours
|-
|-
|Emerald
|END_PORTAL_FRAME
|500
|1 day
|1 day
|-
|-
|Diamond
|END_PORTAL
|2000
|2 days
|2 days
|-
|-
|}
|PISTON_EXTENSION
|-|Civcraft 3.0=
{| class="wikitable sortable"
!Material
!Durability
!Maturation time
!Acid maturation
|-
|-
|Stone
|PISTON_MOVING_PIECE
|50
|5 minutes
|30 minutes
|-
|-
|Basic reinforcement
|TNT
|250
|20 minutes
|2 hours
|-
|-
|Decent reinforcement
|FIRE
|750
|3 hours
|8 hours
|-
|-
|Good reinforcement
|SNOW (only layers of snow, the full block can be reinforced)
|1500
|10 hours and 40 minutes
|1 day
|-
|-
|Rapid reinforcement
|ICE (only normal ice)
|1500
|5 minutes
|1 day
|-
|-
|Best reinforcement
|PORTAL
|2000
|42 hours and 40 minutes
|48 hours
|-
|-
|}
|CAKE_BLOCK
|-|Civcraft 2.0=
{| class="wikitable sortable"
!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
|-
|-
|WEB
|-
|Any plant
|}
|}
|-|Civcraft 1.0=

{| class="wikitable mw-collapsible mw-collapsed"
{| class="wikitable sortable"
!Material
|+ class="nowrap" | Non reinforceable plants
!Durability
!Block name
!Maturation time
!Acid maturation
|-
|-
|Stone
|CROPS
|25
|{{n/a}}
|{{n/a}}
|-
|-
|Iron Ingot
|CARROT
|250
|{{n/a}}
|{{n/a}}
|-
|-
|Diamond
|POTATO
|1800
|{{n/a}}
|{{n/a}}
|-
|-
|}
|NETHER_WARTS
|-|CivRealms 2.0=
{| class="wikitable sortable"
!Material
!Durability
!Maturation time
!Acid maturation
|-
|-
|Stone
|VINE
|100
|10 minutes
|30 minutes
|-
|-
|Iron Ingot
|CACTUS
|750
|1 hour
|8 hours
|-
|-
|Diamond
|SUGAR_CANE_BLOCK
|3000
|10 hours
|36 hours
|-
|-
|Bedrock
|RED_ROSE (Includes all single block tall flowers)
|3000000
|5 minutes
|5 minutes
|-
|-
|}
|YELLOW_FLOWER
</tabber>{{Notelist}}

=== 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 [[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]]
|BROWN_MUSHROOM
|[[Citadel#Reinforce Mode|Reinforce Mode]]
|<code>/ctr [group]</code>
|-
|-
|[[Citadel#Fortify Mode|Fortify Mode]]
|RED_MUSHROOM
|<code>/ctf [group]</code>
|-
|-
|[[Citadel#Easy Mode|Easy Mode]]
|SAPLING
|<code>/cte</code>
|-
|-
|[[Citadel#Advanced Mode|Advanced Mode]]
|LONG_GRASS
|<code>/cta [group]</code>
|-
|-
|[[Citadel#Patch Mode|Patch Mode]]
|DEAD_BUSH
|<code>/ctp</code>
|-
|[[Citadel#Normal Mode|Normal Mode]]
|<code>/cto</code>
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|[[Citadel#Insecure Mode|Insecure Mode]]
|<code>/ctin</code>
|-
|[[Citadel#Info Mode|Info Mode]]
|<code>/cti</code>
|-
|[[Citadel#Bypass Mode|Bypass Mode]]
|<code>/ctb</code>
|}
|}


=== Reinforcement Modes ===


These modes change the mechanism by which players reinforce blocks.
== Breaking ==


By default, players are in [[Citadel#Normal Mode|Normal mode]], which does not allow blocks to be reinforced.
[[File:Citadel block break animation.gif|thumb|305px| '''Example of a reinforced block being broken.''' The block break animation plays and the block breaks but because it is reinforced, the block reappears.]]


==== Reinforce Mode ====
Whereas normal minecraft blocks need only be broken once to actually break, reinforced blocks must be broken hundreds or thousands of times, depending on the material used to reinforce it. Tool durability does not decrease when breaking reinforcements, only when performing the final break of a reinforced block which results in its actual breakage. This means that breaking a reinforced block costs only 1 durability from the tool used.
{{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.
Explosions will do one reinforcement damage to all blocks in blast range. This only applies to blocks that the explosion would have been able to damage had they been unreinforced.


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


==== Fortify Mode ====
Acid blocks is a particular block (usually a gold block) which can be placed underneath a reinforced block to "dissolve" the reinforcement. Depending on the reinforcement material used, the acid block could take hours or days to mature and fully dissolve the reinforcement. As many acid blocks can be placed at the same time and they all mature at once, acid blocks can be much faster at breaking reinforcements in some circumstances.
{{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.
To use an acid block, place the designated acid block type underneath a reinforced block, then reinforce it with the same material that the block you're trying to dissolve is reinforced with. Wait the designated maturation time, then come back, look at the acid block, and type <code>/ctacid</code> to both pop the acid block and break the block above it.


The <code>/ctacid</code> command has a range of 40 blocks and can be used to remove many acid blocks simultaneously, as long as they are all in line with the player's cursor when the command is issued.
<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 ====
Acid blocks are why almost all defensive infrastructure (such as [[Vaults]] and [[Bunkers]]) are built at bedrock: you cannot use acid blocks on blocks which are built directly on top of bedrock.
{{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.
Acid blocks are often used to clean up [[Obsidian Bombs]].


==== 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.
== Decay ==

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).
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).
Line 142: Line 375:
Since a single player on the group logging in is enough to reset decay, decayed reinforcements are uncommon.
Since a single player on the group logging in is enough to reset decay, decayed reinforcements are uncommon.


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

==Redstone Interactions==


TODO rewrite as paragraphs
TODO rewrite as paragraphs


* Reinforced buttons will only emit a signal if someone from the namelayer is nearby (distance?)
* 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)
*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.
*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.
*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>
*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 ==


== Commands ==


{|class="wikitable"
{| class="wikitable"
!Category
|+Citadel commands
!Command
!+class="nowrap" | Usage
!Description
! Alias
!Alias
! Description
|-
|-
! rowspan="2" |Info
| /ctfortify [groupname]
|<code>/help citadel [page]</code>
| /ctf
|Lists all Citadel commands.
| Reinforces all blocks placed until reinforcement material runs out or command used to exit reinforcement mode. Requires holding reinforcement material items when typing command
|{{n/a}}
|-
|-
|<code>/ctdl</code>
|/ctreinforce [groupname]
|Shows an interface of all reinforcement materials.
|/ctr
|{{n/a}}
| Reinforces blocks punched while holding a reinforcement material
|-
|-
! rowspan="5" |[[Citadel#Reinforcement Modes|Reinforcement Modes]]
| /ctinfo
|<code>[[Citadel#Fortify Mode|/ctf [group]]]</code>
| /cti
|Enters fortify mode.
| Will give reinforcement information about blocks clicked on.
|<code>/ctfortify</code>
|-
|-
|<code>[[Citadel#Reinforce Mode|/ctr [group]]]</code>
| /ctoff
|Enters reinforce mode.
| /cto
|<code>/ctreinforce</code>
| Turns off all reinforcement and information modes
|-
|-
|<code>[[Citadel#Advanced Mode|/cta [group]]]</code>
| /ctacid
|Enters advanced mode.
|
|<code>/ctadvanced</code>
| Activates an acid block
|-
|-
|<code>[[Citadel#Normal Mode|/cto]]</code>
| /ctbypass
|Enters normal mode.
|/ctb
|<code>/ctoff</code>
| Bypasses a reinforcement and gives the reinforcement back when you break it
|-
|-
|<code>[[Citadel#Easy Mode|/cte [group]]]</code>
| /ctinsecure
|Enters easy mode.
|/ctin
|<code>/cteasy</code>
| Toggles insecure reinforcment
|-
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|/rein
|<code>[[Citadel#Info Mode|/cti]]</code>
|
|Toggles info mode.
|List all possible materials you can reinforce with, in a GUI
|<code>/ctinfo</code>
|-
|-
|<code>[[Citadel#Bypass Mode|/ctb]]</code>
| /help Citadel
|Toggles bypass mode.
|
|<code>/ctbypass</code>
| List all commands
|-
|<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}}
|}
|}


== Advanced features ==
== History ==
{| class="wikitable"
|+
! colspan="3" |[[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).
TODO clean this up, move to other sections
|-

!'''September 19, 2022'''
* Note that reinforced blocks are not affected by gravity (e.g. reinforced sand will float). However if the block by default breaks when block beneath is removed, it will break even if reinforced (e.g. rails whose base is broken will also break).
|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.
* Being in reinforcement or fortify mode will prevent the use of citadel buttons. Walking over pressure plates while in this mode will reinforce them to currently selected group.
|-
* Reinforcing farmland will give crops planted on it citadel protection.
!'''June 2, 2022'''
* Reinforce leaf blocks and destroying the tree they are apart of will lead to loss of reinforcment.
|Server launches with Citadel.
|-
! colspan="2" |[[CivClassic 2.0]]
|-
!June 2, 2017
|Server launches with Citadel.
|-
! colspan="2" |[[Devoted 3.0]]
|-
!September 17, 2016
|Server launches with Citadel.
|-
! 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.
|}


== Known bugs ==
== Notes ==


{{notelist}}
* Placing a reinforced button/sign and breaking the block at the base will make it drop but will leave a reinforced air block behind. As this is an exploit its use should be avoided.


==References==
{{Template:Mechanics}}
<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"