Getting Started

Overview

SimpleClaimSystem V2 (SCS2) is the premium version of SimpleClaimSystem — a complete rewrite from the ground up. While the free version provides basic chunk claiming with around 30 toggle settings, V2 expands this to 128 granular permissions, 70 claim flags, a full role system with custom roles, public warps (with optional Vault visit fee), per-world configuration, mob and item stackers, an admin web dashboard, Discord webhooks, audit logs, an optional Redis cache layer, and much more.

If you are migrating from the free version (V1), see the Importing from V1 section below. All your claims and player data can be transferred.

Key differences from V1

FeatureV1 (Free)V2 (Premium)
Permissions per role~30 toggle settings128 granular permissions
Claim flagsBasic70 flags (explosions, fire, nature, spawning, etc.)
Role systemMembers / VisitorsVisitor, Member, Moderator, Owner + custom roles
World configurationGlobalPer-world (mode, border, chunk limits, stackers)
Mob & Item stackerNoYes, per world
World borderNoYes, per world
Redis cache layerNoYes (optional)
Discord webhooksNoYes
Web dashboardNoYes
Audit logsNoYes
SoundsLimited38 configurable sounds
Import supportGriefPreventionV1, GriefPrevention, Lands, Towny
Protected areas (/parea)YesYes, with full role support

Requirements

  • Server software: Spigot, Paper, Purpur, or Folia
  • Minecraft version: 1.21 or higher
  • packetevents >= 2.10.1 — required dependency (used for claim visualization particles and map rendering)
  • Permissions plugin — LuckPerms is strongly recommended for managing 130+ permissions and limit nodes
  • Vault + economy plugin — optional, required only if you want claim buying/selling and chunk costs

packetevents is mandatory. Without it, the plugin will not start. Download it from Modrinth and place it in your /plugins folder alongside SimpleClaimSystem.

Installation

  1. Download SimpleClaimSystem from BuiltByBit.
  2. Download packetevents (>= 2.10.1) from Modrinth.
  3. Place both JAR files into your server's /plugins folder.
  4. Start (or restart) your server — do not use /reload.
  5. The plugin generates its configuration in /plugins/SimpleClaimSystem/.
  6. Edit config.yml to configure your database, worlds, economy, and other settings.
  7. Use /scs reload to apply configuration changes without restarting.

On first startup, the plugin creates a local SQLite database. For larger servers switch to MySQL for better concurrent-write performance. Redis is available as an optional third caching layer (Caffeine → Redis → DB) when Caffeine alone is not sufficient.

Importing from V1

If you are upgrading from the free version of SimpleClaimSystem, you can import all your existing claims and player data into V2:

  1. Keep the storage.db file from V1 in the /plugins/SimpleClaimSystem/ folder.
  2. Optionally clean up old V1 files: delete the guis/ and langs/ directories and remove the old config.yml.
  3. Start the server with V2 installed (or run /scs reload if already running).
  4. Run /scs importFromV1 to import all claims and players.
  5. Restart the server to finalize the migration.

Some minor errors may occur during import because V1 data is not 100% compatible with V2 structures (e.g., the old toggle settings are mapped to the new permission system). These can be safely ignored.

Importing from other plugins

V2 also supports importing claims from other land protection plugins:

  • /scs importFromGriefPrevention — Import all GriefPrevention claims
  • /scs importFromLands — Import all Lands claims
  • /scs importFromTowny — Import all Towny towns as claims

After any import, restart your server to ensure everything is properly loaded.

Creating Your First Claim

Once installed, players can start claiming land immediately:

  1. Stand in the chunk you want to claim.
  2. Run /claim to claim that chunk.
  3. Optionally use /claim radius <radius> to claim multiple chunks at once.
  4. Use /claim map to see a visual map of nearby claims.
  5. Use /claim see to visualize claim boundaries with particles.
  6. Use /claim menu to open the main claim GUI where you can manage permissions, flags, members, and more.
Tip: Use /claim list to open a GUI listing all your claims, or /claims to browse all server claims.
Claiming