BetterTeam Claim Extension icon

BetterTeam Claim Extension -----

BetterTeam Claim basic land claim system using team balance



BTClaims Extension
Advanced Chunk Claiming System for BetterTeams

Version 1.2 | Requires BetterTeams 5.0.0+


Overview

BTClaims Extension is a powerful chunk-based land claiming addon for BetterTeams that allows teams to protect their territory, manage grief protection, and control land ownership through an economy-based system.

Key Highlights:
  • Economy-based claiming system
  • ️ Comprehensive grief protection
  • Flexible claim limits (static or purchasable)
  • Per-chunk protection settings
  • Visual chunk boundaries
  • Highly configurable


⚠️ Dependencies

Required:
  • BetterTeams 5.0.0+ - Download Here
  • Spigot/Paper 1.21+ - Recommended 1.21+

Optional:
  • PlaceholderAPI - For placeholder support
  • Vault - Compatible economy plugin (used by BetterTeams)


✨ Features

Land Claiming
  • Claim chunks for your team using team balance
  • Only team admins and owners can manage claims
  • Configurable claim costs and refund percentages
  • Distance restrictions from other teams' claims
  • Visual chunk borders when claiming/unclaiming

Grief Protection
  • TNT explosion control
  • Creeper explosion protection
  • Wither explosion management
  • Other explosions (Ghasts, End Crystals, Respawn Anchors)
  • Chest access protection
  • Interaction control (doors, buttons, levers, trapdoors)
  • ⚙️ Piston push/pull protection
  • Mob griefing control (Endermen block movement, etc.)

Claim Management
  • GUI-based claim list viewer
  • GUI-based grief settings per claim
  • Teleport to your claims
  • Easy claim removal with refunds
  • Automatic cleanup on team disband

Economy System
  • Pay to claim chunks from team balance
  • Configurable refund percentage on unclaim
  • Optional purchasable claim slot system
  • Buy additional claim slots beyond starter amount


Commands

Player Commands
Code (Text):
/team claim               - Claim the chunk you're standing in
/team unclaim             - Unclaim the chunk you're standing in
/team claimlist           - View all your team's claims (GUI)
/team claims              - Alias for claimlist
/team grief               - Open grief protection settings (must be in your claim)
/team buyclaimslot        - Purchase an additional claim slot (if enabled)
/team buyslot             - Alias for buyclaimslot
/team border             - Toggle on/off border visual effects
Permission Requirements:
  • All commands require player to be in a team
  • Claim management requires ADMIN or OWNER rank in team
  • Grief settings require ADMIN or OWNER rank in team


⚙️ Configuration

claim-config.yml

Code (Text):
# BTClaimsExtension Configuration
settings:
  database-type: "sqlite" # Only sqlite supported

  # Economy settings
  claim-cost: 1000.0 # Cost to claim a chunk (uses team balance)
  unclaim-refund-percentage: 50 # Percentage refunded when unclaiming (0-100)

  # Claim limits
  # Set purchasable-claim-slots to true to allow teams to buy more claim slots
  # Set to false to use static max-claims-per-team limit
  purchasable-claim-slots: false # Enable/disable purchasable claim slots system

  starter-claims-per-team: 10 # Initial claim slots every team gets
  claim-slot-cost: 5000.0 # Cost to purchase 1 additional claim slot (uses team balance)
  max-purchasable-slots: 50 # Maximum total slots a team can purchase (-1 for unlimited)

  # Legacy setting (only used when purchasable-claim-slots is false)
  max-claims-per-team: 10 # Maximum chunks a team can claim (-1 for unlimited)

  min-distance-from-other-teams: 3 # Minimum chunks distance from other team's claims (0 to disable)

  # Default grief protection
  allow-tnt-default: false
  allow-creeper-default: false
  allow-wither-default: false
  allow-other-explosions-default: false # Ghasts, End Crystals, Respawn Anchors
  allow-chest-access-default: false
  allow-interact-default: false # Doors, buttons, levers
  allow-piston-default: false
  allow-mob-grief-default: false # Endermen, etc.

messages:
  no-team: "§cYou must be in a team to do this!"
  no-permission: "§cOnly team admins can manage claims!"
  claimed: "§a✓ Chunk successfully claimed!"
  unclaimed: "§e✓ Chunk successfully unclaimed!"
  protected: "§cThis land is protected by another team!"
  insufficient-funds: "§cYour team doesn't have enough money! Need: §f${cost}"
  max-claims-reached: "§cYour team has reached the maximum claim limit! (§f{max}§c)"
  max-claims-reached-purchasable: "§cYour team has no available claim slots! §7(§f{current}§7/§f{max}§7) §ePurchase more with §f/team buyclaimslot"
  too-close: "§cThis chunk is too close to another team's claim! Minimum distance: §f{distance} chunks"
  claim-list-title: "§8Team Claims"
  claim-slot-purchased: "§a✓ Claim slot purchased successfully!"
  claim-slot-info: "§aYour team now has §f{total} §aclaim slots!"
  max-slots-reached: "§cYour team has reached the maximum purchasable claim slots! (§f{max}§c)"
  claim-slot-cost-message: "§7Cost: §f${cost}"
Configuration Modes:

Purchasable Slots Mode (purchasable-claim-slots: true)
  • Teams start with starter-claims-per-team free slots
  • Teams can purchase more slots with /team buyclaimslot
  • Each slot costs claim-slot-cost from team balance
  • Maximum purchasable limited by max-purchasable-slots
  • Great for progression servers!

Static Limit Mode (purchasable-claim-slots: false)
  • All teams have fixed max-claims-per-team limit
  • No slot purchasing available
  • Simpler system for casual servers


PlaceholderAPI Support

Available Placeholders

Basic Placeholders:
Code (Text):
%btclaims_total%          - Current claimed chunks
%btclaims_max%            - Maximum claim slots (adapts to config mode)
%btclaims_available%      - Available slots remaining
%btclaims_claim_cost%     - Cost to claim one chunk
Purchasable System Placeholders:
Code (Text):
%btclaims_starter%        - Starter claim slots
%btclaims_purchased%      - Number of purchased slots
%btclaims_max_purchasable% - Maximum purchasable slots
%btclaims_slot_cost%      - Cost to buy one claim slot
Example Usage:
Code (Text):
Claims: %btclaims_total%/%btclaims_max%
Available: %btclaims_available%
Purchased Slots: %btclaims_purchased%/%btclaims_max_purchasable%

Usage Examples

Claiming Land
  1. Stand in the chunk you want to claim
  2. Run /team claim
  3. Confirm you have enough money in team balance
  4. Chunk is now protected for your team!

Managing Protection
  1. Stand in your claimed chunk
  2. Run /team grief
  3. Click items in GUI to toggle protection settings
  4. Changes save automatically

Purchasing Claim Slots
  1. Ensure purchasable-claim-slots is enabled
  2. Run /team buyclaimslot
  3. Pay the slot cost from team balance
  4. Your team's max claims increases by 1!


️ Database

BTClaims uses SQLite for data storage:
  • claims.db - Stores all claim data and protection settings
  • Tables: claims, purchased_slots
  • Automatic database migration and column additions
  • Async save operations for performance


Installation

  1. Install BetterTeams 5.0.0+ - Download Here
  2. Place BTClaimsExtension.jar in plugins/BetterTeams/extensions/
  3. Restart your server
  4. Configure claim-config.yml to your preferences
  5. Reload with /teama reload or restart again

Optional Dependencies:
  • Install PlaceholderAPI for placeholder support
  • Install Vault compatible economy plugin (if not already installed)


Messages

All messages are customizable in claim-config.yml:
Code (Text):
messages:
  no-team: "§cYou must be in a team to do this!"
  no-permission: "§cOnly team admins can manage claims!"
  claimed: "§a✓ Chunk successfully claimed!"
  unclaimed: "§e✓ Chunk successfully unclaimed!"
  protected: "§cThis land is protected by another team!"
  insufficient-funds: "§cYour team doesn't have enough money! Need: §f${cost}"
  max-claims-reached: "§cYour team has reached the maximum claim limit!"
  max-claims-reached-purchasable: "§cNo available claim slots! Purchase more with /team buyclaimslot"
  claim-slot-purchased: "§a✓ Claim slot purchased successfully!"

❓ FAQ

Q: Can individual players claim land?
A: No, only teams can claim land. Players must be team admins/owners to manage claims.

Q: What happens to claims when a team disbands?
A: All claims and purchased slots are automatically deleted from the database.

Q: Can I have unlimited claims?
A: Yes! Set max-claims-per-team or max-purchasable-slots to -1.

Q: Does it work with other claim plugins?
A: BTClaims is independent but may conflict with other claim systems. Use one or the other.

Q: Can I change from static to purchasable mode?
A: Yes! Just change purchasable-claim-slots and restart. Existing data is preserved.

Q: What Minecraft versions are supported?
A: Requires Spigot/Paper 1.21+. Recommended: 1.21.5+ for best compatibility.


Support

Found a bug or need help?
  • Check the logs in console for errors
  • Verify BetterTeams 5.0.0+ is installed correctly
  • Ensure database permissions are correct
  • Report issues with full error logs
  • Include your server version and BetterTeams version


Thank you for using BTClaims Extension!
Built for BetterTeams | Chunk-based protection made easy

Compatible with BetterTeams 5.0.0+ | Get BetterTeams
Resource Information
Author:
----------
Total Downloads: 59
First Release: Jan 9, 2026
Last Update: Mar 19, 2026
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings