ClaimChunk icon

ClaimChunk -----

Spigot plugin for 1.8+ allowing the claiming of chunks.




Fixes:
  • My stupid update checker
  • Allow header customization for chunk list command in messages.json
----------, Jun 5, 2024

Re-adds the claimchunk_am_trusted placeholder. The player is shown to be trusted if they have been granted any permissions for the chunk they're currently standing in. Players are shown as not trusted when the chunks are not claimed to mimic prior behavior.
----------, Jun 3, 2024

Fixes crash on startup from the "/plugins/ClaimChunk/data" folder not existing on first launch :)
----------, May 25, 2024

This update fixes, once and for all, the data loss issues we've been seeing since I first created this plugin!

Migration:
  • Should not require any extra work, keep your config the same for at least the first run.
  • 0.0.26 will remove the database section of the config, but leave it be for your first launch to make sure old data loads.
  • Prior data from JSON and from MySQL will be converted automatically to the SQLite data file, and JSON backups will be made for you in the /plugins/ClaimChunk/data directory.
----------, May 24, 2024

Major thanks to @AlexFF000 for contributing this entire release!

This update allows individual permissions to be granted on a per-chunk basis. These changes required a major overhaul
of the internal workings of the plugin. The commands have changed, and there have been some changes to the format used
to store the data.

Players will not need to make any changes to their claims as a result of this update; the data conversion process will
convert any existing accesses in such a way that they will continue to function as they did in 0.0.23.

Note: The messages.json and world.txt files may need to be recreated due to new additions to them in this update.
For English language, this can be done by deleting them and running the server. Remember to transfer any custom config
to the new world.txt files after they are recreated.

Changes:
  • Access is now granted on a per-chunk basis, a chunk owner can grant another player access to only specific chunks
    rather than all of their chunks.
    • When the data is converted from the 0.0.23 format, a player that has previously been given access by a chunk owner
      will continue to have access to all the owner's chunks.
  • Players are now granted specific permissions on the chunks that they have access to (so for instance, a player could
    be granted permission to place blocks in a chunk, but not break them).
    • These permissions are:
      • break: Allow the player to break blocks
      • place: Allow the player to place blocks
      • doors: Allow the player to open / close doors and trapdoors
      • redstone: Allow the player to press buttons, levers, pressure plates etc...
      • interactVehicles: Allow the player to interact with mine carts and boats
      • interactEntities: Allow the player to interact with other entities (also allow the player to throw ender pearls
        even if preventPearlFromClaims is true in the world profile)
      • interactBlocks: Allow the player to interact with blocks
      • useContainers: Allow the player to open:
        • Chests
        • Trapped chests
        • Barrels
        • Furnaces
        • Dispensers and droppers
        • Hoppers
        • Brewing stands
  • Commands:
    • The changes have involved significant changes to the /chunk access command; it has now been split into three
      commands:
      • /chunk access <player> [break:true/false] [place:true/false] [doors:true/false] [redstone:true/false] [interactVehicles:true/false] [interactEntities:true/false] [interactBlocks:true/false] [useContainers:true/false] [allChunks:true/false]
        • Give a player permissions on a chunk (or modify their existing permissions)
        • All arguments except player are optional, and can be provided in any order
        • If allChunks:true is provided, the changes will be made to all the executing player's chunks. If false
          (the default) the changes will apply only to the chunk the player is currently standing in (if it belongs
          to them)
        • Any permissions not specified will retain their existing values (e.g. if the command is run without the doors
          option, the player's existing doors permission will remain unchanged) or will default to true if the player does
          not have access to the chunk already.
        • usage example: /chunk access examplePlayer break:true place:false allChunks:true
      • /chunk checkaccess [<player>]
        • List the permissions the given player has on the chunk where the executor is standing
        • If no player is provided, lists the permissions of all players with access to the chunk
      • /chunk revokeaccess <player> [ALL CHUNKS? true/false]
        • Revoke the given player's access to the chunk
        • If all chunks is true, the player's access will be revoked from all the executor's chunks. Otherwise, only the
          one they are standing in (if they are the owner)
        • Usage example: /chunk revokeaccess examplePlayer false
  • Removed "am_trusted" placeholder
  • Added new "CONTAINER" block class
  • Added trapdoors to "DOOR" block class
  • Added boats to "VEHICLES" entity class
  • Changed default world profile permissions for players in claimed chunks who have not been granted access:
    • Interacting with vehicles and monsters is now disallowed
    • Damaging monsters is now disallowed
    • Interacting with redstone is now disallowed
----------, May 6, 2024

For all the other changes pertaining to 0.0.23, see the 0.0.23-RC1, 0.0.23-RC2, 0.0.23-RC3, 0.0.23-RC4, 0.0.23-RC5, and 0.0.23-RC6 releases.

Changes:
  • Add translation keys for command arguments.
Main remaining changes that need to be made before 0.0.23 is fully released:
  • Proper PvP support (the current support doesn't leave much to customizability).
As always please report any bugs (or minor changes that may still need to be made) you find to the GitHub issue tracker or our Discord server.
----------, Feb 8, 2022

For all the other changes pertaining to 0.0.23, see the 0.0.23-RC1, 0.0.23-RC2, 0.0.23-RC3,and 0.0.23-RC4 releases.

Changes:
  • Downgrade to Java 16 (Java 17 becomes too restrictive for older version support)
    • It should be noted that ClaimChunk will always try to be up-to-date with Spigot or Minecraft API changes. Generally, new versions should support the previous release or two, but unless major issues arise, there aren't likely to be updates for older versions of the game.
  • Make some internal structural changes (Most APIs should be safe, but be sure to double-check that things still function as intended.
  • Disable debug spam being overridden in versions with an extra marker (such as snapshot or RC).
  • Add my_remaining_claims placeholder that displays the number of claims a player can make
    • (Provides the value of my_max_claims - my_claims)

Main remaining changes that need to be made before 0.0.23 is fully released:
  • Proper PvP support (the current support doesn't leave much to customizability).
As always please report any bugs (or minor changes that may still need to be made) you find to the GitHub issue tracker or our Discord server.
----------, Jan 30, 2022

This update is 1½ years in the making! There are a ton of changes that have a potential to
collide with previous settings for your servers!

Please make sure to back up your old configs and *don't delete your old ClaimChunk jar file; renaming it will be good
after obtaining this release candidate(RC). In fact, I recommend renaming your config as well, allowing the new
version to generate a new one with the correct options (otherwise, you will receive console spam when starting your server).

A release candidate is basically like a snapshot for Minecraft, meaning things are likely to change and bugs are
expected! If you run into any unexpected behavior, feel free to
create an issue to let me know.

0.0.23-RC1 Changes:
  • Update java version updated from 8 to 16 to match 1.16/1.17!
  • Fix version checker message (finally!).
  • Fixed host of annoying console errors.
  • World Profiles
    • Most protection settings are per-world now!
    • Each world has a file located in SERVER/plugins/ClaimChunk/worlds/ describing who has access in which particular chunks.
      • This file contains instructions as well as default settings that disable interactions on entities and blocks within claimed chunks (not owned by the interacting player).
      • ClaimChunk can be disabled for each world in its file.
  • Commands
    • Many of the multi-word subcommands for /claimchunk and /chunk have been separated into different words!
    • The changed commands are:
      • Admin:
        • /chunk admin override
        • /chunk admin reload
        • /chunk admin unclaim
        • /chunk admin unclaim all <PLAYER> [ALL WORLDS? true/false]
      • Player:
        • /chunk unclaim all [ALL WORLDS? true/false]
    • Added new commands:
      • /chunk show claimed
        • Shows nearby claimed chunks
        • Permission: claimchunk.show-claimed (default with claimchunk.player)
      • /chunk scan [RADIUS IN CHUNKS]
        • Counts number of nearby claims owned by other players.
        • Permission: claimchunk.scan (default with claimchunk.scan).
  • Permissions
    • claimchunk.base has been removed (finally, ugh, what was the point?).
    • Each subcommand has its own permission, outlined (for now) in the plugin.yml file.
  • Config
    • Removed much of the protection category and inserted into the world profiles.
0.0.23-RC2 Changes:
  • Update to Spigot 1.18.1
  • Add config conversion!
    • Config values under the protection category of the config should be automatically converted and removed from your config.yml files.
  • Reduce debug spam
0.0.23-RC3 Changes:
  • Update to the latest version of the bStats Metrics class
  • Fix null pointer when loading plugin and not converting old config values.
0.0.23-RC4 Changes:
  • Remove unused debug from the log section of the config file as it was unused.
  • Update to Java 17.
  • Fix plugin reloading (fingers crossed! /chunk admin reload should work!).
  • Try to fix dragon eggs teleporting from claimed chunks.
  • Add preventAdjacent list to world profiles to prevent chest connections if owned by different players (or unclaimed into claimed).
  • If a message from the messages.json file is empty, it won't be sent.

As always please report any bugs you find to the GitHub issue tracker or our Discord server. Thank you!
----------, Jan 7, 2022

Changes:
  • Fix claiming error on some servers
----------, Jul 3, 2020

This release is undertested; if you run into errors, please revert to an older release.

Changes:
  • Add more verbose errors to make determining them more easy.
  • Specify Spigot API version
  • Fix players need to rejoin the server if it's their first time playing before they are able to claim chunks
  • Add PlaceholderAPI support
  • Give OPs admin permissions for ClaimChunk
  • Fix disabled worlds
  • Fix first chunks taking money
  • Add automatic backup deletion
  • Add per-world unclaimed chunk blocking config
  • Localize more command messages
----------, Jun 30, 2020

Changes:
  • Switch chunk claiming system to a system of prerequisites which will make extending the requirements for claiming a chunk via addons possible when the system is fully completed.
  • Fix TNT exploding in chunks despite being disabled.
  • Fix players able to damage other players in claimed chunks.
  • Add /chunk give to allow players to transfer ownership of a claimed chunk to another player.
  • Prevent chunk owners from attacking other players in their own chunks.
  • Fix chunk outlines only showing two borders instead of all four.
  • Fix players unable to claim chunks.
  • Fix players unable to claim chunks.
  • Correct some default localizations.
----------, Dec 20, 2019

Changes:
  • Fix players unable to interact with blocks and entities outside of their own claims (even in unclaimed chunks).
----------, Dec 16, 2019

Changes:
  • Fix error spam on entity damage
    • Rewrite the event system to be simpler and (hopefully, fingers crossed!) work better
  • Add option to prevent fire damage and liquid spreading into claimed chunks to prevent griefing (disabled by default in the config)
  • Add option to prevent piston griefing
  • Show chunk coordinates with /chunk info in world coordinates instead of chunk coordinates
  • Fix explosions destroying claimed blocks
  • Add option to hide chunk entry alerts when the person entering a chunk is invisible
  • Fix leaving chunk message showing "self" when owned by another player and showing the user's name when owned by that user. (Flipped messages oops)
  • Fix unclaimed chunk stuff causing errors in the console when using the JSON data handler
  • Add a message when /chunk reload is used
  • Fix over-limit claims costing money despite the claim not being granted
----------, Dec 15, 2019

Changes:
  • Fix permissions!!!
  • Add /chunk adminunclaimall <player> [acrossAllWorlds]
----------, Oct 11, 2019

Changes:
  • Add bulk MySQL data system config option to prevent making a new connection every time any chunk data is accessed or updated. Enabling this in the config should fix servers running extremely slowly with ClaimChunk and MySQL
  • Remove command spam when debug spam is enabled in the config
  • Add wither protection
  • Fix MySQL connections failing
  • Fix access system when using MySQL
  • Add an automatic update check (can be disabled in the config)
  • Add per-chunk TNT protection (disable TNT protection to allow automatic farms and such to work when TNT is disabled in claimed territories in the config)
  • Switch messages system to JSON and use Bukkit color codes for way more customization
    • Also moved command descriptions into the message file
  • Fix entities not protected from projectiles fired by players without access and add some more entity protections:
    • Armor stands
    • Vehicles
    • ItemFrames
  • Allow chunk particle effects to be customized in the config
----------, Oct 10, 2019

HOTFIX

Changes:
  • Fix config exception
----------, Jul 23, 2019

HOTFIX

Changes:
  • Fix backups error
----------, Jul 22, 2019

The Data Update!

Changes:
  • MySQL SUPPORT!
    • Data conversion is enabled by default. When you enable MySQL via the config, your JSON files will be automatically converted into MySQL tables.
  • Remove support for pre-0.0.5 data!
    • If you need to upgrade from a version before 0.0.5, upgrade to 0.0.12 and launch the server to convert the data, then upgrade to 0.0.13+
  • Fix auto-complete console error message on 1.14
  • Allow other plugins to add custom data handlers (instead of just JSON and MySQL)
  • Switch to bStats for anonymous statistic collection (not really a big deal)
  • Add option to disable interaction within chunks while keeping blocks protected
----------, Jul 21, 2019

Changes:
  • Add customizable number of first free chunks
  • Fix players able to damage entities from outside of a claimed chunk
----------, Jul 15, 2019

Changes:
  • Added blocked commands in unowned territories
  • Add player name to "You cannot edit in this chunk" message (reset config for message to appear)
  • Add config option to disable protection when chunk owners are offline
  • Fix action bar exceptions
  • Fix all players being able to use /chunk adminunclaim
  • Block TnT minecart explosions when block explosions is enabled in the config
  • Add config option to disable the permissions system for simple servers without permissions plugin.
----------, Jun 15, 2019

Changes:
  • Fix action bar messages
  • Fix per-rank claim limits
  • Fix player permissions
----------, May 14, 2019

THIS UPDATE IS RECOMMENDED FOR ALL SERVERS RUNNING 0.0.8!

0.0.8 CONTAINS A BUG THAT ALLOWS ALL PLAYERS TO CLAIM CHUNKS ANYWHERE, EVEN IN PROTECTED REGIONS

Changes:
  • Add config option to disable debug spam in console.
  • Add permission "claimchunk.player" to grant basic ClaimChunk features including claiming, unclaiming, toggling access, toggling alerts, and setting their claim colors.
  • Allow admins to unclaim chunks using /chunk adminunclaim
  • Add config option to disable PvP in claimed chunks.
  • Add claim ranks to allow different permissions for different maximum chunks claimed.
  • Add an unclaim all command
  • Fix buckets not being blocked in claimed chunks for versions 1.12 and prior.
  • Add an info command
  • Allow more message customization
  • Display the cost when claiming a chunk
  • Fix players receiving a refund on their free first chunk
  • Add a list command
  • Add MCStats to track plugin usage (enabled by default; can be disabled in config)
  • Add command alias /claimchunk to make commands less ambiguous and less likely to conflict with other plugins.
  • Add a disabled worlds option in the config
----------, May 2, 2019

Changes:
  • Add WorldGuard integration
  • Add option to send messages to chunk owner when someone enters their chunks
  • Add liquid protection, crop trample protection, and lead protection
----------, Apr 19, 2019

Changes:
  • Fix chunks being free even if economy support was enabled.
  • Fix players being able to place blocks in chunks that weren't their own.
  • Fix paintings not being protected.
  • Add config option to use action bar titles instead of the standard subtitles.
  • Add /chunk access to list all players with access to the executor's chunks.
----------, Apr 16, 2019

Changes:
  • Add support for 1.13+
  • Add animal protection (can be edited in the config yaml file)
  • Add an admin override mode
  • Fix chunk name null bug
  • Fix name formatting
  • Add unclaimed chunk protection
----------, Apr 12, 2019

MAKE SURE TO RENAME YOUR OLD CONFIG
IT IS RECOMMENDED YOU DUPLICATE YOUR /plugins/ClaimChunk/data FOLDER


Changes (take a deep breath):
  • Improve /chunk help slightly.
  • Creeper and TNT prevention on claimed land Thanks to DeathsGun (configurable)
  • First chunk is free Thanks to DeathsGun (configurable)
  • Complete config rewrite RENAME YOUR OLD CONFIG
  • Data system rewritten. It is highly recommended that you duplicate your /plugins/ClaimChunk/data folder. The data should be automatically migrated to the new JSON system, but just in case, keep a copy.
  • Added /chunk auto: Toggles autoclaiming mode. If enabled, chunks the player enters will be claimed (assuming they are not claimed already)
  • Added /chunk name [name]: Sets your chunks' display name to [name], if supplied. If [name] is not supplied, the name is cleared.
  • Begin work on SQL storage, NOT IMPLEMENTED YET.
----------, Aug 4, 2017

These updates changed quite a bit. It is recommended you look at the Wiki HERE to ensure you see the changes.

0.0.3:
  • Reworked the command system completely, see the Wiki for help, or use /chunk help.
  • Tab completion now works correctly.
  • Added a limit on chunk owning. Set to 0 or less in the config to disable.
  • Fixed the economy system, it was pretty broken.
  • Now alerted when leaving chunks, as well as entering your own.
  • Chunk borders show when claiming chunks, and when /chunk show [time] is used. [time]is in seconds.
  • Fixed item frame issues.
0.0.4:
  • Added limit on how long particles can be shown for. (10 seconds)
  • Prevent NullPointerException
  • Added config option for showing particles upon claiming.
----------, Jul 26, 2017

Changes:
  • Allow different chunks to be claimed in different worlds (a big screw up on my part, oops).
  • Added support for a Dynmap API, next update should include an implementation.
  • Vault is now optional! Only use the economy if you want to.
  • Mostly complete economy support.
----------, Jul 25, 2017

See usage of this preliminary release on the download page.
----------, Jul 25, 2017

Resource Information
Author:
----------
Total Downloads: 28,883
First Release: Jul 24, 2017
Last Update: Jun 5, 2024
Category: ---------------
All-Time Rating:
65 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings