# Yet Another World Protector<\/p>\n
Yet Another World Protector (YAWP) is _the_ admin tool to protect your minecraft server (dedicated or LAN as well as single-player!). It’s available for (Neo-) Forge and Fabric.<\/p>\n
YAWP designed to be used on dedicated servers, but can also be used in single player worlds and worlds opened to LAN.
\nIt allows admins (and players with assigned permission) to protect their creations against various events\/actions of
\nplayers, mobs and
\nthe environment.<\/p>\n
Create regions for your builds and apply region flags to protect them.
\nAssign players or vanilla teams to regions, so they can manage their own regions.<\/p>\n
YAWP was inspired by the forge mod WorldProtector and
\nthe WorldGuard plugin.<\/p>\n
Join our discord if you have any questions or suggestions: YAWP Discord<\/p>\n
***<\/p>\n
| Discord | Paypal | Patreon | Github | Wiki | Issues | Curseforge | Modrinth |
\n|:—————————————-:|:———————————————————————–:|:—————————————–:|:—————————————————————:|:——————————————————————:|:———————————————————————-:|:—————————————————————:|:—————————————–:|<\/p>\n
*** <\/p>\n
<\/p>\n
***The mod is currently in its beta state, with many features not yet implemented but to come. These features will
\ninclude most of the things you know from WorldProtector and WorldGuard.***<\/p>\n
This mod will be released for Minecraft versions 1.16.5+. If you are living in the past and are looking for a version for Minecraft 1.12.2, I suggest looking into using WorldDefender.<\/p>\n
Starting with Minecraft **1.20.4**, YAWP will no longer be available for Forge and adapt **NeoForge** instead.<\/p>\n
***
\n<\/p>\n
In YAWP there are three different kinds of regions to protect your server:<\/p>\n
## *The* Global Region<\/p>\n
The Global Region is… well global. Flags set in the Global Region, apply to all dimensions of the server and thus all
\nLocal Regions.<\/p>\n
## Dimensional Regions<\/p>\n
Dimensional Regions are special regions which are tied to one dimension – like gamerule-flags for different dimensions.<\/p>\n
Dimensional Regions have no spatial restrictions in the corresponding dimension. Dimensional Regions work like normal
\nregions, but are tied to a dimension.<\/p>\n
They can’t be created manually. They are in fact automatically generated with each new dimension. The first Dimensional
\nRegion for the overworld is created when the server is created.<\/p>\n
The following Dimensional Regions are created whenever a player travels to a new dimension, thus creating the new
\ndimension with their respective Dimensional Region. Modded dimensions are supported as well.<\/p>\n
## Local Regions<\/p>\n
Local Regions are the regions you most likely now from WorldGuard or WorldProtector. They have a defined area in which
\nthey work in and which they are limited to.<\/p>\n
With Local Regions you are able to create areas in your world, which you want to protect from certain actions\/events
\nwhich are caused by players, other entities or the environment.<\/p>\n
To create a Local Regions you will need to have the permission of the parent region or permission from the config.<\/p>\n
Local Regions can be created
\nby marking the area with a RegionMarker and executing the corresponding command or by just using a command without the
\nRegionMarker.<\/p>\n
For now the area of a region can be defined as in a cuboid or spherical shape, but I am planning to add more shapes for
\nregion areas in future updates.<\/p>\n
***<\/p>\n
## Properties of regions<\/p>\n
The properties of regions, flags, groups, etc. can all be managed through
\nan interactive CLI.<\/p>\n
The colored text indicates interactive shortcuts commands or command suggestions. All colored text have a tooltip hint
\nwhich explains shortly what clicking on the corresponding link does.<\/p>\n
Clicking on them gives the player a suggestion for executing a command or sometimes straight execute the command which
\nis hinted by the hover text.<\/p>\n
Regions can only be managed by their owners, or by players which have the required OP level or have an entry in the
\nconfiguration. For more information, visit the wiki.<\/p>\n
***<\/p>\n
<\/p>\n
Whenever a new Local Region is created without supplying a parent region, the parent is set to the Dimensional Region
\nwhich the new Local Region is created in.<\/p>\n
Local Regions can also have child regions. The children of a Local Regions need to be contained in the area of the
\nparent region. The region hierarchy also defines the region priorities. Child regions always must have a higher priority
\nthan their parent.<\/p>\n
Dimensional Regions always have the Global Region as a parent, and thus the Global Region all Dimensional Regions as
\nchild regions.<\/p>\n
***<\/p>\n
<\/p>\n
Regions have owners and normal members. Owners are allowed to manage the region and bypass the flags, members are
\nonly allowed to bypass the flags set in the region.<\/p>\n
Owners and Members can be individual players or a team.<\/p>\n
Groups allow you assign specific region permissions to different players and teams. Currently, there are only two
\ndefault groups: **owners** and **members**.<\/p>\n
***<\/p>\n
<\/p>\n
– **Owners** can manage their region themselves and add other players\/teams to the region. They can also create their
\n own sub-regions within their region, manage flags, ect. and of course owners bypass flags.<\/p>\n
– **Members** are only allowed to bypass flags only.<\/p>\n
I am planning on adding a LuckPerms integration with a future
\nupdate, so you can define your own groups and permissions.<\/p>\n
If you have trouble with setting up regions, visit the discord for help.<\/p>\n
*** <\/p>\n
<\/p>\n
Flags are the core of the region protection system. They define which actions are allowed or denied in a region. Flags
\ncan be set to<\/p>\n
– **Allowed**, to allow the corresponding action,
\n– **Denied**, to deny the corresponding action,
\n– **Disabled**, to disable the specific flag for flag checks.<\/p>\n
Child regions inherit the flags from their parent regions. It is further possible to override the flag state for child
\nregions by setting the **override** property of the flag of the parent region accordingly.<\/p>\n
See the Flags page for more details about the
\ndifferent flags.<\/p>\n
I am planning to add more flag in the future. A list of suggested flags which I’ll slowly add to the mod can be found
\nhere: Flag suggestions<\/p>\n
There will also be more complex flags in the future. Like *ListFlag* which will allow you to define a list of allowed
\nblocks\/entities\/.. which are forbidden in the context of a flag.<\/p>\n
***<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
*** <\/p>\n
<\/p>\n
The commands of mod are also designed to be used by the server console and can be executed by command blocks.<\/p>\n
This allows you to automate region setups, add\/remove players, enable or disable regions, etc.
\n***<\/p>\n
<\/p>\n
YAWP provides a growing mod integration API for easier mod and modpack integration. Currently, the API allows other mods
\nto listen for events for region creation, changes and deletion and cancel these events to prevent them from happening.<\/p>\n
Additionally, there are events for flag checks and their results, which can be used to manipulate the outcome of the
\nflag check.<\/p>\n
***<\/p>\n
\nThe client side installation of the mod provides language support (I18n) in form of a resource pack. Currently, english,
\ngerman and russian language is supported.<\/p>\n
Starting with mod version 0.0.2.9-beta2 and Minecraft Version 1.19.4, YAWP provides a default english translation.<\/p>\n
If your language is not yet supported, feel free to reach out to me via discord or issue a pull request via github! \ud83d\ude42<\/p>\n
***<\/p>\n
<\/p>\n
The configuration of the mod allows you to control which is allowed to use the mod, sets default flags for Local and
\nDimension Regions, command line interface options, etc.<\/p>\n
The configuration is split in different files, covering different topics.<\/p>\n
– `yawp-common.toml` – config for command permissions
\n– `yawp-flags.toml` – config for flags, custom flag messages, etc
\n– `yawp-region-defaults.toml` – config for default region properties<\/p>\n
Since YAWP is a server-side mod, the config for it is found in the directory `\/serverconfig` in your minecraft world
\ndirectory.<\/p>\n
*** <\/p>\n
<\/p>\n
The documentation of the mod is small but growing. I am trying to keep up with the content. You can find the
\ndocumentation << here >>.<\/p>\n
The documentation covers<\/p>\n
* descriptions of different regions
\n* getting started & FAQ
\n* available commands & flags
\n* configuration
\n* and more …<\/p>\n
If something is not covered feel free to hop on our discord server and ask your question there. \ud83d\ude42
\n___<\/p>\n
## Roadmap<\/p>\n
There are many more features to come. The mod is in active development!
\nThe following list is not comprehensive.<\/p>\n
* Different flag types (List, Effect, …) for more granular control Yet Another World Protector, or YAWP for short, is a server-side mod which allows you to protect your creations against various different events\/actions of players, mobs and the environment. <\/p>\n","protected":false},"featured_media":172935,"template":"","meta":{"_minecraft_slug":"yawp","_minecraft_project_id":"py6EMmAJ","_minecraft_author":"Z0rdak","_minecraft_license":"AGPL-3.0-only","_minecraft_downloads":213443,"_minecraft_follows":204,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yawp.zip","_minecraft_size_bytes":106948304,"_minecraft_version_count":134,"_minecraft_updated_at":"2026-05-16T20:28:42.858216Z","_minecraft_date_created":"2022-08-28T19:37:11.041141Z","_minecraft_date_modified":"2026-05-03T19:55:38.369181Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yawp","_minecraft_icon_attachment_id":172935,"_minecraft_imported_at":"2026-06-09T22:28:01+00:00","_minecraft_import_hash":"b8a08cffc46965c294b184552178795c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,126,158,867,92],"mod_loader":[106,160],"minecraft_version":[48,53,56,57,58,59,36,60,94,62,37,40,41,38,78,79,80,81,83,163],"class_list":["post-172934","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-social","mod_category-utility","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-16-5","minecraft_version-1-18-2","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-4","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-26-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n* Data pack driven flag configuration
\n* Region boundary visualization
\n* Define your own region groups for more granular management of regions (LuckPerms)
\n* More granular permission system (combined with the more granular group features)
\n* Region templates for easier managing same regions with different spatial properties
\n* Region triggers for entering\/leaving a region (for displaying messages, executing commands, etc)*
\n* Regions with different shapes (Cylinder, Prism, 3DPolygon)*
\n*