ClearOnWorldGuard/README.md

# Clear on WorldGuard

This plugin will clear a player's items when they enter or leave, or teleport to or from one of the configured regions.
This is mainly useful if players are able to temporarily go in creative mode in specific WorldGuard regions. A lot of
additional things are blocked within clear regions in order to prevent creative mode abuse, such as: projectiles, XP
bottle usage, spawn egg usage, changing the mob in a spawner, dropping items, picking up items, breaking, placing or
interacting with blocks across clear region borders, block drops, mob drops, pistons pushing or pulling across clear
region borders, dispenser dispensers, droppers, armor dispensing, blocks burning, blocks igniting (except flint and
steel), creepers exploding, TNT priming and keeping any inventory items if dying within a clear area. This list might
not be exhaustive.

## Dependencies

- WorldGuard

## Configuration

Add the identifier (name or UUID) of the world you want to specify a region for as a sub-key of clearRegions. Make sure
your world identifier is a string list "worldName: []", and add any regions you want to enable inventory clearing for to
the list of the world the region belongs to.

Example config:

```yaml
clearRegions:
  world:
    - "creative_building"
    - "clear"
```

or

```yaml
clearRegions:
  world: [ "creative_building", "clear" ]
```
Adds README 2023-12-17 03:59:36 +01:00			`# Clear on WorldGuard`

Adds a bunch of event cancellations Blocks dropping items in a clear region Blocks usage of XP bottles in a clear region Block TNT priming in a clear region Blocks placement of blocks across clear region borders Blocks breaking of blocks across clear region borders Blocks blocks inside clear regions from dropping items. Prevents keeping inventory on death when in a clear region, and makes sure players' inventory is cleared upon death in a clear region, to avoid the potential of players outside the region picking up the items. Prevents picking up items in a clear region Prevents pistons from extending if it would push blocks across clear region borders Prevents pistons from retracting if it would pull blocks across clear region borders Prevents interacting with items across the clear region border Prevents changing the mob inside spawners in clear regions Prevents the usage of spawn eggs in clear regions Changes Java version to 16 2024-01-09 23:47:53 +01:00			`This plugin will clear a player's items when they enter or leave, or teleport to or from one of the configured regions.`
			`This is mainly useful if players are able to temporarily go in creative mode in specific WorldGuard regions. A lot of`
			`additional things are blocked within clear regions in order to prevent creative mode abuse, such as: projectiles, XP`
			`bottle usage, spawn egg usage, changing the mob in a spawner, dropping items, picking up items, breaking, placing or`
Adds some more listeners Prevents creepers from exploding in clear regions Prevents dispensers from dispensing in clear regions Prevents droppers from dropping in clear regions Prevents blocks from burning in clear regions Prevents blocks from igniting in clear regions, unless if flint and steel is used Prevents entities from changing blocks Prevents creature spawning, except for armor stands Prevents indirect block item drops Prevents blocks from dropping XP Prevents entity damage Prevents loot on entity death Prevents blocks from forming and spreading 2024-01-10 02:07:08 +01:00			`interacting with blocks across clear region borders, block drops, mob drops, pistons pushing or pulling across clear`
			`region borders, dispenser dispensers, droppers, armor dispensing, blocks burning, blocks igniting (except flint and`
			`steel), creepers exploding, TNT priming and keeping any inventory items if dying within a clear area. This list might`
			`not be exhaustive.`
Adds README 2023-12-17 03:59:36 +01:00
			`## Dependencies`

Adds info about how to configure the plugin 2023-12-17 04:07:51 +01:00			`- WorldGuard`

			`## Configuration`

			`Add the identifier (name or UUID) of the world you want to specify a region for as a sub-key of clearRegions. Make sure`
			`your world identifier is a string list "worldName: []", and add any regions you want to enable inventory clearing for to`
			`the list of the world the region belongs to.`

			`Example config:`

			```yaml
			`clearRegions:`
			`world:`
			`- "creative_building"`
			`- "clear"`
			```

			`or`

			```yaml
			`clearRegions:`
			`world: [ "creative_building", "clear" ]`
			```