# JustLevelBorder
\nby BinJustDev
\n## What this project does<\/p>\n
JustLevelBorder is a lightweight plugin for Minecraft Java Edition (1.21.x) that controls the World Border size based on player XP levels.<\/p>\n
The world border is centered at (0.5, 0.5) in the main world and automatically grows or shrinks as players gain or lose XP levels.
\nThe border size follows a simple formula:
\n“`
\nBorder Size = 1 + (Level \u00d7 blocks-per-level)
\n“`
\n**Depending on configuration**, the border can be:<\/p>\n
Driven by the highest current level of all players (even if they are offline), or<\/p>\n
Fully shared, meaning all online players have the exact same XP bar (level and progress are synchronized in real time).<\/p>\n
Level loss through death, enchanting, or anvil usage is detected, stored, and reflected in the world border size accordingly.<\/p>\n
## Why you should download this plugin
\nJustLevelBorder is ideal if you want:<\/p>\n
– A progression-based survival challenge<\/p>\n
– A server where XP directly controls exploration<\/p>\n
– A minimal plugin with no databases and no dependencies<\/p>\n
– Persistent progression that does not reset when players go offline<\/p>\n
– Optional shared XP gameplay<\/p>\n
The plugin is intentionally kept simple and transparent, making it easy to configure, extend, or audit.<\/p>\n
## Please read this before using the plugin:
\n– The world border is server-side and affects all players in the main world.
\n– Player levels are stored persistently in saved_levels.yml. This file represents the current levels, not all-time highs.
\n– When use-shared-levels is enabled: All online players share the same XP level and XP bar. The shared level initializes from the highest stored level, even if that player is offline.
\n– On death, players are reset to level 0 (if enabled), and the border may shrink.
\n– Border changes are animated smoothly (configurable).
\n– The plugin never logs level or border changes to the server console.
\n– Chat notifications for level loss are optional and can be toggled in-game.<\/p>\n
**The plugin currently affects only the overworld (first loaded world).**
\nI’m working on supporting the nether and end soon.
\n## How to download and install<\/p>\n
1. Download the JustLevelBorder.jar<\/p>\n
2. Place the jar into your server\u2019s plugins\/ folder<\/p>\n
3. Start or restart the server<\/p>\n
4. Edit config.yml to your liking<\/p>\n
5. Run \/justlevelborder reload to apply changes<\/p>\n
## Commands<\/p>\n
“`
\n\/justlevelborder
\n\/levelborder
\n“`
\nShows a short explanation of the plugin.
\n“`
\n\/justlevelborder status
\n“`
\nDisplays the current plugin state (mode, highest level, border size, animation time, notifications).
\n“`
\n\/justlevelborder reload
\n“`
\nReloads config.yml and saved_levels.yml and immediately applies the values.
\n“`
\n\/justlevelborder notifications on|off
\n“`
\nEnables or disables chat notifications for level loss.<\/p>\n
## Config
\n“`
\ncenter-x: 0.5
\ncenter-z: 0.5
\n“`
\nThese values define the center point of the world border in the main world.
\n0.5, 0.5 centers the border exactly on the middle of the (0,0) block.
\nYou can change these values if you want the border centered elsewhere.
\n“`
\nuse-shared-levels: false
\n“`
\nControls how player XP levels are handled.
\nfalse (default):
\nEach player keeps their own XP level.
\nThe world border is based on the highest current level of all players, even if that player is offline.<\/p>\n
true:
\nAll online players share the same XP level and XP progress bar.
\nWhen one player gains or loses XP, everyone updates instantly.
\nThe shared level initializes from the highest stored level, preventing offline players from losing progress.
\n“`
\nlose-progress-on-death: true
\n“`
\nControls what happens when a player dies.
\ntrue (default):
\nThe player is reset to level 0 on death.
\nThis value is saved persistently.
\nThe world border may shrink depending on the new highest level.<\/p>\n
false:
\nThe player keeps their level on death.
\nNo border change is triggered by death alone.
\n“`
\nblocks-per-level: 2
\n“`
\nDefines how much the world border grows per XP level.
\nHigher values make progression faster; lower values make the challenge more challenging.
\n“`
\nborder-transition-seconds: 1
\n“`
\nControls how long the world border takes to resize.
\n0 \u2192 instant change
\n1 or higher \u2192 smooth animation in seconds
\nThis affects all border updates, including growth and shrinking.
\n“`
\nnotifications:
\n enabled: true
\n “`
\n Controls whether players see chat messages when someone loses XP levels.<\/p>\n
true (default):
\nRed chat messages are sent to all players.
\nMessages explain who lost levels, why, and whether the border changed.<\/p>\n
false:
\nNo chat messages are sent.
\nBorder logic still works normally.
\n “`
\ncauses:
\n anvil: “anvil”
\n enchanter: “enchanter”
\n dying: “dying”
\n other: “other”
\n“`
\nThese strings are used in notification messages to describe why a player lost levels.
\nExamples:
\nUsing an anvil \u2192 “anvil”<\/p>\n
Enchanting items \u2192 “enchanter”<\/p>\n
Player death \u2192 “dying”<\/p>\n
Any other reason \u2192 “other”<\/p>\n
You can customize these freely.<\/p>\n
## **PLEASE NOTE:**
\nThe plugin is actively being worked on, so please be aware that things may change in the future.
\nIf you encounter any issues please join my discord or report the bug to the GitHub issue tracker.<\/p>\n
Thanks for playing JustLevelBorder. \u2764\ufe0f<\/p>\n
BinJustDev out.<\/p>\n","protected":false},"excerpt":{"rendered":"
For every xp level you get, the worldborder will increase<\/p>\n","protected":false},"featured_media":89229,"template":"","meta":{"_minecraft_slug":"justlevelborder","_minecraft_project_id":"bRHWCohn","_minecraft_author":"binjustdev","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":66,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"justlevelborder.zip","_minecraft_size_bytes":27744,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:43:51.542319Z","_minecraft_date_created":"2026-01-25T22:48:17.626212Z","_minecraft_date_modified":"2026-01-25T16:07:42.410006Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/justlevelborder","_minecraft_icon_attachment_id":89229,"_minecraft_imported_at":"2026-06-05T02:20:48+00:00","_minecraft_import_hash":"1e7d0680b596d15ac3e304933c02d0b2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,866,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-89228","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n