Citadel: Difference between revisions

From CivWiki
Jump to navigation Jump to search
Content added Content deleted
VisualWikitext
(remove mostly wrong note)
 
(81 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.
The most common method of reinforcing is running <code>/ctr</code>, then punching a block with a reinforcement material in your hand. Reinforcing a block always costs one item of the reinforcement material. This item is returned only when a player who is on the reinforcement group mines the block or changes its reinforcement level.


First introduced in [[Civcraft]], Citadel has been included in every [[mainline]] civ server since.
There are other reinforcement modes which afford different methods of reinforcing blocks other than punching it - see [[#Reinforcement Modes]].


== Mechanics ==
A reinforced block will also protect any crops growing on it. For instance, reinforced farmland (tilled dirt blocks) will prevent wheat growing on it from being broken in a single hit. The reinforcement of a crop is linked to the reinforcement of the block it is growing on, so damaging one will damage the other.


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

[[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>
<tabber>
|-|CivMC=
|-|CivMC=
{| class="wikitable"
{| class="wikitable sortable"
|+Reinforcement materials {{refn|group="Note"|name=bedrock|There also exists a bedrock reinforcement that takes 147483646 breaks to destroy, accessible only to server operators.}}
!Material
!Material
!Durability
!Breaks to destroy
!Maturation time
!Maturation time
!Acid maturation
!Acid maturation
!Dimension Restriction {{efn|On [[CivMC]], certain reinforcement materials could only be used in specific dimensions.}}
!Notes
|-
|-
|Stone
|Stone
|50
|50
|5 minutes
|30 minutes
|20 minutes
|30 minutes
|Overworld
|can only be used in the overworld
|-
|-
|Iron Ingot
|Iron Ingot
|300
|300
|4 hours
|30 minutes
|6 hours
|6 hours
|Overworld
|can only be used in the overworld
|-
|-
|Diamond
|Diamond
|2000
|2000
|4 hours
|12 hours
|2 days
|1 day
|Overworld
|can only be used in the overworld
|-
|-
|Nether Brick
|Nether Brick
|50
|50
|5 minutes
|30 minutes
|20 minutes
|30 minutes
|Nether
|can only be used in the nether
|-
|-
|Gold Ingot
|Gold Ingot
|300
|300
|4 hours
|30 minutes
|6 hours
|6 hours
|Nether
|can only be used in the nether
|-
|-
|Gilded Blackstone
|Gilded Blackstone
|2000
|2000
|4 hours
|12 hours
|2 days
|1 day
|Nether
|can only be used in the nether
|-
|-
|}
|}
|-|CivClassic 2.0=
|-|CivClassic 2.0=
{| class="wikitable"
{| class="wikitable sortable"
|+Reinforcement materials {{refn|group="Note"|name=bedrock}}
!Material
!Material
!Durability
!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 87: Line 92:
|-
|-
|}
|}
|-|Devoted 3.0=
</tabber>
{| class="wikitable sortable"

!Material
==== Notes ====
!Durability
<references group="Note" />
!Maturation time

!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
|750
|1 hour
|8 hours
|-
|Diamond
|3000
|10 hours
|36 hours
|-
|Bedrock
|3000000
|5 minutes
|5 minutes
|-
|}
</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]]
|CACTUS
|[[Citadel#Reinforce Mode|Reinforce Mode]]
|<code>/ctr [group]</code>
|-
|-
|[[Citadel#Fortify Mode|Fortify Mode]]
|SUGAR_CANE_BLOCK
|<code>/ctf [group]</code>
|-
|-
|[[Citadel#Easy Mode|Easy Mode]]
|RED_ROSE (Includes all single block tall flowers)
|<code>/cte</code>
|-
|-
|[[Citadel#Advanced Mode|Advanced Mode]]
|YELLOW_FLOWER
|<code>/cta [group]</code>
|-
|-
|[[Citadel#Patch Mode|Patch Mode]]
|BROWN_MUSHROOM
|<code>/ctp</code>
|-
|-
|[[Citadel#Normal Mode|Normal Mode]]
|RED_MUSHROOM
|<code>/cto</code>
|-
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|SAPLING
|[[Citadel#Insecure Mode|Insecure Mode]]
|<code>/ctin</code>
|-
|-
|[[Citadel#Info Mode|Info Mode]]
|LONG_GRASS
|<code>/cti</code>
|-
|-
|[[Citadel#Bypass Mode|Bypass Mode]]
|DEAD_BUSH
|<code>/ctb</code>
|}
|}


=== Reinforcement Modes ===


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


By default, players are in [[Citadel#Normal Mode|Normal mode]], which does not allow blocks to be reinforced.
There are several reinforcement modes which have different functionality when placing blocks. By default, you are in normal mode, which will not allow you to reinforce any blocks. To reinforce blocks, you must switch to a particular reinforcement mode.


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


The most common mode is reinforce mode, entered via <code>/ctr</code>. When in this mode, you can reinforce blocks by punching them with a reinforcement material.
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]].
=== Easy Mode ===


==== Fortify Mode ====
Use <code>/cte</code> or <code>/cteasy</code> to enter this mode. Easy mode is like a permanent reinforce mode - it acts like reinforce mode in that you can punch blocks with reinforcement materials to reinforce them, but it will not give you error messages whenever you punch blocks with an item that is not a reinforcement material. If you enter this mode and forget about it, be careful about punching things with valuable reinforcement materials like diamonds!
{{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.
=== Fortify Mode ===


<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 will reinforce all blocks placed with a specific reinforcement material while in fortify mode. To enter this mode, hold a reinforcement material in your hand and type <code>/ctf</code> or <code>/ctfortify</code>.


=== Advanced Mode ===
==== 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 is similar to fortify mode, but allows matching an arbitrary number of block types with different reinforcements. To enter this mode, hold a reinforcement material in your off hand and a block in your main hand, then type <code>/cta</code> or <code>/ctadvanced</code>. While in this mode, whenever a block of the selected block type is placed, it will be reinforced with the selected reinforcement material. Unlike fortify mode, only this block will be reinforced when placed, not all blocks.


==== Advanced Mode ====
You can repeat this process to assign as many block/reinforcement pairs as you want. This means that you could reinforce iron doors with diamond and obsidian with stone while in the same mode, for instance.
{{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.
All block/reinforcement pairs are forgotten when you exit out of advanced mode, and must be re-associated again whenever you re-enter advanced mode.


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.
== Toggle Modes ==


<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]].
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 ===
==== 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.
Insecure mode allows you to punch reinforced blocks to turn them to an "insecure" reinforcement. This mode is entered via <code>/ctin</code> or <code>/ctinsecure</code>. A container which is insecurely reinforced will allow hoppers to move items in and out of it, in contrast to a normally reinforced container, which will not.


=== Info Mode ===
==== 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.
To toggle this mode, type <code>/cti</code> or <code>/ctinfo</code>. When you punch a block while in this mode, information about the reinforcement of that block will be displayed. If the block is not reinforced, it will say so, and if it is reinforced it will tell you what the reinforcement material is and how much health it has left. If the block is reinforced to a group you have permissions on, the group name will also be displayed.


=== Bypass Mode ===
=== 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.
To toggle this mode, type <code>/ctb</code> or <code>/ctbypass</code>. This mode allows you to bypass reinforcements to a group you have permissions on. The reinforcement material will be returned when you break a block in bypass mode. Without this mode enabled, you will be forced to break blocks over and over again just like a normal player, even if the blocks are reinforced to a group you are a member of.


== Breaking ==
==== 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.
[[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.]]


==== Info 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>/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.
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.


=== Acid Block===
==== 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.
An acid block 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.


== Acid Block ==
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.
[[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.
Note that acid blocks do not gradually do damage to the block above them - they only have an effect once <code>/ctacid</code> has been run on them, and <code>/ctacid</code> will only work once the acid block is fully matured.


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>/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 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.

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]].
Acid blocks are often used to clean up [[Obsidian Bombs]].
Line 232: Line 376:


{| class="wikitable"
{| class="wikitable"
|+
|+Decay steps
!Decay state
!Decay state
!Inactivity
!Inactivity
Line 257: Line 401:
| >= 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==
Line 267: Line 413:
*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
!Alias
!Description
!Description
!Alias
|-
|-
! rowspan="2" |Info
|/ctfortify [groupname]
|<code>/help citadel [page]</code>
|/ctf
|Lists all Citadel commands.
|Toggles fortify mode
|{{n/a}}
|-
|-
|<code>/ctdl</code>
|/ctreinforce [groupname]
|Shows an interface of all reinforcement materials.
| /ctr
|{{n/a}}
|Toggles reinforce mode
|-
|-
! rowspan="5" |[[Citadel#Reinforcement Modes|Reinforcement Modes]]
|/ctadvanced [groupname]
|<code>[[Citadel#Fortify Mode|/ctf [group]]]</code>
| /cta
|Toggles advanced mode
|Enters fortify mode.
|<code>/ctfortify</code>
|-
|-
|<code>[[Citadel#Reinforce Mode|/ctr [group]]]</code>
|/cteasy [groupname]
|Enters reinforce mode.
| /cte
|<code>/ctreinforce</code>
|Toggles easy mode
|-
|-
|<code>[[Citadel#Advanced Mode|/cta [group]]]</code>
|/ctinfo
|Enters advanced mode.
|/cti
|<code>/ctadvanced</code>
|Toggles info mode
|-
|-
|<code>[[Citadel#Normal Mode|/cto]]</code>
|/ctoff
|Enters normal mode.
|/cto
|<code>/ctoff</code>
|Turns off all reinforcement and information modes
|-
|-
|<code>[[Citadel#Easy Mode|/cte [group]]]</code>
|/ctacid
|Enters easy mode.
|
|<code>/cteasy</code>
|Activates an acid block
|-
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|/ctbypass
|<code>[[Citadel#Info Mode|/cti]]</code>
|/ctb
|Toggles bypass mode
|Toggles info mode.
|<code>/ctinfo</code>
|-
|-
|<code>[[Citadel#Bypass Mode|/ctb]]</code>
|/ctinsecure
|Toggles bypass mode.
|/ctin
|<code>/ctbypass</code>
|Toggles insecure mode
|-
|-
|<code>[[Citadel#Insecure Mode|/ctin]]</code>
|/ctdl
|Toggles insecure mode.
|
|<code>/ctinsecure</code>
|List all possible materials you can reinforce with, in a GUI
|-
|-
![[Citadel#Acid Block|Acid Block]]
|/help Citadel
|<code>/ctacid</code>
|
|Activates an acid block.
|List all commands
|{{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.
* Reinforce leaf blocks and destroying the tree they are apart of will lead to loss of reinforcement.
|-
* It is possible to double reinforce a double chest by placing it while using <code>/ctf</code>.
!'''June 2, 2022'''
|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==
==References==
<references />
<references />
{{Template:Mechanics}}
{{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"