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
- Stand in the chunk you want to claim
- Run /team claim
- Confirm you have enough money in team balance
- Chunk is now protected for your team!
Managing Protection
- Stand in your claimed chunk
- Run /team grief
- Click items in GUI to toggle protection settings
- Changes save automatically
Purchasing Claim Slots
- Ensure purchasable-claim-slots is enabled
- Run /team buyclaimslot
- Pay the slot cost from team balance
- 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
- Install BetterTeams 5.0.0+ - Download Here
- Place BTClaimsExtension.jar in plugins/BetterTeams/extensions/
- Restart your server
- Configure claim-config.yml to your preferences
- 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