Upgradable World Borders icon

Upgradable World Borders -----

Upgradable World Borders




KushWorldBorders_Logo.png

KushWorldBorders
Community-funded upgradeable world borders — with PlaceholderAPI support
Minecraft 1.21.4 · Spigot / Paper · Free
[HR][/HR]
⬡ What is this?
KushWorldBorders turns your server's world border into a community achievement. Players pool their in-game money together to push the border further and further out — with the Nether and End borders automatically kept in sync. Every time an upgrade target is hit, a server-wide title fires to celebrate. Every statistic is exposed through PlaceholderAPI so you can display live progress in holograms, scoreboards, tab lists, or anywhere else.
Configure your levels once. Let your players do the rest.

[HR][/HR]
✦ Features
  • Multi-level border system — Define as many upgrade tiers as you want in config.yml. Each level has its own size, upgrade cost, and damage settings.
  • Community donation pool — Players run /kwb donate <amount> to contribute money toward the next upgrade.
  • 3-dimension sync — Overworld, Nether, and End borders all update together. The Nether border is always automatically set to overworld ÷ 8 (1 nether block = 8 overworld blocks). The End has its own configurable size per level.
  • Upgrade title broadcast — When a level is reached, a fully configurable title + subtitle is sent to every online player.
  • PlaceholderAPI — 20+ placeholders — Border sizes, pool total, upgrade cost, amount needed, progress %, top donors, player donation totals, and more.
  • Progress bar placeholder%kwb_progress_bar% gives a fully configurable text progress bar. Customise the characters, colours, brackets, and length. Use %kwb_progress_bar_20% for a custom length on the fly.
  • Donor leaderboard — Per-player donation tracking with top-10 leaderboard placeholders for holograms.
  • Vault integration — Hooks into any Vault-compatible economy. Degrades gracefully if Vault is not installed.
  • Persistent data — Level, pool total, and player donations survive server restarts via data.yml.
  • Tab completion — All subcommands and level numbers auto-complete.
[HR][/HR]
⚙ How it works
1. Configure your levels
Open config.yml and define your border levels. Each level needs a size (overworld diameter in blocks) and a cost — the cumulative pool total required to reach it.
2. Players donate
Players run /kwb donate <amount>. The money is withdrawn via Vault and added to the shared community pool. A configurable broadcast message notifies the server.
3. Automatic upgrade
When the pool total hits the next level's cost threshold, the border upgrades instantly across all three dimensions. A title + subtitle is broadcast to every online player.
4. Display with holograms
Use any PAPI-compatible plugin (DecentHolograms, CMI, HolographicDisplays, etc.) and paste the placeholder lines into your hologram. Stats update live.

[HR][/HR]
Commands
Command Description Permission
/kwb donate <amount> Donate money to the community border pool kwb.donate
/kwb status View current border level, pool total, and progress kwb.status
/kwb help Show the help menu kwb.use
/kwb reload Reload config and re-apply borders kwb.reload
/kwb setlevel <level> Manually force a specific border level kwb.setlevel
/kwb reset Reset the pool and return border to level 1 kwb.reset

Aliases: /worldborder, /kwb
[HR][/HR]
PlaceholderAPI Placeholders
Border info
  • %kwb_border_size% — Overworld border diameter in blocks
  • %kwb_border_size_nether% — Nether border diameter (overworld ÷ 8)
  • %kwb_border_size_end% — End border diameter
  • %kwb_level% — Current border level number
  • %kwb_level_max% — Maximum configured level
  • %kwb_is_maxed%true or false
  • %kwb_currency% — Currency symbol from config
Pool & upgrade progress
  • %kwb_pool_total% — Formatted pool total (e.g. $12,500.00)
  • %kwb_pool_total_raw% — Raw pool total
  • %kwb_upgrade_cost% — Formatted cost for the next level
  • %kwb_upgrade_cost_raw% — Raw cost for next level
  • %kwb_upgrade_needed% — Formatted amount still needed
  • %kwb_upgrade_needed_raw% — Raw amount still needed
  • %kwb_upgrade_percent% — Progress % toward next level (2dp, e.g. 67.34)
  • %kwb_upgrade_percent_int% — Progress % as integer (e.g. 67)
Progress bar
  • %kwb_progress_bar% — Progress bar using default length from config
  • %kwb_progress_bar_20% — Progress bar with custom length (replace 20 with any number 1–100)
Characters, colours, brackets, and default length are all configurable under progress-bar: in config.yml.
Player donations
  • %kwb_player_donated% — Formatted total this player has donated
  • %kwb_player_donated_raw% — Raw total this player has donated
Top donors (#1–#10)
  • %kwb_top_donor_1_name% — Name of the #1 top donor
  • %kwb_top_donor_1_amount% — Formatted amount donated by #1
  • %kwb_top_donor_1_amount_raw% — Raw amount donated by #1
  • Same pattern for ranks 2 through 10
[HR][/HR]
Example hologram
Using DecentHolograms:
Code (Text):

&6&l⬡ WORLD BORDER
&8──────────────────────
&7Level: &a%kwb_level%&8/&a%kwb_level_max%
&7Overworld: &a%kwb_border_size% blocks
&7Nether:    &a%kwb_border_size_nether% blocks
&7End:       &a%kwb_border_size_end% blocks
&8──────────────────────
&7Pool:  &b%kwb_pool_total%
&7Next:  &b%kwb_upgrade_cost%
&7Need:  &b%kwb_upgrade_needed%
%kwb_progress_bar% &7%kwb_upgrade_percent_int%%
&8──────────────────────
&6&l★ TOP DONORS
&e#1 &f%kwb_top_donor_1_name% &8— &a%kwb_top_donor_1_amount%
&e#2 &f%kwb_top_donor_2_name% &8— &a%kwb_top_donor_2_amount%
&e#3 &f%kwb_top_donor_3_name% &8— &a%kwb_top_donor_3_amount%
 
[HR][/HR]
Installation
  1. Download KushWorldBorders.jar using the button above
  2. Drop it into your server's plugins/ folder
  3. Make sure Vault and PlaceholderAPI are also installed (recommended)
  4. Start or restart the server — plugins/KushWorldBorders/config.yml is created automatically
  5. Open config.yml and set worlds.overworld, worlds.nether, and worlds.end to match your world folder names
  6. Run /kwb reload — done!
[HR][/HR]
Dependencies
Plugin Required? Notes
Spigot / Paper 1.21.4 Required Other versions may work but are untested
Vault Soft Without it, donations are tracked but no money is deducted
PlaceholderAPI Soft Without it, all %kwb_*% placeholders are unavailable

[HR][/HR]
Changelog
v1.0.0 — Initial release
  • Multi-level configurable world borders for Overworld, Nether and End
  • Community donation pool with Vault economy integration
  • 20+ PlaceholderAPI placeholders
  • Configurable text progress bar placeholder (%kwb_progress_bar%)
  • Per-player donation tracking and top-10 donor leaderboard
  • Server-wide title + subtitle broadcast on every upgrade
  • Automatic Nether border scaling (overworld ÷ 8)
  • Persistent data.yml storage survives restarts
  • Full tab-completion on all commands
[HR][/HR]

Found a bug or have a suggestion? Post below or open an issue on GitHub.
If you enjoy the plugin, please leave a review — it really helps! ⭐

Resource Information
Author:
----------
Total Downloads: 5
First Release: May 24, 2026
Last Update: May 24, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings