Citadel: Difference between revisions

From CivWiki
Jump to navigation Jump to search
Content added Content deleted
VisualWikitext
m (Changed maturation times and acid block maturation times of reinforcements on CivMC to match the updated times)
 
(60 intermediate revisions by 4 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 [https://github.com/CivMC/Citadel open source] plugin which allows blocks to be reinforced, making them from tens to thousands of times harder and denying interaction. Reinforcements are tied to a [[Namelayer]] group and can be bypassed and interacted with by players with permission on that group. Some blocks from other civ plugins such as [[Snitches]] and [[Bastions]] only become active once reinforced.
{{Featured article}}
== Reinforced blocks ==
{{Mechanics series}}
[[File:Citadel block break animation.gif|thumb|305px| '''Example of a reinforced block being broken.''' The block breaks as normal. However it continues to reappears until the durability of it's reinforcement is depleted.]]
'''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.
While normal (unreinforced) blocks only need to be broken once, reinforced blocks must be repeatedly broken before the block actually breaks. Similarly, reinforced blocks broken by explosions do not break but instead receive the same damage they would if broken once by a player ([[Citadel#Decay|Decay]] and [[Citadel#Maturation|Maturation]]<!-- TODO: maturation section --> multipliers are applied).


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.
Tool durability does not decrease when breaking reinforcements, only when performing the final break which will actually break the block. This means breaking a reinforced block consumes as much durability as breaking a regular block.


First introduced in [[Civcraft]], Citadel has been included in every [[mainline]] civ server since.
Unlike normal blocks some reinforced blocks such as chests and doors <!-- TODO: make a list somewhere in this article --> can only be used by those with appropriate permissions on the group it's reinforced to


== Mechanics ==
Reinforced blocks also protect crops and plants on it from unauthorized harvest. For example, reinforced farmland will prevent wheat growing on it from being broken in a single hit. But the reinforcement of the crop will be shared with the block, and damaging one will damage both


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.
Reinforced blocks are not affected by gravity (e.g. reinforced sand will float, even without blocks under it). However reinforcements will not prevent blocks that break when unsupported such as doors, rails, buttons, or torches from breaking as such, nor natural leaves from decaying


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


=== Reinforcement Materials ===
There are several reinforcement modes which have different functionality. By default, you are in normal mode, which will not allow you to reinforce any blocks. To reinforce blocks, you must switch to a reinforcement mode.
{{glossary}}
{{term|Fortify mode}}
{{Hatnote|Command: /ctf [group]}}
{{defn|The command must be run while holding a [[Citadel#Materials|reinforcement material]] or it will fail. While in fortify mode blocks placed are automatically reinforced to the selected <code>group</code> or your default group with the selected material. Fortify mode exits when a reinforcement is failed. Allows reinforcing both sides of a double chest}}

{{term| Reinforce mode}}
{{Hatnote|Command: /ctr [group]}}
{{defn|On reinforcement mode you can reinforce blocks to the selected <code>group</code> or your default group by punching or right clicking them with a reinforcement material, note that this mode will prevent you from breaking or interacting with blocks normally}}

{{term|Easy mode}}
{{Hatnote| Command: /cte}}
{{defn|Unlike other modes this only allows reinforcing to your default group. On easy reinforce you can hold a reinforcement material on your off-hand and automatically reinforce blocks you place with it, or hold the reinforcement material on your main-hand and punch blocks to reinforce them. Unlike Reinforce mode this won't generate warnings when attempting to interact with blocks without a reinforcement material, letting you leave it on. However, doing so may lead to accidental reinforcement}}

{{term|Advanced mode}}
{{Hatnote| Command: /cta [group]}}
{{defn|The command must be run while holding the type of block you intend to reinforce in your mainhand and a reinforcement material in your offhand, you may do so again to add more targeted block types. Advanced mode behaves like fortify mode while allowing you to choose individual groups and different reinforcement types (or, by default, none) for each type block there is.}}

{{term|Patch mode }}
{{Hatnote| Command: /ctp}}
{{defn|Repairs damaged reinforced blocks interacted (left or right click) with if you have the reinforcement material in your inventory. The chance of consuming the material is proportional to how damaged the block is.}}

{{term|Normal mode }}
{{Hatnote| Command: /cto}}
{{defn|Exits any reinforcement mode. By default also disables information mode if enabled but this can be changed in /config}}
{{glossary end}}
=== 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
|30 minutes
|30 minutes
|30 minutes
|2 hours
|Overworld
|only usable in overworld
|-
|-
|Iron Ingot
|Iron Ingot
|300
|300
|4 hours
|4 hours
|12 hours
|6 hours
|Overworld
|only usable in overworld
|-
|-
|Diamond
|Diamond
|2000
|2000
|12 hours
|12 hours
|24 hours
|1 day
|Overworld
|only usable in overworld
|-
|-
|Nether Brick
|Nether Brick
|50
|50
|30 minutes
|30 minutes
|30 minutes
|2 hours
|Nether
|only usable in the nether
|-
|-
|Gold Ingot
|Gold Ingot
|300
|300
|4 hours
|4 hours
|12 hours
|6 hours
|Nether
|only usable in the nether
|-
|-
|Gilded Blackstone
|Gilded Blackstone
|2000
|2000
|12 hours
|12 hours
|24 hours
|1 day
|Nether
|only usable 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 119: 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
|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>
|}
|}


== Toggle Modes ==
=== Reinforcement Modes ===

These modes change the mechanism by which players reinforce blocks.

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.
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 ===
==== Insecure Mode ====
{{hatnote|<code>/ctin</code>}}


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.
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 ===
==== Info Mode ====
{{hatnote|<code>/cti</code>}}


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.
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 ===
==== Bypass Mode ====
{{hatnote|<code>/ctb</code>}}


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


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


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

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


{| class="wikitable"
{| class="wikitable"
|+
|+Decay steps
!Decay state
!Decay state
!Inactivity
!Inactivity
Line 256: 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 266: 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
|<code>/help citadel [page]</code>
|Lists all Citadel commands.
|{{n/a}}
|-
|<code>/ctdl</code>
|Shows an interface of all reinforcement materials.
|{{n/a}}
|-
! rowspan="5" |[[Citadel#Reinforcement Modes|Reinforcement Modes]]
|<code>[[Citadel#Fortify Mode|/ctf [group]]]</code>
|Enters fortify mode.
|<code>/ctfortify</code>
|-
|<code>[[Citadel#Reinforce Mode|/ctr [group]]]</code>
|Enters reinforce mode.
|<code>/ctreinforce</code>
|-
|<code>[[Citadel#Advanced Mode|/cta [group]]]</code>
|Enters advanced mode.
|<code>/ctadvanced</code>
|-
|<code>[[Citadel#Normal Mode|/cto]]</code>
|Enters normal mode.
|<code>/ctoff</code>
|-
|<code>[[Citadel#Easy Mode|/cte [group]]]</code>
|Enters easy mode.
|<code>/cteasy</code>
|-
! rowspan="3" |[[Citadel#Toggle Modes|Toggle Modes]]
|<code>[[Citadel#Info Mode|/cti]]</code>
|Toggles info mode.
|<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}}
|}

== 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).
|-
!'''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'''
|/ctfortify [groupname]
|Server launches with Citadel.
|/ctf
|Toggles fortify mode
|-
|-
! colspan="2" |[[CivClassic 2.0]]
|/ctreinforce [groupname]
| /ctr
|Toggles reinforce mode
|-
|-
!June 2, 2017
|/ctadvanced [groupname]
|Server launches with Citadel.
| /cta
|Toggles advanced mode
|-
|-
! colspan="2" |[[Devoted 3.0]]
|/cteasy [groupname]
| /cte
|Toggles easy mode
|-
|-
!September 17, 2016
|/ctinfo
|Server launches with Citadel.
|/cti
|Toggles info mode
|-
|-
! colspan="2" |[[Civcraft 3.0]]
|/ctoff
|/cto
|Turns off all reinforcement and information modes
|-
|-
!July 30, 2016
|/ctacid
|Server launches with Citadel.
|
|Activates an acid block
|-
|-
! colspan="2" |[[Civcraft 2.0]]
|/ctbypass
|/ctb
|Toggles bypass mode
|-
|-
!May 19, 2013
|/ctinsecure
|Server launches with Citadel.
|/ctin
|Toggles insecure mode
|-
|-
! colspan="2" |[[Civcraft 1.0]]
|/ctdl
|
|List all possible materials you can reinforce with, in a GUI
|-
|-
!March 24, 2012
|/help Citadel
|Server launches with Citadel.
|
|List all commands
|}
|}


==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"