Skip to content

Latest commit

 

History

History
88 lines (73 loc) · 8.84 KB

README.md

File metadata and controls

88 lines (73 loc) · 8.84 KB

AreaShop logo
Usage and configuration: ►Download (releases)   ►Commands and Permissions
         ►Basic regions setup   ►Advanced regions setup   ►Configuration files
Advanced features: ►Save/restore region blocks   ►Change the language   ►Limitgroups
Troubleshooting: ►Frequently Asked Questions   ►Common errors
Support: ►Request a feature, report a bug or ask support   ►Open issues
Development: ►Changelog   ►Compiling   ►Modules/classes overview ►Javadocs ►Development builds
Connections: ►AreaShop in Spigot Resources   ►AreaShop on BukkitDev


AreaShop allows you selling and renting regions to players. It could be used to let them rent a jail in your prison server, a shop in the market of the survival server or a plot on a creative server. The player interacts with signs, making it easy to use. It also has a lot of commands to check the status of all regions, manage the renting and buying of a region and also features for admins. A lot of messages send to the player can be clicked, for immediately performing actions (buying the region, selling the region, etc.) or getting more information (for example clicking region name for region information). To setup the renting and selling of the regions exactly as you want AreaShop has a lot of options to custimize it to your liking.

All features in a list

  • Rent and sell regions to players, and players can resell their bought regions to other players.
  • Signs for easy interaction (rent/buy/unrent/sell/information) and current status (layout and actions customizable, multiple signs can be added).
  • rented-sign
  • Messages that can be clicked for more information and actions (language can be changed, as well as click/hover actions).
  • region-information-message
  • Change the of the plugin or use of of the already provided language files (check here)
  • Automatically restore the region to its original state when sold: restore the region with schematics.
  • Change which commands players can use with permissions.
  • Customize the plugin by changing the config files.
  • Use any WorldGuard flags on regions: disable building in the region, deny entry to others, etc.
  • Teleport to regions (while making sure the location is safe for the player) and changing the teleport location.
  • Adding friends to regions (which also can teleport to it).
  • Automatic unrent/sell for regions of which the owner is offline for a certain time.
  • Warning to players when their rent is about to run out (at login and while they are online).
  • Group system to set options for a couple of regions instead of all of them (all settings in default.yml can also be used for groups and individual regions).
  • High performance: All heavy tasks are spread over time (each tick a part is executed until done), so the plugin should not cause any lag.
  • Limit number of regions a player can have: limits can be different per permission node (player group), world or group of regions (possible situation: Normal players can buy 1 market region in survival + 1 build region in survival and 2 plots in creative, while VIPs have double limits for all those), check these examples.
  • Supports name changes because of saving player info by UUID (more details).

Preview

For a preview join 'mc.go-craft.com' and go to the Survival server, the shops around the spawn use AreaShop.

Tutorial & Feature overview (AreaShop V2.0.1)

Made by Koz4Christ
Tutorial Video

Prison cell setup tutorial (AreaShop V2.1.0)

Made by PerkulatorTime
Tutorial Video

Old video for AreaShop v1.0: Tutorial by VariationVault

Required dependencies

  • Java 8 or higher (latest recommended)
  • Bukkit/Spigot 1.16.5 or higher (modded servers often include Bukkit/Spigot support, so it should also work on that, but it is not specifically tested for it)
  • WorldGuard: 7.0 or higher (6.0+ recommended)
  • WorldEdit: 7.0 or higher (6.0+ recommended)
  • Vault: 1.7.3 or higher
  • An economy plugin supported by Vault (check the Vault page for a list of these)

Metrics

This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.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.

This information will give me an indication how much the plugin is used and encourages me to continue development. Opting out of this service can be done by setting sendStats in the config of this plugin to false, if you want to disable Metrics for any plugin go to plugins/Plugin Metrics/config.yml and change opt-out to true. Check graphs of the statistics at this page: https://bstats.org/plugin/bukkit/AreaShop/32

Do you want to translate AreaShop?

Help translating the plugin into different languages and to keep the translations up to date. Go to this page for more information. Translating goes through the Transifex website and is very easy, sending files back and forth is not needed, you can translate lines online and whenever you want. Every line you translate will be saved, no need to do it all at once (this also allows for easy collaboration).

Transifex-translation-progress

Discord-support-chat

Donate through PayPal to support development