Districts

Districts is like GriefPrevention, but players can sell/buy, lease/rent their claims!

Claims are made by command, or using a golden hoe. Once a district is claimed, the district is protected from griefing. District owners can rent out a district for a weekly fee, or sell the district for a price. District owners or renters can add trusted players to a district who then have most of the same rights as the owner or renter.

This is the new Version of Districts, it was Updated by me (Leo) and additional features were added. You can find the original Districts here: https://www.spigotmc.org/resources/districts.989/

I have got the permission to upload this by tastybento the original Developer.


Features

• Districts are made easily by using /d claim <radius>, which will make a square claim around you
• Districts can also be made using a golden hoe - hit one corner of the claim and the other corner
• Players are notified when they enter a district and exit a district (Chat or Actionbar)
• Districts are automatically protected once made - admins can change the settings via config.yml
• Districts can be freely traded or rented out. This enables houses or buildings to be rented or sold
• Admins can give or take blocks away from players
• Supports multiple worlds (see config.yml)
• Control panel GUI access to commands
• More protection of districts (lava/water flows, etc.)
• Players can buy blocks for money - admins set the block price
• Automatic block allocation is supported by custom permissions (see below for instructions)
• Visualizations are configurable - e.g., diamond blocks, glowstone, etc.
• PlaceholderAPI Support for all Messages.

Required Plugins

• Vault - make sure you use the latest version!
• Some kind of Economy Plugin, like Essentials

Soft Depend

• PlaceholderAPI - For Support in all Messages and GUI's

Installation and Configuration

1. Download and install Vault and an Economy Plugin like Essentials if you haven't done so
2. Download the plugin
3. Place into your plugins folder
4. Restart your server (or reload plugins)
5. The plugin will make a folder called Districts. Open that folder.
6. Check config.yml and edit to be what you want.
7. Type /dadmin reload in the game to reload the config or restart the server.
8. Done! To make your first district, type /d claim 2 to make a small claim.
9. Please write a review (if you like this plugin)!

Player Commands

• /district or /dist or /d can be used for short.

• /district help - lists these commands
• /d claim <radius>: Claims a square district with you in the middle
• /d view: Toggles the red district boundary visualization on or off
• /d pos: Sets a position for a district corner
• /d balance: Shows you how many blocks you have to use for districts
• /d remove: Removes a district that you are standing in if you are the owner
• /d info: Shows info on the district you are in

With BuyBlock Permission:

• /d buyblocks: Shows the price of blocks
• /d buyblocks <number>: Tries to buy some blocks

With Advanced Player Permission:

• /d buy: Attempts to buy the district you are in
• /d rent: Attempts to rent the district you are in
• /d rent <price>: Puts the district you are in up for rent for a weekly rent
• /d sell <price>: Puts the district you are in up for sale
• /d cancel: Cancels a For Sale, For Rent or a Lease
• /d trust <playername>: Gives player full access to your district
• /d untrust <playername>: Revokes trust to your district
• /d untrustall: Removes all trusted parties from your district

Admin Commands

• /dadmin reload
• /dadmin balance <player>: shows how many blocks player has
• /dadmin info <player>: provides info on the player
• /dadmin give <player> <blocks>: give player some blocks
• /dadmin take <player> <blocks>: remove blocks from player
• /dadmin set <player> <blocks>: set the number of blocks a player has

Permissions

How to set up automatic block giving
Here is the relevant section from config.yml:

Blocks are given out to online players who have the right permissions. Each special permission is listed in the config.yml file in the blockgroups section. You can create your own permission name - it can be anything, but I recommend making it start with "districts". Each permission has a number of blocks they will receive every block tick, and a maximum they can have at any time. For example, from the file above, super donors will receive 100 blocks every minute until they max out at 1000 blocks. If they spend those blocks, they will refill back up the 1000.

The default block tick is 1 minute. Set it to be something that fits your server, for example 10 minutes. Remember, players will only get blocks if they are online.

If you do not want to use auto-block allocation, do not give players the permissions or set the block tick to zero.

To Do

• Allow customization of the rental period (currently 1 week)
• Enable owners to see a list of their districts
• Snow Bug
• Disabeling Metrics

Source Code
Source code can be here: https://github.com/SphinxHD/Districts

Stats Disclosure
This plugin utilizes a plugin metrics system, which means that the following information is collected and sent to bstats.org.

• A unique identifier
• The server's version of Java
• Whether the server is in offline or online mode
• The plugin's version
• The server's version
• The OS version/name and architecture
• The core count for the CPU
• The number of players online
• The Metrics version

You can find our stats here: https://bstats.org/plugin/bukkit/Districts/13965