Area events command plugin for Pocketmine
  • Автор:genboy
  • Рейтинг:starstarstarstarstar
  • Версия плагина: expand_more
  • Версия API:3.0.0 - 3.22.1
  • Скачиваний:6143
  • Дата добавления:04 Feb 2020
save_alt Скачать плагин
Категории плагина
  • category Механизмы
  • warning Необходимое
  • how_to_reg Для админов
  • directions_run Мини-игры
  • insert_emoticon Развлечения
  • nature_people Работа с миром
  • settings_ethernet Разработчикам
  • highlight Образование
  • build Разное
Информация о плагине


Create area's, manage flags and run commmands attachted to area events.

Latest Release @ poggit

Note: Updated Version Dev loosing compass to fix level management. Download Phar: Festival_dev-121

Festival plugin logo large

Copyright Genboy 2018 - 2020
Take notice of the Copyright Statement if you use Festival for the first time since 27 April 2019. Read the Legal Notice** at the bottom of this README file or the Legal Notice tab at


If you like to use Festival consider sharing your experience and issues to fix any usability problems before posting a vote! That way it will improve Festival, my coding skills, your Pocketmine-MP insights and strenghten the PMMP community, thank you! For more info visit, home of Festival

The Festival Plugin is released on poggit

See and make reviews @ poggit and post your issues @ github - Average time to resolve an issue Percentage of issues still open

Festival 2.1.0 Command usage


version 2.1.2

  • Russian (ru) translations
  • French (fr) translations
  • Add right-click position selection in air
  • Barrier op msg fix
  • ForceUTF8 update fix PHP 7.4
  • Debugged global eventhandling
  • Area selection with Midair

version 2.1.1

  • Place compass translations
  • Full fix falldamage
  • Debug areaMessages & config
  • Fix typo's

version 2.1.0

  • Mob/animal flag Slapper fix to remain on restart
  • Edit flag protects paintings
  • Fall flag bug fix
  • Turn on compass usage (in development) User can select their area's (whitelisted) to set compass direction Command can be used to set any area compass direction on area event

version 2

Festival Manager Menu (UI + select item) - or use the commands

  • Cube AND Sphere area's set with diagonal, radius or diameter
  • Area's and Config managed from menu
  • Optional Level flag protection
  • Area name (and desc) can now be Full string inCluDing MuLti wORds CaPitaLized
  • Stretching area's up and down with y scaling
  • Use priority number for overlapping area's



Menu In version 2.0.0 the Festival Management Menu (FormUI) is introduced


  • set default options in config.yml;
    • Language: en - select language English = en, Dutch = nl, es = Español, pl = Polskie - translate please !
    • ItemID: Hold this Magic block/item to enter Menu (default item 201 - Purpur Pillar block)
    • Msgtype: msg - Area Messages Display position (msg/title/tip/pop)
    • Msgdisplay: off - Area Messages persist display to ops (off/op/on)
    • Areadisplay: op - Area Floating Title display to ops (off/op/on)
    • FlightControl: on - To disable flight flag for all Festival usage (on/off)
    • AutoWhitelist: on - Auto whitelist area creator (on/off)


  • Create and manage area’s ingame

    • Define area's by tapping 2 positions
      • diagonal for cube
      • radius for sphere
      • diameter for sphere
    • Scale area's verticaly up and down
    • create/rename/delete/list area’s
    • add area description
    • whitelist players for the area
    • tp to an area
    • show area’s info at current position


  • Set area flags ingame Flags: Any flag true will protect the area and the players in it. ie. edit: true (on) means no breaking/building by players. shoot: true (on) means no shooting by players.

    • edit: the area is save from building/breaking
    • hurt: players in the area are save (previous god flag)
    • pvp: players in the area are save from PVP
    • flight: players in the area are not allowed to fly
    • touch: area is save from player interaction with doors/chests/signs etc.
    • animals: no animal spawning (including spawners & eggs)
    • mobs: no mobs spawning (including spawners & eggs)
    • effect: player can not keep using effects in the area
    • msg: do not display area enter/leave messages
    • pass: no passage for non-whitelisted players! (previously barrier flag)
    • drop: players can not drop things
    • tnt: explosions protected area
    • fire: fire protected area (including spreading & lava)
    • explode: explosions protected area
    • shoot: player can not shoot (bow)
    • perms: player permissions are used to determine area command execution
    • hunger: player does not exhaust / hunger
    • fall: player will not have fall damage
    • cmd: area event commands are only executed for ops (test area commands)

Events & Commands

  • Add commands to area events

    • assign commands to area events
    • enter, center or leave.
    • variable player in commands with {player} or @p
    • add/edit/delete area event command
    • list area commands (ordered by event)
    • change event of area commands

Level flags

  • Use the level flags for level protection

    • per level the levelcontrol toggle option enables the level flag protection


Festival Install (version 2 ): (always save copies of your previous used config.yml and areas.json before re-install)

  1. place phar file or unzipped Festival folder with (Devtools pluginfolder) in server plugins folder and restart,
  2. after restart; 2a. if need previous used configs and areas: delete config.json and areas.json from the root folder and put your config.yml and areas.json in Festival (root) folder 2b. if clean start (no areas) edit /resources/config.yml to your likes and delete config.json from the root folder
  3. Then restart again, now areas.json, levels.json and config.json in Festival (root) folder are used.

( or download latest stable version @ poggit - no Festival menu, only command usage)

Get started

Management UI in game: command hold magic item or ** /fe menu** (ui, form, data) ( default magic item 201 - Purpur Pillar block - change in config management) When using the form you need to use the magic item to tab area positions. You can swapp item to build/break during area position 1 and 2 selection.

Or use the commands as shown in the usage image (now with Multi wORd FULLY CapitAlized nameS possible)

Create area with menu:

You can use cmd '/fe menu' or just hold the magic item (purpur block/your selected item/block). Then if you choose create area you should tab the positions with the magic item.
After tab pos1 you may use other blocks to build etc. and then hold the magic item again to tab pos2. Directly after tab pos2 the menu should come back to name your area.

Create area with commands:

Use /fe pos1 and /fe pos2 to tab the positions, after pos2 you need '/fe create area ' to finnish the area creation. After creation both commands and menu can be used to manage the area.


Download development version: Poggit development Please report bugs -thank you! issues @ github and/or reviews @ poggit

or use devtools plugin and download zip package

Menu (UI)

Festival Menu

Festival main menu

Start menu select management option


Select teleport destination

Select teleport destination


Area management option menu

Area option menu

Select area to manage

Select area

Manage area settings

Edit area settings

Manage area flags

Edit area flags

Manage area commands

Manage commands for area events

Add command

Edit or add commands to area

using the @p reference in the command to target the player (/heal command is an example, comes from another plugin)

Del or change command (by id)

Edit or add commands to area

Delete: Leave command empty and input 'delete cmd id' to delete id linked command. Change: Set event type, enter command and input 'edit cmd id' to change that id linked command

Manage area Whitelist

Manage area whitelist

Set players on or off area whitelist (this is in development)

Select area to delete

Delete area

Confirm to delete area

Cofirm area delete


Select new area type

Select new area type Hold the magic item - 201 purpur block by defaults, set in configs Tab positions with the magic block, meanwhile use other blocks to build in between.

Set area positions

Cube Diagonal
1. Place or break the first diagonal position for new cube area
2. Place or break position 2 to set the longest diagonal in the new cube area
Sphere Radius
1. Place or break the center position for the new sphere area
2. Place or break position 2 to set the radius for new sphere area
Sphere Diameter
1. Place or break the first diameter position for the new sphere area
2. Place or break position 2 to set the diameter for new sphere area

Create area with Name (and description)

Create area with name and description


Turn on level flag control to use the level flags (instead of defaults) festival-use-level-flags

Select level to manage flags (if levelcontrol config is on)

Select level

Manage level flags options

Manage Level use option and flags Edit level flags(defaults)


UI configuration to set overall options and default flags for levels and area's festival-set-configs-default-flags

Manage Festival configuration options and set default flags

Manage configuration

Copyright Genboy 2018 - 2019 - markdown edited with []


  • Edit config.yml; set the defaults for options, default area flags and the default area flags for specific worlds.
  • using ingame Festival Menu (UI) for configurations
  • older versions (1.1.3) read wiki on configurations

Festival 2.1.0 Command usage


Install & Configure

  • Standard Plugin installation; Upload .phar file to server 'plugin' folder (or upload .zip if you have latest devtools installed), restart the server, go to folder plugins/Festival;

  • read wiki on configurations


Updates available at poggit and github

!Before update always copy your config.yml and areas.json files to a save place, with this you can revert your Festival installation. Keep your old files (befor v2.0.0) for new install.
  • first remove Festival folder (keep the areas.json and config.yml)
  • after .phar install and first restart/reload plugins; check console info
  • replace the new(empty) areas.json with your original (old) areas.json
  • put your original config.yml in the Festival (or /resource) folder and remove the config.json file;
  • restart server after adjusted correctly
Copyright Genboy 2018

Festival Manager menu

Open th Festival menu

/fe ui
/fe menu

or get hold of the magic item in the inventory


/fe lang <en/nl/es/pl/ru/fr>

Set Festival language en/nl/es/pl/ru/fr for area and command returned messages. en = English nl = Nederlands es = Español pl = Polski ru = русский (Russian) fr = Français

__ = your language, please help translate

Create area (cmd)

### Cube area

First command  '/fe pos' or '/fe pos1' 
and holding the magic block, default 201, tab or break a block for position 1 

then command '/fe pos2' 
and and holding the magic block tab or break a block to set position2, 

these are the endpoints of the area longest diagonal.

/fe pos1(pos)
/fe pos2

Sphere area

First command '/fe pos' or '/fe pos1'

For sphere radius;
holding the magic block tab or break a block for the center of the sphere  
then command '/fe rad' or '/fe radius'
and and holding the magic block tab or break a block to set the radius size.

For sphere diameter;
holding the magic block tab or break a block for first end of the diameter
then command '/fe dia' or '/fe diameter'
and and holding the magic block tab or break a block for the other end of the diameter.

/fe pos
/fe rad / dia

After position selections

Then name/save the selected area

/fe create <AREANAME>  

Now the area is ready to use

You might want to set or edit the area description line

/fe desc <AREANAME> <description>

Set area flags

fast toggle for flags: (since Festival v1.0.1-11)

  /fe <edit/hurt/pvp/flight/touch/mobs/animals/effect/tnt/fire/explode/shoot/drop/msg/pass/hunger/perms/fall/cmd> <AREANAME>

Area flag defaults are set in the config.yml, server defaults and world specific default flag. 

  /fe flag <AREANAME> list

Delete an area

  /fe delete(del,remove) <AREANAME>   

List all area's

See all area info, optional per level

  /fe list (<LEVELNAME>)

Floating titles

Floating titles are set in the configs (menu or config.json / yml)
Toggles the titles on/off

/fe titles

Teleport to area

Teleporting to area center top, drop with no falldamage (if falldamage flag true)

/fe tp <AREANAME>

Toggle level area's floating title display

Area floating title display (default set in config.yml)

/fe titles

Set description


Manage whitelist

/fe whitelist <AREANAME> <add/list/remove(del,delete)> <PLAYERNAME>

Set compass

/fe compass <AREANAME/(reset/spawn)>

Area event commands

**This is the fun part of Festival: assign commands to area events**

When an area is created 3 events are available;
  - enter; when a player enters the area
  - center; when a player reaches the center (3x3xareaHeight blocks)
  - leave; when a player leaves the area

To add a command you need at least;
  - an areaname, 
  - an unique id for the command 
  - make sure the command works! (when you are op)
/fe command <AREANAME> <add/list/edit/event*/del> <COMMANDID> <COMMANDSTRING/enter*/leave*/center*> 
Add a command:

  'add' is the default for attaching a command on the 'enter' event. 
  Using 'enter', 'center' or 'leave' instead of 'add' attaches the new command to 
  the given eventtype: i.e. /fe command <areaname> center <commandid> <commandstring>
List area commands:
/fe command <AREANAME> list
Edit command:
Change command event:
/fe command <AREANAME> event <COMMANDID> <enter/center/leave>
Remove command:
/fe command <AREANAME> del <COMMANDID>


Updates available at poggit and github

!Before update always copy your config.yml and areas.json files to a save place, with this you can revert your Festival installation
  • after .phar install and first restart/reload plugins; check console info and your areas.json and config.yml; restart after adjusted correctly

  • ! Update Festival 2 in development translating resource config.yml or your mainfolder config.yml and areas.json on install


Many thanks to all who have posted valid issues and requests!

The basic area code in Festival derives from the iProctector plugin. Credits for the basic area creation and protection code go to the iProtector creator LDX-MCPE and other iProtector devs.

The Festival code is written and tested by Genboy and first released on 12 Feb 2018 with an area object holding events (enter and leave messages) and soon extended with functions and ingame commands to attach a commandstring to a area-event. Since v1.0.7 the area's and players can be protected with 12 flags, and trigger commands on areaEnter, areaCenter and areaLeave. And players can teleport to top-center of an area. In festival version 1.0.8 many flag functions where improved and the plugin was extended with 8 new flags, language translation options and area floating titles. During v1.0.9 to 2.1.0 many flag functions where improved, a compass-to-area option added and translations extended to en/nl/es/pl .

Legal Notice

-- Legal notice --

For Festival the General Public License agreement version 3, as in the LICENSE file is still included and operative.

To protect this software since 27 April 2019 the Festival software package is copyrighted by Genboy. You are legally bind to read the Festival Copyright statement.

In short this change of Copyright statement does not change the usage levels as stated in the GPU, for a part it now prohibits any entities to sell the software without the knowledge of the owner.

-- end legal notice --

Copyright Genboy 2018 - 2019

markdown edited with and
translated to html with

История версий
  • 2.1.2
  • 2.1.1
  • 2.1.0
  • 2.0.0
  • 1.1.3
  • 1.1.1
  • 1.1.0
  • 1.0.9
  • 1.0.8
  • 1.0.7
  • 1.0.4-11
  • 1.0.2-11
  • 1.0.0-11
Отзывы пользователей
v 2.1.2 30 Mar 21
This plugin is very good, and what I like the most is that it has the Spanish language, many plugins do not have that language, and I speak it and everything is easier for me, thank you.
v 2.1.2 25 Mar 21
I get kicked when using the UI to change the presets, i cannot use the set position commands it doesnt set correctly, even editing the world perms via files doesnt save it just reverts, the plugin has basically locked my server into a spectator mode only.
v 2.1.2 23 Feb 21
Please fix the level flag management bug so I can get my server back up? Nothing works without it since people take damage and I can't set the whole world to be protected. I will update this review when you update your plugin:(
v 2.1.2 11 Feb 21
Just wow :) I cannot realise how you made "sphere by diameter", wow
v 2.1.2 06 Feb 21
v 2.1.2 25 Jan 21
great plugin!
v 2.1.2 24 Jan 21
Пустой комментарий.
v 2.1.2 23 Jan 21
Great plugin, but how can i enable block break and place for world?
v 2.1.2 03 Aug 20
This is an amazing plugins. Do you have a Discord that I could join/dm to ask questions? Thanks!
v 2.1.2 10 Jun 20
God This is so useful, I've been searching Google for ages, I just never thought the name would be "Festival". It's really up to date. Thanks a lot and good luck in your project!
v 2.1.2 03 Jun 20
Great plugin! Will be using this again soon when i open up my server!
v 2.1.2 30 May 20
Great plugin I was looking for something like this for so long!
Quick question how do I find the command id to delete a command or edit it?
v 2.1.2 16 May 20
I really like this plugin but how do I disable flight bc in any level I go to it has flight enabled even if I create a world it would have flight enabled so I want to know how to disable flight
v 2.1.2 27 Feb 20
Пустой комментарий.
v 2.1.1 12 Feb 20
I have loved using this plugin for over a year now but I've recently updated the plugin and now I get an exception. If you need more info on the error, message me on Discord: Xenophilicy#0001 But otherwise, love the plugin, it does everything I need.
v 2.1.0 14 Nov 19
Amazing Plugin! Is there a way to make it that players can buy areas and then sell them? Like if they buy the area then they can build in it.
v 2.0.0 17 Aug 19
Hello. This Plugin is great, but i give this Plugin 4 stars, because in all of my worlds is pvp and build deactivate. Please fix this and make a video for the Plugin and I give 5 stars.
v 2.0.0 01 Aug 19
Great plugin, but still has some kinks to work out. Genboy is very good at handling issues with this plugin. I love this plugin and it is the best plugin for managing your server's areas.
v 2.0.0 31 Jul 19
Great responses when people are in need of help- great plugin too! 5/5!
v 2.0.0 31 Jul 19
great plugin but i used and its controlled entire server?
v 1.1.3 11 Jun 19
Multifunction plugin!!
v 1.1.1 01 Apr 20
Пустой комментарий.
v 1.1.1 27 Jun 19
Nice plugin! But i don't know how to protect the whole world to create my prison server
v 1.1.1 24 Mar 19
I love it but make it so you can just keep flying at default or not because /fly does not do anything i want it so you can only fly if you do /fly
v 1.1.1 23 Mar 19
It's okay but not the best. You need to decide if you enable fly or disable it in a world so /fly is useless...
v 1.0.9 10 Mar 19
It’s a great protecting plugin and the Dev is VERY active on GitHub and helps you if you have a problem instantly.
Thank you @genboy!
v 1.0.8 27 Dec 18
This plugin is very nice to have in your server to protect areas. It has a lot of handy flags. It's not perfect though, as the flight flag can be annoying. It would be nice if there was an option to prevent the plugin from managing flight.
v 1.0.7 08 Sep 18
confusing, for some reason normal user still can break blocks in the area with edit true or false, flight is also possible with either true or false
maybe a readme rewrite to know what does true/false do & what world,global means in the config
v 1.0.7 26 Aug 18
Пустой комментарий.
v 1.0.4-11 11 Jun 18
Great Plugin really helps with building protection
v 1.0.4-11 30 Apr 18
Awesome plugin
v 1.0.4-11 30 Apr 18
A promising update! Keep it up
v 1.0.4-11 01 Apr 18
It is great can be improved i like IT!!!
v 1.0.2-11 13 Mar 18
I've been trying to set a place to be minable at spawn, I have a feeling its spawn protection causing this. Any tips? Should i turn off spawn protection? Im having a hard time making a prison server... :/
v 1.0.2-11 12 Mar 18
Why doesn't work?
v 1.0.1-11 22 Feb 18
Any way To not say stuff when ppl enter/leave?
v 1.0.0-11 23 Feb 18
Пустой комментарий.
v 1.0.0-11 22 Feb 18
Great Job!
v 1.0.0-11 19 Feb 18
this is simple and a good idea. can see use for this. thank you.
v 1.0.0-11 14 Feb 18
Nice idea