ProtectionStones [Updated for 1.13 - 1.16 + WG7] 2.7.6

The easiest grief prevention method that players will enjoy!

  1. EspiDev
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    https://github.com/espidev/ProtectionStones
    Contributors:
    AxelDios (Original), Vik1395 (2015-2016), Dragoboss (2016-2017), Jerzean (2018)
    Get support for this plugin on the M.O.S.S. Discord! https://discord.gg/TQXWtf8

    Ever needed an easy, yet powerful way to prevent grief, and protect a certain area?


    This plugin allows players to protect land using a block that they place down. It creates a WorldGuard region at a set radius (configurable) around where the block is placed. The plugin also allows players to add and remove people to the region, as well as set flags (defined in the config).

    Requirements:
    • WorldGuard 7+
    • WorldEdit 7+
    • Vault (Optional)
    • PlaceholderAPI (Optional)
    • Spigot 1.13.2+
    Appreciate my work?
    Donations are appreciated! :)
    https://paypal.me/espidev

    Installation:

    To install ProtectionStones, make sure you have the requirements above already installed. You can simply just add the plugin to the plugins folder, and it will generate the default configuration.

    Adding new blocks:
    To add new protection blocks, go into plugins/ProtectionStones/blocks, and copy and paste the default block1.toml file and rename it (ex. block2.toml). Then, you have to change the "type" and "alias" fields in the new block config, since there cannot be duplicates.

    Configuring flags:
    Flags allow for customisation of region behaviour. ProtectionStones uses WorldGuard flags, meaning that WorldGuard is actually doing the protecting, not ProtectionStones. You can view the list of WorldGuard flags here.

    It is also possible to use other plugins that add flags to WorldGuard, such as WorldGuard Extra Flags and use them in ProtectionStones.

    Permissions:
    The permission list is on the wiki: https://github.com/espidev/ProtectionStones/wiki/Permissions. By default, no permissions are given to players, so you have to add them explicitly. You can also view the recommended permissions to give for commands here.

    Other Recommendations:
    WorldGuard by default prevents hoppers from going between regions. I recommend setting "ignore-hopper-item-move-events" in WorldGuard's config to false to fix this.

    If you want to protect against water and lava flow, you can set "high-frequency-flags" and "protect-against-liquid-flow" to true in WorldGuard's config.

    WorldGuard config: https://worldguard.readthedocs.io/en/latest/config/

    Default Config Files:
    Wiki: https://github.com/espidev/ProtectionStones/wiki/Configuration

    Translated Versions of messages.yml:
    Interested in having the plugin messages in a different language? Users have contributed translated versions of the messages.yml file. Contact me if you want to supply a messages.yml file in a different language!
    https://github.com/espidev/ProtectionStones/wiki/Translated-messages.yml

    Usage

    Commands:
    Wiki: https://github.com/espidev/ProtectionStones/wiki/Commands

    Placeholders:
    ProtectionStones has support for PlaceholderAPI! View them here.

    FAQ

    When I add a new block config, an error occurs!
    Read the error. Most likely you made a configuration mistake, you can read the TOML spec here, or ask me. Another known issue is that configs made in Notepad (Windows) cause issues with the plugin. Please use a better text editor (ex. Notepad++) for the time being, while I investigate ways to mitigate this.

    When I get the protection block from the creative inventory, it doesn't work (nothing happens when I place it)!
    Since v2.0.0, the config options "restrict-obtaining" is enabled by default. This restricts obtaining the protectionstones to just /ps get and /ps give (and plugins that use the API), since they attach NBT data to the block. That means that when the block is obtained through natural means, it won't work as a protection block. You can set "restrict-obtaining to false to negate this behaviour.

    How can I add protection blocks in a kit?
    Since v2.0.0, the config options "restrict-obtaining" is enabled by default. This restricts obtaining the protectionstones to just /ps get and /ps give (and plugins that use the API), since they attach NBT data to the block. You need to add a command (/ps give) to give the block to the player in the kit. For EssentialsX, check the kit section here.

    How can I sell protection blocks in a shop?
    There are many ways to sell protection blocks, with the easiest being setting a price on /ps get (requires Vault, configured in the block config). You can also use external plugins to sell the protection block, either through running a command (/ps give) or giving an item that was obtained through /ps get or /ps give. Known plugins to work are: ShopChest, ChestCommands.

    Why don't players see the region merge menu?
    Be sure to give players the protectionstones.merge permission.

    Why do some flags apply to members of the region as well? (ex. block-break deny)
    By default flags apply to everyone, including members of the region. You have to use region groups (using -g) to change this (ex. set the group to apply to only nonmembers). You can read about this here.

    How do I change the block type of a region after players have already created regions with it?

    You can use the command /ps admin changeblock [world] [fromblock] [toblock] to do this. Create a new config (block.toml file) in the blocks folder with the changed block type, while keeping the old one still loaded. Do /ps reload, and run the command to do the conversion. After it completes, you can remove the block config with the old type.

    Why does [x] flag not work?

    Flags are handled by WorldGuard, and some of their behaviours may not be what you expect. You can read more about WorldGuard flags here: https://worldguard.enginehub.org/en/latest/regions/flags/

    How can I allow PS regions to overlap or be created inside manually created WorldGuard regions?
    You can use the concept of priorities in WorldGuard, and set the manually created WG region to a lower priority than the ProtectionStones regions.

    I found a bug! How do I get it fixed?
    Please file this issue on either GitHub, or post it on the discussion page.

    I want a new feature!
    Please file this issue on either GitHub, or post it on the discussion page. The feature may not be aligned with the goals of the plugin, so it might also be worth making another plugin that uses the developer API instead.

    Is there a developer API?
    Yes there is! It still is in a beta stage though right now, so methods are bound to change. You can see the WIP wiki page here: https://github.com/espidev/ProtectionStones/wiki/API

    ~~~~~

    This plugin is based off of the original ProtectionStones.

    Migrating from older versions of ProtectionStones (<2.x.x)

    The transition from older versions should be seamless, so just drag the plugin in to the plugins folder and enjoy! The plugin will automatically update your configs and regions.

    You can find the original plugin here:
    https://www.spigotmc.org/resources/protectionstones.10096/

    https://dev.bukkit.org/projects/protectionstones
    Diclo, Flak, TheFoXi and 7 others like this.

Recent Reviews

  1. CrissThePumpkin
    CrissThePumpkin
    5/5,
    Version: 2.7.6
    Best plugin ever for survival :D
    fast response for dev and very friendly
    ----------------
  2. DrLunam
    DrLunam
    5/5,
    Version: 2.7.6
    good plugin,but how can i set permission for users ,theyre not allowed and cant find where to set permissions
    1. EspiDev
      Author's Response
      You have to use a permission plugin, like LuckPerms.
  3. Kristiyan_Krumov
    Kristiyan_Krumov
    5/5,
    Version: 2.7.6
    I really love it, it is really stable and very user friendly and really easy to set up, I recommend it!
  4. BlaYT29
    BlaYT29
    5/5,
    Version: 2.7.6
    hola buenas mira este complemento esta muy bueno pero tengo problemas con un entonces necesrito ayuda porque en general nunca habia tenido problemas con este pl pero esta vez si los tengo como que me dice que lo tengo que actualizar pero ya esta actualizado todo hasta los complementos extra??
    1. EspiDev
      Author's Response
      I don't understand spanish, but maybe you want to join the MOSS support discord for help.
  5. icezaft09
    icezaft09
    5/5,
    Version: 2.7.6
    Very good plugin a server must have
    and I'd like to help you translate for Thai language
    1. EspiDev
      Author's Response
      Feel free to message me directly, or on the support discord to submit translations.
  6. weedorpy
    weedorpy
    5/5,
    Version: 2.7.6
    muy buen plugin! es nuestro preferido en nuestro servidor! muchas grcaias por seguir actualizando :DD
    1. EspiDev
  7. HunIDHun
    HunIDHun
    5/5,
    Version: 2.7.5
    Hi, This plugin is awesome, thanks for it. And one more thing, me and my friends created a full hungarian message file, is any option to add foreign languages to the plugin(to help others)
    1. EspiDev
      Author's Response
      Thank you! Feel free to message me a link to it pasted on Pastebin (to keep the format), and I'll add it to the translations page.
  8. SliderKP
    SliderKP
    5/5,
    Version: 2.7.5
    today i updated to latest version, thanks for this amazing works.

    consider to add /ps kick command to repel bad users!
    1. EspiDev
      Author's Response
  9. IAreKyleW00t
    IAreKyleW00t
    5/5,
    Version: 2.7.5
    Such a simple plugin that does so much - really helps improve survival gameplay and adds some uses to items. The customization is incredible!
    1. EspiDev
  10. 6085kevin
    6085kevin
    5/5,
    Version: 2.7.5
    ------------------------------------------------
    THX FOR UPDATE 1.16, GUY! <3
    -----------------------------------------------
    1. EspiDev
      Author's Response
      !! no problem