Leukocyte

# Leukocyte Leukocyte is a simple world protection mod for Fabric providing optional integration with (https://github.com/Gegy/player-roles/). The basis of world protection with leukocyte is an "authority". An authority is responsible for applying specific rules to players within it. An authority has a unique name, as well as a priority ("level"), and set of player exclusions. ### creating authorities To create an empty authority, run: `/protect add <name>`. Alternatively, an authority can be created to apply within a specific area like: - `/protect add <name> with universe` (applies universally) - `/protect add <name> with <dimension>` (applies within a specific dimension) - `/protect add <name> with <min> <max>` (applies within a cuboid between two block coordinates) An authority can be later removed with `/protect remove <name>`. ### setting rules Leukocyte provides various rules that can be applied within authorities. These rules are: - `break` controls whether players can break blocks - `place` controls whether players can place blocks - `block_drops` controls whether blocks drop items when broken - `interact_blocks` controls whether players can interact with blocks - `interact_entities` controls whether players can interact with entities - `interact` controls global interaction over blocks and entities - `attack` controls whether players can attack other entities - `pvp` controls whether players can attack other players - `portals` controls whether players can construct portals - `crafting` controls whether players can craft items - `fall_damage` controls whether players should receive fall damage - `hunger` controls whether players will become hungry - `throw_items` controls whether players can throw items from their inventory - `pickup_items` controls whether items can be picked up by players or other entities - `unstable_tnt` controls tnt automatically igniting when placed - `ignite_tnt` controls whether tnt can be ignited - `spawn_withers` controls whether withers can be summoned - `fire_tick` controls whether fire tick is enabled within the authority. Defaults to gamerule if not set - `fluid_flow` controls whether fluids flow - `ice_melt` controls whether ice and frosted ice melt To set a rule as `allow` or `deny` on an authority, use `/protect set rule <authority> <rule> <result>`. For example: `/protect set example place deny` will disallow block placement within the authority named `example`. ### making shapes Often, you may want to protect an area with a weird shape that is not just a simple box. To achieve this, it is possible to combine multiple simple shapes into a more complex one which will be used to apply rules. To start, run: `/protect shape start`. This will begin the construction of a shape. Next, to add primitives to this shape, run: - `/protect shape add universe` to add the universe into this shape - `/protect shape add <dimension>` to add a dimension into this shape - `/protect shape add <min> <max>` to add a cuboid between two block coordinates into this shape These commands can be run multiple times to compose your shape. Once you have finished composing a shape, you can run: `/protect shape finish <name> to <authority>`. This will add a shape with the given name to the given authority. This shape can be removed in the future with `/protect shape remove <name> from <authority>`. ### setting levels When dealing with multiple authorities, you may want one to take priority over another. For example, you may want a global authority to disallow griefing everywhere *except* specific areas for building. This is where levels come in: a level is just any number, where a higher level indicates higher priority, and a lower level indicates lower priority. Given an authority with a level of -1, an overlapping authority with a level of 10 will override the rules of the first. Levels can be set on an authority with: `/protect set level <authority> <level>`. ### adding exclusions It may not be desirable for the rules of an authority to apply to everyone. In this case, it is possible to exclude specific players, or entire (https://github.com/Gegy/player-roles/) from being affected by a given authority. This is achieved through running: `/protect exclusion add <authority> player <name>` or `/protect exclusion add <authority> role <name>`. These exclusions can additionally be later removed with `/protect exclusion remove`. ### putting it together: an example That was a lot of things! Let's put this knowledge together on a simple example. Our example server will want to have global grief protection, except in our survival dimension and free-build areas. We additionally want to be able to exclude certain players from building in the free-build areas by use of a role. Let's consider the two dimensions: `minecraft:overworld` and `example:survival`, as well as the role `builders`. First, let's create an authority named `glo