Skip to content

Repository files navigation

SimpleClaimSystem

Minecraft 1.18+Spigot APIVersionLicenseBuild

SimpleClaimSystem

A powerful and fully configurable chunk-based land protection plugin for Minecraft servers. Players can claim, manage, and customize their territories with an intuitive GUI system.

Features

  • Chunk-based claiming with multi-chunk support, radius claiming, and merging
  • Fully configurable GUIs for claim management, settings, members, bans, and more
  • Per-claim permissions for visitors, members, and natural events (30+ settings)
  • Economy integration with Vault for claim purchasing and selling
  • Map visualization via Dynmap, BlueMap, and Pl3xMap
  • Bedrock Edition support through Floodgate/Geyser
  • Multi-platform - built on Spigot API, fully compatible with Paper, Purpur, and Folia
  • Multi-language support
  • Auto-claim & auto-map modes for quick territory expansion
  • Protected areas for server-managed regions
  • PlaceholderAPI expansion for scoreboards and chat
  • Auto-purge system for inactive player claims
  • Complete API with sync and async methods for developers
  • GriefPrevention migration support

Compatibility

SoftwareVersion
Spigot1.18+
PaperMC1.18+
Purpur1.18+
Folia1.18+

Integrations

PluginType
VaultEconomy
PlaceholderAPIPlaceholders
GriefPreventionMigration
WorldGuardRegion protection
DynmapMap visualization
BlueMapMap visualization
Pl3xMapMap visualization
FloodgateBedrock support
ItemsAdderCustom items

Installation

  1. Download the latest release from Releases
  2. Place the JAR file in your server's plugins/ folder
  3. Restart the server
  4. Configure plugins/SimpleClaimSystem/config.yml to your needs

Building from source

Requirements: Java 21+, Gradle 8.9+

git clone https://github.com/Xyness/SimpleClaimSystem.git
cd SimpleClaimSystem
./gradlew shadowJar

The output JAR will be at build/libs/SimpleClaimSystem-1.13.0.8.jar.

API Usage

Add SimpleClaimSystem as a dependency via JitPack:

Gradle (Kotlin DSL):

repositories {
maven("https://jitpack.io")
}
dependencies {
compileOnly("com.github.Xyness:SimpleClaimSystem:1.13.0.8")
}

Maven:

<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.Xyness</groupId>
<artifactId>SimpleClaimSystem</artifactId>
<version>1.13.0.8</version>
<scope>provided</scope>
</dependency>

Example (sync):

SimpleClaimSystemAPIapi = SimpleClaimSystemAPI_Provider.getAPI();
// Check if a chunk is claimedbooleanclaimed = api.isClaimed(chunk);
// Get a player's claimsSet<Claim> claims = api.getPlayerClaims(player);
// Get claim infoStringowner = api.getClaimOwnerAt(chunk);
intcount = api.getAllClaimsCount();

Example (async):

// Non-blocking operations with CompletableFutureapi.unclaimAsync(claim).thenAccept(success -> {
if (success) {
player.sendMessage("Claim removed!");
}
});
api.addPlayerToClaimAsync(claim, "PlayerName").thenAccept(success -> {
// Handle result
});

Commands

CommandDescriptionPermission
/claimClaim managementscs.command.claim
/claimsView all claims GUIscs.command.claims
/unclaimUnclaim territoryscs.command.unclaim
/scsAdmin commandsscs.admin
/protectedareaProtected areas managementscs.admin

Links

bStats

bStats

License

This project is licensed under the MIT License.

About

TownStory 领地系统

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages