Citadel

From CivWiki
Revision as of 06:37, 22 December 2022 by Red Steel (talk | contribs) (→‎Reinforcement Modes: WATCH ME ABUSE HATNOTES FOR ABSOLUTELY NO REASON)
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 breaks as normal. However it continues to reappears until the durability of it's reinforcement is depleted.

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 (Decay and Maturation multipliers are applied).

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.

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

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

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

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.

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.

Fortify mode

The command must be run while holding a reinforcement material or it will fail. While in fortify mode blocks placed are automatically reinforced to the selected 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 mode

On reinforcement mode you can reinforce blocks to the selected group 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

Easy mode

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

Advanced mode

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.

Patch mode

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 mode

Exits any reinforcement mode. By default also disables information mode if enabled but this can be changed in /config

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