Leukocyte

Leukocyte is a simple yet powerful world protection mod for Minecraft, specifically designed for Fabric. It offers a flexible player rights management system with optional integration with the player-roles modification.

Basic Principles

The core of Leukocyte's protection system is based on the concept of "authorities" - special zones that apply specific rules to players. Each authority has a unique name, priority level, and list of player exclusions.

Creating Authorities

To create an empty authority, use the command: /protect add <name>

You can also create an authority for a specific area:

• /protect add <name> with universe (applies everywhere)
• /protect add <name> with <dimension> (works in a specific dimension)
• /protect add <name> with <min> <max> (operates in a cuboid between two coordinates)

Remove an authority with: /protect remove <name>

Setting Rules

The mod provides a wide range of rules that can be applied within authorities:

• break - ability to break blocks
• place - ability to place blocks
• block_drops - item drops when breaking blocks
• interact_blocks - interaction with blocks
• interact_entities - interaction with entities
• interact - general interaction with blocks and entities
• attack - attacking other entities
• pvp - attacking other players
• portals - creating portals
• crafting - crafting items
• fall_damage - receiving fall damage
• hunger - hunger depletion
• throw_items - throwing items from inventory
• pickup_items - picking up items by players and entities
• unstable_tnt - automatic TNT ignition
• ignite_tnt - ability to ignite TNT
• spawn_withers - summoning Withers
• fire_tick - fire spread
• fluid_flow - fluid flow
• ice_melt - ice melting

To set a rule, use: /protect set rule <authority> <rule> <result>

Creating Complex Shapes

To protect territories with complex shapes, you can combine multiple simple shapes. Start with /protect shape start, then add primitives:

• /protect shape add universe - add the entire universe
• /protect shape add <dimension> - add a dimension
• /protect shape add <min> <max> - add a cuboid

Finish shape creation with: /protect shape finish <name> to <authority>

Priority Levels

When multiple authorities exist, you can set their priority using levels. A higher level means greater priority. Set the level with: /protect set level <authority> <level>

Exclusions

You can exclude specific players or roles from authority rules:

• /protect exclusion add <authority> player <name>
• /protect exclusion add <authority> role <name>

Practical Example

Imagine a server with global grief protection, except in the survival dimension and special building zones.

Create a global authority:

/protect add global with universe
/protect set rule global place deny
/protect set rule global break deny
/protect set level global -1

Allow building in the survival dimension:

/protect add survival with example:survival
/protect set rule survival place allow
/protect set rule survival break allow

Create free building zones:

/protect add free_build
/protect set rule free_build place allow
/protect set rule free_build break allow
/protect shape start
/protect shape add -10 0 -10 10 255 10
/protect shape finish free_build_1 to free_build
/protect shape start
/protect shape add -100 0 -10 90 255 10
/protect shape finish free_build_2 to free_build
/protect exclusion add free_build role free_build_banned

Testing and Debugging

To check protection functionality, use commands:

• /protect test - check rules at current location
• /protect list - list all authorities
• /protect display <authority> - information about specific authority