🛡️ Border — High-Performance Custom World Border Engine

Border is a next-generation, high-performance world border management plugin engineered for modern Minecraft servers (Paper / Purpur 1.20+).

Unlike standard worldborder solutions, Border introduces custom animated shader textures, realistic collision pushback physics, and a built-in HTTP daemon that automatically delivers the client resource pack upon join — completely eliminating the need for third-party hosting or external CDNs.

---

✨ Key Features

• 🎨 Custom Shader Textures — Render animated honeycomb shader barriers with smooth wave effects or seamlessly switch back to classic vanilla worldborder walls.
• ⚡ Dynamic In-Game Controls — Smoothly shrink, expand, set radius, relocate center coordinates over time, and toggle geometric shapes (circle vs. square) in real time.
• 📦 Built-in Resource Pack Server — Integrated lightweight HTTP micro-server automatically streams pack.zip to connecting players with zero external setup.
• 🛡️ Boundary Physics & Knockback — Configurable pushback velocity force, strict anti-exit barrier prevention, particle bursts, sound cues, and actionbar alerts.
• ✨ Universal Color & Text Engine — Full native support for Hex codes (#0088FF), Adventure MiniMessage tags, RGB, and legacy formatting (&c, &l) across standing, shrinking, and expanding states.
• 📊 PlaceholderAPI Integration — Comprehensive real-time placeholders for your scoreboard, tab list, actionbar, and bossbars.
• 🚀 Zero Tick Overhead — Highly optimized asynchronous routines designed for high-traffic networks, SMP events, and competitive UHC tournaments.

---

💻 Commands & Permissions

Command	Description	Permission	Default
/border create <radius>	Creates a world border with the specified radius	dominus.border.command.create	OP
/border shrink <radius>	Smoothly shrinks the border to the target radius	dominus.border.command.shrink	OP
/border expand <radius>	Smoothly expands the border outwards to the target radius	dominus.border.command.expand	OP
/border set <radius>	Instantly sets the border to the given radius	dominus.border.command.set	OP
/border move <x> <z> <time>	Moves the center to X/Z coordinates over time	dominus.border.command.move	OP
/border type <circle|square>	Toggles border geometry between circle and square	dominus.border.command.type	OP
/border texture <vanilla|custom>	Toggles between vanilla texture and custom shaderpack	dominus.border.command.texture	OP
/border tp	Teleports you directly to the center of the active border	dominus.border.command.tp	OP
/border clear	Completely removes and clears the active border	dominus.border.command.clear	OP
/border info	Displays current border metrics, radius, and status	dominus.border.command.info	OP
/border pack	Dispatches the resource pack prompt to all online players	dominus.border.command.pack	OP
/border reload	Reloads config.yml and messages.yml without restart	dominus.border.command.reload	OP

🔑 Admin Wildcard: dominus.border.* grants access to all plugin commands and administrative features.

---

🧩 PlaceholderAPI (PAPI)

Placeholder	Description	Example
%border_radius%	Current active border radius in blocks	250.0
%border_status%	Current state of the world border	Idle / Shrinking / Expanding
%border_type%	Active border shape	Circle / Square
%border_texture%	Active visual mode	Custom / Vanilla
%border_shrink_time%	Remaining countdown for active shrink phase	01:45
%border_shrink_radius%	Target radius for current shrink action	100
%border_shrink_status%	Shrinking state indicator	active / idle
%border_expand_time%	Remaining countdown for active expand phase	02:30
%border_expand_radius%	Target radius for current expand action	500
%border_expand_status%	Expanding state indicator	active / idle

---

⚙️ Configuration (config.yml)

colors:
  idle: "#0088FF"
  shrinking: "#FF2222"
  expanding: "#22FF22"

defaults:
  type: "honeycomb"
  shape: "circle"
  radius: 100.0
  animation: true

physics:
  pushback-enabled: true
  pushback-force: 1.4
  prevent-exit: true
  pushback-in-creative: true
  op-bypass: false
  bounce-sound: "ENTITY_PLAYER_ATTACK_KNOCKBACK"
  bounce-particle: "WITCH"
  bounce-message: "&c&lBORDER &8» &7You cannot leave the safe zone!"
  damage-outside: false
  damage-amount: 2.0

resource-pack:
  enabled: true
  auto-send: true
  host: "127.0.0.1"
  port: 25585
  prompt: "&b&lBorder &8» &7Please accept the resource pack for the custom world border!"
  required: false