BorderSMP 1.0

BorderSMP – Chunk-Survival Territory Control

BorderSMP brings per-chunk land-claim and protection to your Minecraft SMP. Claim random safe chunks, expand territory, invite teammates, visualize borders, teleport, and integrate with Vault for economy—all configurable and zero-lag.

Key Features

• Random Safe-Chunk Claims
  • /bs create picks a random unclaimed chunk in your active world
   • Immediate border protection around your chunk
• Territory Expansion & Upgrades
  • In-game upgrade GUI (/bs upgrades) to grow your claim by +1 chunk increments
   • Animated border lines and particle effects on each expansion
• Role-Based Collaboration
   • Owner, Admin & Member roles with fine-grained permissions
  • Invite workflow: /bs invite , /bs accept , /bs leave, /bs kick
  • Promote or demote members via GUI (/bs promote )
• Seamless Teleportation & Visualization
  • /bs tp teleports you to your chunk’s spawn corner
   • Configurable visual cues: borders, particles, chat messages
• Vault Economy Integration
   • Configurabe claim cost and disband refund
   • Auto-deposit/withdraw from player balance
• Lightweight & Configurable
   • Only protects the world named in world-settings.active-world
   • Tweak costs, sizes, worlds, messages and GUI titles in config.yml
   • Zero external dependencies beyond Vault (optional)

Commands

Configuration Highlights

#  Database

database-file: "areas.db"

#  Economy settings

use-economy: true

claim-cost: 100.0

disband-refund: 50.0

#  Default area dimensions (chunks)

area-size-x: 2

area-size-z: 2

#  Invites

max-invites: 3

#  Claim generation throttle

claim-chunks-per-tick: 3

#  GUI for upgrades

gui-title: "&6Area Upgrades"

gui-rows: 3

#  Upgrade definitions

upgrades:

  chunk:

    name: "&eChunk Expand"

    price: 500.0

    material: DIAMOND

    lore:

      - "&7Expand your area by 1 chunk on each axis"

#  World & teleport settings

world-settings:

  active-world: "world"

  claim-teleport-world: "world"

  disband-teleport-world: "spawn"

#  All messages and visuals

messages:

  # ───── Common errors ────────────────────────────────────────────────

  only-players:    "&cOnly players can use this command."

  no-permission:   "&cYou don’t have permission."

  not-found:       "&cPlayer not found."

  unsafe-location: "&cYou cannot claim land over water or lava."

  # ───── Claim feedback ───────────────────────────────────────────────

  already-own:   "&cYou already own an area."

  must-own:      "&cYou must own an area to do this."

  claim-success: "&aArea claimed successfully!"

  claim-failed:  "&cUnable to claim area."

  # ───── Disband feedback ────────────────────────────────────────────

  disband-success: "&eArea disbanded."

  refund-success:  "&aYou received $%refund% refund."

  # ───── Invite feedback ─────────────────────────────────────────────

  invite-sent:      "&aInvitation sent to %target%."

  invite-already:   "&c%target% is already invited."

  invite-full:      "&cYou’ve reached your invite limit."

  invited-received: "&6You’ve been invited by %owner%. Type /bs accept %owner% to join."

  accepted-invite:  "&aInvite accepted. You can now build here."

  no-invite:        "&cNo invite found from %owner%."

  left-area:        "&eYou’ve left the shared area."

  not-in-area:      "&cYou are not part of any area."

  kicked:           "&c%target% was kicked from your area."

  kicked-you:       "&cYou’ve been kicked from %owner%’s area."

  # ───── Members list ────────────────────────────────────────────────

  members-header: "&6Members in this area:"

  # ───── Upgrade commands ─────────────────────────────────────────────

  upgrades-open:   "&aOpening upgrade menu..."

  upgrade-success: "&aArea expanded successfully!"

  upgrade-fail:    "&cNot enough money to upgrade."

  # ───── Promotion GUI ────────────────────────────────────────────────

  promote-success: "&a%player% is now %role% in this area!"

  # ───── Visualization: Claim ────────────────────────────────────────

  claim:

    particle:        HAPPY_VILLAGER

    border-duration: 6

    title:

      title:    "&aClaim Created!"

      subtitle: "&eEnjoy your territory"

      fade-in:  5

      stay:     40

      fade-out: 5

    actionbar: "&a&l{owner}&r claimed chunk at &e(&c{cx},&c{cz}&r)"

  # ───── Visualization: Upgrade ─────────────────────────────────────

  upgrade:

    particle:        HAPPY_VILLAGER

    border-duration: 5

    title:

      title:    "&aUpgrade Complete!"

      subtitle: "&eBorders grew larger"

      fade-in:  5

      stay:     40

      fade-out: 5

    actionbar: "&a&l{owner}&r area is now &e{sizeX}×{sizeZ}&r chunks"

  # ───── Teleport (/bs tp) ──────────────────────────────────────────

  tp-world-notfound: "&cClaim world not found."

  tp:

    particle:        HAPPY_VILLAGER

    border-duration: 5

    title:

      title:    "&aWelcome Home!"

      subtitle: "&eBack in your territory"

      fade-in:  5

      stay:     40

      fade-out: 5

    actionbar: "&aTeleported to chunk &e{cx},{cz}&a!"

BorderSMP is ideal for chunk-survival servers that want strategic, team-based land control without server lag or complexity.