Note
The following pledge was made before the DMCA was issued against Craftbukkit and derivatives. If Craftbukkit is continued, I will uphold my promise to prioritize compatibility with 1.8 versions. However, with plugin approvals frozen and confusing information about external links posted on the forums, my Twitter feed will be the most reliable place to get information on my plugins (including ones not released on BukkitDev).
1.8 Pledge: I promise to support the 1.8 update. I will do my part to investigate and report bugs. As soon as a beta or recommended build is available, I will review my plugins for compatibility and make necessary updates.
Description
VoidGuard provides basic functionality to servers to control member access to void areas. It provides the following benefits.
- Define layers in worlds as exclusively bedrock zones and fill "holes" through automation or command. Additionally prevent creative players from breaking these layers.
- Define layers in worlds to remove extra bedrock and replace with your choice of material through automation or command.
- Prevent players from abusing dark oak growth to break through the bedrock layers.
- Set commands to be run if a player trespasses into a void zone.
This plugin was created in response to a need to have the above features while being compatible with pre-existing worlds, new "vanilla" land generation, and custom terrain generators which don't automatically include these features. It is intentionally meant to be more humble utility than an epic piece of (software) art. :)
Setup
Install
- Add plugin jar into your plugins folder.
- Stop and start your server again. Do not use "/reload" - I believe VoidGuard is safe for reload, but I can't speak for your other plugins!
- Review at least the the default world setting (this applies to all worlds not specifically defined).
- To have worlds with their own settings, make a copy of the "default" world setting in the config file with the world's name, and when set, use /void reload or restart your server.
Configuration
Reporting Problems
Please explain errors/bugs with as much details as you can provide, instead of just saying "it doesn't work".
Potential information to include:
- OS version
- Java version (VoidGuard is compiled with Java 7)
- Server version ("Craftbukkit" or otherwise)
- VoidGuard version
- VoidGuard configuration file (use Pastebin or similar service please!)
- Steps taken to repeat problem
Also, if Craftbukkit updates to a new Minecraft version, please test if VoidGuard works for you before assuming it will not. VoidGuard only hooks into the Bukkit API, so it is likely to continue functioning through updates.
Metrics
Hidendra's Metrics have been added to the project, because statistics are fun and the information makes it easier to calculate usefulness. You can view collected data at mcstats.org/plugin/VoidGuard
Disable metrics from sending for any plugin by going into (your plugin folder)/PluginMetrics/config.yml and setting `opt-out: true` Disable metrics just for VoidGuard by setting `hook-metrics: false` in VoidGuard's config.
The status of the metrics will be output to the server log during startup.
Note: Hidendra's metric's will be removed in the upcoming VoidGuard 1.3 version.