Citadel

From CivWiki
Jump to navigation Jump to search

Citadel is an 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.

Reinforced blocks

Example of a reinforced block being broken. The block break animation plays and the block breaks but because it is reinforced, the block reappears.

While normal (unreinforced) blocks only need to be broken once, reinforced blocks must be repeatedly broken before the block actually breaks. 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 consumes as much durability as a regular block.

Similarly, reinforced blocks broken by explosions do not break but instead receive the same damage they would if broken once by a player (Decay and Maturation multipliers are applied)

Unlike normal blocks some reinforced blocks such as chests and doors can only be used by those with appropriate permissions on the group it's reinforced to

Reinforcing

The most common method of reinforcing is running /ctr, 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.

There are other reinforcement modes which afford different methods of reinforcing blocks other than punching it - see #Reinforcement Modes.

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.

Reinforced blocks are not affected by gravity (e.g. reinforced sand will float, even without blocks under it).

In vanilla minecraft, some blocks such as buttons, rails, and doors break when the block under them is broken. This behavior is still present even when the top block is reinforced. This means that if you reinforce a door or rails, you should always reinforce the block under them as well, or someone can break the block under the reinforced block once instead of breaking the reinforcement many times.

Reinforcing naturally grown leaf blocks and breaking the tree they are connected to will result in the leaves decaying normally, without respecting the reinforcement.

Materials

Reinforcement materials [Note 1]
Material Breaks to destroy Maturation time Acid maturation Notes
Stone 50 5 minutes 20 minutes only usable in overworld
Iron Ingot 300 30 minutes 6 hours only usable in overworld
Diamond 2000 4 hours 2 days only usable in overworld
Nether Brick 50 5 minutes 20 minutes only usable in the nether
Gold Ingot 300 30 minutes 6 hours only usable in the nether
Gilded Blackstone 2000 4 hours 2 days only usable in the nether
Reinforcement materials [Note 1]
Material Breaks to destroy Maturation time Acid maturation
Paper [Note 2] 1 1 minutes 1 minutes
Stone 50 5 minutes 20 minutes
Iron Ingot 300 30 minutes 6 hours
Diamond 2000 4 hours 2 days

Notes

  1. 1.0 1.1 There also exists a bedrock reinforcement that takes 147483646 breaks to destroy, accessible only to server operators.
  2. Patreon reward paid by wjkroeker[1]

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.

Non reinforceable blocks
Block name
BEDROCK
END_GATEWAY
END_PORTAL_FRAME
END_PORTAL
PISTON_EXTENSION
PISTON_MOVING_PIECE
TNT
FIRE
SNOW (only layers of snow, the full block can be reinforced)
ICE (only normal ice)
PORTAL
CAKE_BLOCK
WEB
Any plant
Non reinforceable plants
Block name
CROPS
CARROT
POTATO
NETHER_WARTS
VINE
CACTUS
SUGAR_CANE_BLOCK
RED_ROSE (Includes all single block tall flowers)
YELLOW_FLOWER
BROWN_MUSHROOM
RED_MUSHROOM
SAPLING
LONG_GRASS
DEAD_BUSH


Reinforcement Modes

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.

Mode Command Functionality
Fortify /ctf [group] Enters fortify mode with the reinforcement material held (or fails if not holding any). While on, automatically reinforce blocks placed on [group] or your default group with the selected material. Fortify mode exits when a reinforcement is failed. Allows reinforcing both sides of a double chest
Reinforce /ctr [group] Enters reinforcement mode. On reinforcement mode reinforce blocks on [group] or your default group by punching or right clicking them with a reinforcement material
Easy /cte Enters easy reinforcement mode. On easy reinforce you can hold a reinforcement material on your off-hand and fortify blocks you place on your default group. You can also hold the reinforcement material on your main-hand and punch blocks to reinforce them on your default group, unlike ctr 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
Advanced /cta [group] Enables fortifying the block held in your main hand with the material held in your off-hand on [group]. Behaves like fortify mode while allowing you to choose individual groups and different reinforcements (or, by default, none) for each individual block type
Patch /ctp 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.
Normal /cto Exits any reinforcement mode. By default also disables information mode if enabled but this can be changed in /config

Reinforce Mode

The most common mode is reinforce mode, entered via /ctr. When in this mode, you can reinforce blocks by punching them with a reinforcement material.

Easy Mode

Use /cte or /cteasy 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!

Fortify Mode

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 /ctf or /ctfortify.

While double chests can normally only be reinforced once, it is possible to reinforce both blocks of a double chest by placing both chests while in fortify mode.

Advanced Mode

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 /cta or /ctadvanced. 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.

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.

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.

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

Insecure mode allows you to punch reinforced blocks to turn them to an "insecure" reinforcement. This mode is entered via /ctin or /ctinsecure. 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

To toggle this mode, type /cti or /ctinfo. 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

To toggle this mode, type /ctb or /ctbypass. 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.

Acid Block

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 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 /ctacid 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 /ctacid has been run on them, and /ctacid will only work once the acid block is fully matured.

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

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

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]


Commands

Citadel commands
Usage Alias Description
/ctfortify [groupname] /ctf Toggles fortify mode
/ctreinforce [groupname] /ctr Toggles reinforce mode
/ctadvanced [groupname] /cta Toggles advanced mode
/cteasy [groupname] /cte Toggles easy mode
/ctinfo /cti Toggles info mode
/ctoff /cto Turns off all reinforcement and information modes
/ctacid Activates an acid block
/ctbypass /ctb Toggles bypass mode
/ctinsecure /ctin Toggles insecure mode
/ctdl List all possible materials you can reinforce with, in a GUI
/help Citadel List all commands

Known bugs

  • 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