JustLevelBorder
by BinJustDev
此项目功能
JustLevelBorder 是一款轻量级的 Minecraft Java Edition (1.21.x) 插件,根据玩家的经验值等级控制世界边界的大小。
世界边界在主世界的坐标 (0.5, 0.5) 处居中,并随着玩家获得或失去经验值等级而自动扩大或缩小。
边界大小遵循一个简单的公式:
Border Size = 1 + (Level × blocks-per-level)
根据配置不同,边界可以:
由所有玩家(即使离线)中当前最高等级驱动,或者
完全共享,意味着所有在线玩家拥有完全相同的经验值条(等级和进度实时同步)。
通过死亡、附魔或使用铁砧导致的等级损失会被检测、存储,并相应地反映在世界边界大小上。
为什么你应该下载这个插件
如果你希望拥有以下内容,JustLevelBorder 是理想的选择:
-
基于进度的生存挑战
-
一个由经验值直接控制探索的服务器
-
一个没有数据库且无依赖项的最小化插件
-
玩家离线时不会重置的持久化进度
-
可选的共享经验值玩法
该插件故意保持简单透明,使其易于配置、扩展或审计。
使用插件前请阅读:
- 世界边界是服务器端的,影响主世界中的所有玩家。
- 玩家等级存储在 saved_levels.yml 文件中。该文件代表当前等级,而非历史最高等级。
- 当启用 use-shared-levels 时:所有在线玩家共享相同的经验值等级和经验值条。共享等级从最高的存储等级初始化,即使该玩家离线。
- 死亡时,玩家会重置为 0 级(如果启用),并且边界可能会缩小。
- 边界变化会平滑动画显示(可配置)。
- 插件永远不会将等级或边界变化记录到服务器控制台。
- 关于等级损失的聊天通知是可选的,可以在游戏中切换。
该插件仅影响主世界(第一个加载的世界)。
如何下载和安装
-
下载 JustLevelBorder.jar
-
将 jar 文件放入服务器的 plugins/ 文件夹中
-
启动或重启服务器
-
根据需要编辑 config.yml
-
运行 /justlevelborder reload 以应用更改
命令
/justlevelborder
/levelborder
显示插件的简短说明。
/justlevelborder status
显示当前插件状态(模式、最高等级、边界大小、动画时间、通知)。
/justlevelborder reload
重新加载 config.yml 和 saved_levels.yml 并立即应用数值。
/justlevelborder notifications on|off
启用或禁用关于等级损失的聊天通知。
配置
center-x: 0.5
center-z: 0.5
这些值定义主世界中世界边界的中心点。
0.5, 0.5 将边界精确居中于 (0,0) 方块的中间。
如果你希望边界在其他位置居中,可以更改这些值。
use-shared-levels: false
控制如何处理玩家的经验值等级。
false(默认值):
每个玩家保留自己的经验值等级。
世界边界基于所有玩家(包括离线玩家)中的当前最高等级。
true:
所有在线玩家共享相同的经验值等级和经验值进度条。
当一个玩家获得或失去经验值时,所有人都会立即更新。
共享等级从最高的存储等级初始化,防止离线玩家丢失进度。
lose-progress-on-death: true
控制玩家死亡时会发生什么。
true(默认值):
玩家在死亡时重置为 0 级。
该值会被持久保存。
世界边界可能会根据新的最高等级缩小。
false:
玩家在死亡时保留其等级。
仅因死亡不会触发边界变化。
blocks-per-level: 2
定义每增加一级经验值世界边界扩大的量。
较高的值使进度更快;较低的值使挑战更具挑战性。
border-transition-seconds: 1
控制世界边界调整大小所需的时间。
0 → 即时变化
1 或更高 → 秒数的平滑动画
这会影响所有边界更新,包括扩大和缩小。
notifications:
enabled: true
控制玩家是否在有人失去经验值等级时看到聊天消息。
true(默认值):
向所有玩家发送红色聊天消息。
消息解释了谁失去了等级、原因以及边界是否发生变化。
false:
不发送任何聊天消息。
边界逻辑仍然正常工作。
causes:
anvil: "anvil"
enchanter: "enchanter"
dying: "dying"
other: "other"
这些字符串用于通知消息中描述玩家失去等级的原因。
示例:
使用铁砧 → "anvil"
附魔物品 → "enchanter"
玩家死亡 → "dying"
任何其他原因 → "other"
你可以自由自定义这些内容。
请注意:
该插件已不再进行开发。
感谢游玩 JustLevelBorder。 ❤️
JustLevelBorder
by BinJustDev
What this project does
JustLevelBorder is a lightweight plugin for Minecraft Java Edition (1.21.x) that controls the World Border size based on player XP levels.
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.
The border size follows a simple formula:
Border Size = 1 + (Level × blocks-per-level)
Depending on configuration, the border can be:
Driven by the highest current level of all players (even if they are offline), or
Fully shared, meaning all online players have the exact same XP bar (level and progress are synchronized in real time).
Level loss through death, enchanting, or anvil usage is detected, stored, and reflected in the world border size accordingly.
Why you should download this plugin
JustLevelBorder is ideal if you want:
-
A progression-based survival challenge
-
A server where XP directly controls exploration
-
A minimal plugin with no databases and no dependencies
-
Persistent progression that does not reset when players go offline
-
Optional shared XP gameplay
The plugin is intentionally kept simple and transparent, making it easy to configure, extend, or audit.
Please read this before using the plugin:
- The world border is server-side and affects all players in the main world.
- Player levels are stored persistently in saved_levels.yml. This file represents the current levels, not all-time highs.
- 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.
- On death, players are reset to level 0 (if enabled), and the border may shrink.
- Border changes are animated smoothly (configurable).
- The plugin never logs level or border changes to the server console.
- Chat notifications for level loss are optional and can be toggled in-game.
The plugin affects only the overworld (first loaded world).
How to download and install
-
Download the JustLevelBorder.jar
-
Place the jar into your server’s plugins/ folder
-
Start or restart the server
-
Edit config.yml to your liking
-
Run /justlevelborder reload to apply changes
Commands
/justlevelborder
/levelborder
Shows a short explanation of the plugin.
/justlevelborder status
Displays the current plugin state (mode, highest level, border size, animation time, notifications).
/justlevelborder reload
Reloads config.yml and saved_levels.yml and immediately applies the values.
/justlevelborder notifications on|off
Enables or disables chat notifications for level loss.
Config
center-x: 0.5
center-z: 0.5
These values define the center point of the world border in the main world.
0.5, 0.5 centers the border exactly on the middle of the (0,0) block.
You can change these values if you want the border centered elsewhere.
use-shared-levels: false
Controls how player XP levels are handled.
false (default):
Each player keeps their own XP level.
The world border is based on the highest current level of all players, even if that player is offline.
true:
All online players share the same XP level and XP progress bar.
When one player gains or loses XP, everyone updates instantly.
The shared level initializes from the highest stored level, preventing offline players from losing progress.
lose-progress-on-death: true
Controls what happens when a player dies.
true (default):
The player is reset to level 0 on death.
This value is saved persistently.
The world border may shrink depending on the new highest level.
false:
The player keeps their level on death.
No border change is triggered by death alone.
blocks-per-level: 2
Defines how much the world border grows per XP level.
Higher values make progression faster; lower values make the challenge more challenging.
border-transition-seconds: 1
Controls how long the world border takes to resize.
0 → instant change
1 or higher → smooth animation in seconds
This affects all border updates, including growth and shrinking.
notifications:
enabled: true
Controls whether players see chat messages when someone loses XP levels.
true (default):
Red chat messages are sent to all players.
Messages explain who lost levels, why, and whether the border changed.
false:
No chat messages are sent.
Border logic still works normally.
causes:
anvil: "anvil"
enchanter: "enchanter"
dying: "dying"
other: "other"
These strings are used in notification messages to describe why a player lost levels.
Examples:
Using an anvil → "anvil"
Enchanting items → "enchanter"
Player death → "dying"
Any other reason → "other"
You can customize these freely.
PLEASE NOTE:
The plugin is not being worked on anymore.
Thanks for playing JustLevelBorder. ❤️
评论 0
登录后参与评分
还没有评论,来抢沙发吧