Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt

Use this file to discover all available pages before exploring further.

The Protection Extension provides a robust and flexible alternative to traditional land claim plugins. It allows for the creation of intricate zones with specific rules (Flags) governing player behavior, environmental events, and mob mechanics.

Source Code

View source on GitHub.

Download Releases

Get the latest JARs.

Features

Geometric Regions

Support for Cuboid, Cylinder, and Polygon (Prism) shapes.

Hierarchical Priority

Regions can overlap, with higher priority zones overriding lower ones.

Inheritance System

Child regions can inherit flags from parent regions or override them.

Comprehensive Flags

Over 60 flags for build permissions, PvP, mob spawning, and more.

Entries

Core Elements

Region Definition

Defines the shape, priority, and default flags for a zone.

Region Artifact

Stores the specific coordinates and owner/member data.

Global Artifact

Manage world-wide protections and behaviors.

Events & Logic

Enter/Exit Region

Triggers logic when a player crosses a region border.

In Region Fact

Checks if a player is currently within specific protected zones.

Region Audience

Displays persistent visual or audio content to everyone inside the zone.

Commands

All commands are under the /protection prefix (aliases: /pt, /region).
CommandDescriptionPermission
/protection listList all active regions and their prioritiestypewriter.protection
/protection edit <id>Enter selection mode for a specific regiontypewriter.protection
/protection applySave your current selection and finalize regiontypewriter.protection
/protection info <id>View technical details and location of a regiontypewriter.protection
/protection flags <id>Analyze the effective, inherited, and blocked flagstypewriter.protection
/protection inspectToggle debug visualizers for region boundariestypewriter.protection
/protection import-we <id>Import current WorldEdit selection to a regiontypewriter.protection

Placeholders

All placeholders use the prefix %typewriter_regions:%.
PlaceholderDescription
%typewriter_regions:count%Number of regions the player is currently inside
%typewriter_regions:list%Comma-separated list of active region IDs
%typewriter_regions:primary:name%Name of the highest priority region at current location
%typewriter_regions:flag:<flag_id>%The effective value of a specific flag (e.g., pvp)
%typewriter_regions:has:<id1>,<id2>%true if player is in any of the specified regions
%typewriter_regions:active:<index>:id%ID of the N-th region in the stack

External Dependencies

ExtensionTypeFunctionality
FastAsyncWorldEditOptionalRegion selection and geometric operations.
MythicMobsOptionalAdvanced mob spawning control in regions.
BtcMobsOptionalAdvanced mob spawning control in regions.