Skip to content

Xyness/SimpleClaimSystem

Repository files navigation

Minecraft 1.18+ Spigot API Version License Build

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

Software Version
Spigot 1.18+
PaperMC 1.18+
Purpur 1.18+
Folia 1.18+

Integrations

Plugin Type
Vault Economy
PlaceholderAPI Placeholders
GriefPrevention Migration
WorldGuard Region protection
Dynmap Map visualization
BlueMap Map visualization
Pl3xMap Map visualization
Floodgate Bedrock support
ItemsAdder Custom 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 22+, 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.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")
}

Maven:

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.Xyness</groupId>
    <artifactId>SimpleClaimSystem</artifactId>
    <version>1.13</version>
    <scope>provided</scope>
</dependency>

Example (sync):

SimpleClaimSystemAPI api = SimpleClaimSystemAPI_Provider.getAPI();

// Check if a chunk is claimed
boolean claimed = api.isClaimed(chunk);

// Get a player's claims
Set<Claim> claims = api.getPlayerClaims(player);

// Get claim info
String owner = api.getClaimOwnerAt(chunk);
int count = api.getAllClaimsCount();

Example (async):

// Non-blocking operations with CompletableFuture
api.unclaimAsync(claim).thenAccept(success -> {
    if (success) {
        player.sendMessage("Claim removed!");
    }
});

api.addPlayerToClaimAsync(claim, "PlayerName").thenAccept(success -> {
    // Handle result
});

Commands

Command Description Permission
/claim Claim management scs.command.claim
/claims View all claims GUI scs.command.claims
/unclaim Unclaim territory scs.command.unclaim
/scs Admin commands scs.admin
/protectedarea Protected areas management scs.admin

Links

bStats

bStats

License

This project is licensed under the MIT License.

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors