ZoneX | World Protection and Notifications

ZoneX

Create zones, add protections, get notified!

ZoneX world protection and communication plugin that allows players to define zones, apply protections, and watch events while they are offline. Have you ever wanted to if someone destroys your base? Get sent notifications when someone enters your base, or when TnT explodes within your area! Want to be able to get online with your friends? Be notified when they go online! ZoneX provides a number of communication methods and events that you can observe.

How to Install (server Admins)

1. Download the .jar file from this plugin page.
2. Place the .jar in your /plugins folder
3. Run the server once to generate the configuration file.
4. Edit the configuration file to fit your needs.

Configuration File

The following configuration sections are the most important:

• server.database
  • If you want to use a database connection to store data, ensure that this information is configured. If the database is disabled, a flat file will be used to save data instead.
• areas.default
  • This is a list of the default protections that are applied to an area when it is created. For additional information aboue what each one of these protections do, see the Protections section of this guide.
• areas.limit
  • The number of areas one player can have
• events
  • Settings for each event to determine if players can listen to them through the /watch command
• communication
  • In order to recieve external communications, this section must be configured to hook into your communications.
  • twilio
    • Allows sending SMS test messages. TO enable this, create a Twilio account and configure your sid, auth Token, and number here.
  • email
    • Uses an SMTP server to send email communications. Configure SMTP settings to allow email notificaitons
  • discord
    • In order to use Discord integration you MUST also be using DiscordSRV on your minecraft server

5. Once configured, start(or restart) your server and your configurations will be applied.

Basic Commands

All commands are documented in-game through the use of tab-complete. A detailed guide of the commands and how to use them can be found here .

• /zx help
• /zx verify

Creating Zones

Create a zone with /zone add <zoneName> . This will start the zone creation process where you place iron blocks around your area. Throwing the iron block will finalize the area.

Once created, see a list of all of your zones with /zone list and get detailed information about your zone with /zone info <zoneName> . View your zone border with /zone view <zoneName> and remove a zone with /zone remove <zoneName> .

Allow Access to zones

Once an area is created, accesss to the area can be limited to specific players. The following commands can be used to add or remove specific players from an area.

• /zone allow <playerName> <zoneName>
• /zone deny <playerName> <zoneName>
• /zone deny all <zoneName>

Protecting your zone

When an area is creeated, some default protections are applied to the area to ensure you are the only one able to interact in the zone. Add or remove a protection with /zone <protectionName> <zoneName> .

• protect - Prevents blocks from being placed or broken within the area by unallowed players.
• mobProtect - Protects peaceful animals from being harmed by unallowed players.
• stopLiquid - Stops lava and water from flowing into the area.
• chestLock - Prevents chests from being opened by unallowed players.
• noRedstone - Prevents any restone signals from being activated by unallowed players.
• noFire - Prevents fire spread in the area.
• doorLock - Prevents doors from being opened in the area by unallowed players.
• noEnter - Prevents unallowed players from entering the area.
• noPvP - Prevents players within the area from being attacked by another player.
• free - Resets the area back to the default protection.

Getting Notifications

Subscribe to various events that may occur inside of your zone. By using the /watch command, you can watch the following events:

• login <playerName>
• playerEnters <area>
• explosion <area>
• blockBreak <area>
• redstone <area>
• crop <area>
• enterNether <player>
• enterEnd <player>
• enterWorld <player>

See all events you are watching with /watch list and stop watching an event with /unwatch <eventId> . Note: You must /unwatch with the event ID of the event.

In order to get notifications while you are offline, your server admin needs to have enabled an external communication method. The following commands allow you to receive notifications from external sources:

• /zx sms <phoneNumber> - Receive text notifications
• /zx email <email> - Receive email notifications
• /zx discord - Receive discord notifications
• / zx sms stop
• /zx email stop
• /zx discord stop
• /zx devices - Shows all of your enabled communication methods

This plugin is currently under development! Features may change, and additions may be made. Thank you for all of your support! For more information see the github repository https://github.com/MCNotify/Plugin