World Border Shop

Fight the world border for every block!

Donate items to get points. Hold on to points to expand the world border. Work together to unlock new biomes, find ways
around scarce resources, and compete for the top of the leaderboard!

Donating is good, dying is bad

For every item you donate, you get a point! A very convenient conversion rate, if I do say so myself.

But! If you die, you lose some of your points – 10% by default. So try not to die. Dying is bad.

Commands

The most useful commands are listed below. They’ll print help if you use them incorrectly (or don’t use the whole
command)

Permissions are the standard permission string that mods like LuckPerms
and Player Roles use to manage permissions. Default permissions are used if a
permission is unset for a player. See the Minecraft Wiki for more info
about vanilla permission levels (such as Gamemaster – level 2).

| Command | Action | Permission | Default permission |
|————————————————|———————————————————————————————————————|————————————|——————–|
| /balance, /bal | Shows how many points you have. | wbshop.bal | Allowed |
| /baltop | Shows the players with the most points and how many points they have. | wbshop.baltop | Allowed |
| /withdraw [<amount>\|all] | Withdraw points to a voucher item. Donate the item to get the points back. | wbshop.withdraw | Allowed |
| /donate | Opens a GUI to donate items in. | wbshop.donate | Allowed |
| /wbshop pay <payee> <amount> | Pay somebody some of your points. | wbshop.pay | Allowed |
| /wbshop pay <payees> <amount> | Pay multiple people amount points each. | wbshop.pay.bulk | Allowed |
| /wbshop points <targets> [query\|balance] | Show how many points anybody has. | wbshop.points.query | Gamemasters |
| /wbshop points <targets> add <points> | Grant points to one or more players. | wbshop.points.add | Gamemasters |
| /wbshop points <targets> remove <points> | Remove points from one or more players. | wbshop.points.remove | Gamemasters |
| /wbshop points <targets> set <points> | Set the balance of one or more players. | wbshop.points.set | Gamemasters |
| /wbshop config set borderFunction <function> | Set how the border determines its own size. See the “Border Function” section below. | wbshop.config.set.borderFunction | Gamemasters |
| /wbshop config set pointDivisor <divisor> | Divide points by this much before applying the border function, then round down. Useful for very large economies. | wbshop.config.set.pointDivisor | Gamemasters |
| /wbshop config set deathCost <cost> | Set how much dying costs. 10 = 10%. | wbshop.config.set.deathCost | Gamemasters |
| /wbshop config get borderFunction | Show the border function. | wbshop.config.get.borderFunction | Allowed |
| /wbshop config get pointDivisor | Show the point divisor. | wbshop.config.get.pointDivisor | Allowed |

Border Function

The border doesn’t just move at a fixed rate – it can be a lot more interesting than that! With the power of exp4j, it
can behave pretty much any way you want it to.

Create your own function by mixing functions and variables, or use one of the examples below. To find what is available
in your version, run /wbshop config help borderFunction.

| Function | Description |
|———————————————————————–|——————————————————————————————————————-|
| 100 | Start with 100×100, and stay at 100×100. Forever. |
| points/24 | 24 points to expand one block in each direction. That’s 3 logs turned into sticks. |
| max(sqrt(points),3) | Give one square block per point, but never shrink past 3×3. This is the default. |
| max(min(abs(sqrt(points)/sin(points)),(5*sqrt(points))),3) | Vary wildly between the default and five times the default. |
| max(8,floor(sqrt(x)/4)*8) | Start with a chunk, and gain a full chunk of width at a time. 1 point per 2 square blocks. |
| min(max(max(sqrt(points),3),exp(points/1000)),(6*(points^(1/1.8)))) | Grow slowly to 64×64 blocks at around 4000 points, move fast to 700×700 blocks around 6800, then grow sorta slow. |

Item Values

Every item is worth 1 point by default, so try crafting what you can into more items! A bone block has a lot of
potential – craft it into bone meal, bonemeal a double-tall flower (like a rose bush), then craft the flowers you get
into dye for a total of
1 (bone block) * 9 (bonemeal per bone block) * 1 (flower per bonemeal) * 2 (dye per flower) * 1 (point per flower) = 18 points.

If that’s not your style, you can config it! This config is global, meaning it affects all worlds run on the
configured game. Change it on your server to affect the server, or change it on your machine to affect all your
singleplayer worlds. To change it:

1. Launch the game with Worldborder Shop installed.
2. Open your config folder. If you’re playing a world on your computer, it’ll be inside .minecraft.
3. Open the wbshop folder inside that. There’s a file called global.json
4. Open global.json with a text editor (Notepad by default on Windows)
5. Add your settings. Here’s how you’d set oak logs to be worth 15 points, acacia worth 17, all other logs (including stripped ones) worth 16, and make iron worth 2 points per nugget.

{
  "itemValues": {
    "minecraft:oak_log": "15",
    "#minecraft:logs": "16",
    "minecraft:acacia_log": "17",
    "minecraft:iron_nugget": "2",
    "minecraft:iron_ingot": "18",
    "minecraft:iron_block": "162"
  }
}

1. Save the file. Don’t skip this step, basic text editors usually don’t autosave!
2. Restart the game. Don’t skip this step either!

Item values like minecraft:oak_log take precedence over tags like #minecraft:logs. If multiple tags apply, the
highest-value one is used. The order they are listed in does not matter.

Licensing

World Border Shop is licensed under MIT.

A copy of sgui is included, which is licensed under LGPLv3. A copy of LGPLv3 is included in sgui, and a copy of GPLv3 is
available in third_party_licenses. No changes were made.

A copy of Common Economy API is included, which is licensed under Apache-2.0. A copy of Apache-2.0 is included in Common
Economy API. No changes were made.

A copy of exp4j is included, which is licensed under Apache-2.0. A copy of Apache-2.0 is included in
third_party_licenses. No changes were made.

A copy of Server Translation API is included, which is licensed under MIT. A copy of the license is included in
third_party_licenses.

Translations

Translations are accepted on Codeberg Translate (a Weblate instance).
They are provided to the author under MIT-0, just in case licensing has to change in the future.