BorderPlus

You can now pay for border expansion with player experience levels. Add this to your collective_gui_world.yml:

      contribute_xp:
        material: EXPERIENCE_BOTTLE
        lore:
        - ''
        - '   &7Click to contribute'
        - '   &a5 XP levels &7to the piggy bank.'
        - '   &7(uses your experience bar)'
        - ''
        xp_cost: 5
        use_xp_levels: true
        slot: 22
        economy: false
        display_name: '&a&lContribute 5 XP Levels'
        contribution_amount: 5

• xp_cost: 5 — number of experience levels taken from the player

• use_xp_levels: true — use levels instead of money or items

• Add this block to your menu config and it will work with the new version.

Fixed: Plugin crash on startup when display_name or lore are missing for items in the collective GUI.

⚠️ CONFIG RESTRUCTURE

New options were added to the main config and message files. Automatic expansion of other worlds When the main world expands, other worlds can expand automatically. The list and ratios are set in the config. Number of worlds: Any. You can add several worlds or remove the whole block so nothing expands automatically. Ratio format (1.X): 1.8 — Minecraft formula for the Nether (1:8). Overworld +1000 blocks = Nether +125 blocks. 1.1 — 1:1, the world expands the same as the main world.

Example in config:

automatically_expand_worlds:
  world_nether: 1.8   # Nether — Minecraft formula
  world_the_end: 1.1  # End — same as main world

To disable: Remove the entire automatically_expand_worlds block so nothing expands automatically. Config structure

The worlds section now supports automatically_expand_worlds and expand_worlds_names (optional display names for messages instead of raw world names like world_nether).

  worlds:
    world:
      gui: "gui.yml"
      max_size: 5000
      collective_gui: "collective_gui_world.yml"
      name: "Survival World"
      automatically_expand_worlds:
        # Worlds that expand automatically when this world expands.
        # Key = exact world name on server (check your world/ folder for folder names).
        # Any world works: Nether, End, void, custom, skyblock, etc. Just use its folder name.
        #
        # Value = expansion ratio in format 1.X (means 1:X).
        # The number after the dot is the denominator. Formula: dependent_expansion = source_expansion / X
        #
        # Examples:
        #   1.1 = 1:1  -> multiplier 1.0   -> overworld +1000 = dependent +1000 (same)
        #   1.2 = 1:2  -> multiplier 0.5    -> overworld +1000 = dependent +500  (half)
        #   1.3 = 1:3  -> multiplier 0.333  -> overworld +1000 = dependent +333
        #   1.8 = 1:8  -> multiplier 0.125  -> overworld +1000 = dependent +125 (Minecraft Nether formula)
        #
        # Values outside 1.0-2.0 range are used as raw multiplier (e.g. 0.5 = half, 2.0 = double).
        #
        # Don't want automatic expansion? Remove automatically_expand_worlds block entirely. Old configs without it work fine.
        # Want only Nether to expand? Remove world_the_end line below. Want only End? Remove world_nether.
        world_nether: 1.8   # Nether. 1:8 = overworld +1000 blocks = nether +125 blocks
        world_the_end: 1.1  # End. 1:1 = expands same amount as overworld
      expand_worlds_names:   # display names for automatically_expand_worlds (shown in messages instead of world_nether etc.). Optional.
        world_nether: "Nether"
        world_the_end: "The End"

The worlds section now supports automatically_expand_worlds and expand_worlds_names (optional display names for messages instead of raw world names like world_nether). Messages The expansion messages in the language files were updated to show boundaries for all expanded worlds (main + automatic). Everything should be clear from the config comments.

• Fixed display of the placeholder %borderplus_collective_player_contribution%

• Asynchronous update checking
• Confirmed compatibility with 1.21.9

• Fixed an issue where items would change when the server started or when the plugin was reloaded using the command.

I don’t know why I didn’t check this earlier.

WARNING! GUI AND CONFIG UPDATE REQUIRED.

Make a backup of your configs before updating, then delete:

• \plugins\BorderPlus\lang
• \plugins\BorderPlus\collective_gui_world_name.yml
• \plugins\BorderPlus\config.yml
• \plugins\BorderPlus\gui.yml

New Feature: Automatic Item Rotation

A function has been added to the plugin that automatically changes required items in GUI.

Interval (in seconds) and notification display are configured in the config.

New file appeared: rotation_storage.yml - stores current rotations (DO NOT TOUCH!)

New Commands:

• /borderplus rotategui [file] - force rotation
• /borderplus guistatus - rotation status

• Updated download links. They will be visible when checking for updates, and if your version differs from the latest one.

✅ Added customizable slot support

You can now use flexible formats to define item slots.

YAML Examples:

deco_left:
  material: BLACK_STAINED_GLASS_PANE
  slot: 0
  display_name: " "
  lore:
    - "&8Open collective menu"

You can also use multiple slots:

slots: 1-5

or:

slots: [10-12, 16, 22-24]

There's no difference — both are valid.

🧾 Also added: command and message execution

You can run commands as the player, console, and/or show a message.

YAML Format:

commands:
  - "player: borderplus reload"       # executed as the player
  - "console: borderplus reload"      # executed as console
  - "[MESSAGE] &#c39e9e&lHello!"       # sends a colored message to the player

• Fixed: menu text is no longer italic by default.
• Reworked the /borderplus change command to properly handle world name and number in any order.
• Examples:
• /borderplus change 1000 — adds 1000 blocks to the world border diameter in your current world.
• /borderplus change -1000 — subtracts 1000 blocks from the border diameter in your current world.
• /borderplus change MyWorld 1000 — targets a specific world by name.

Fixed hex color support on older Minecraft versions.

Fix for startup error on Paper 1.16.5

Fixed inaccurate visual progress bar in the collective menu: now correctly reflects the displayed percentage.

The plugin now supports gradually expanding the world border using Minecraft's built-in mechanics. A new parameter has been added to the configuration file:

  # The duration (in seconds) it takes for the world border to expand to its new size.
  # For example, if set to 10, the border will take 10 seconds to fully expand after the goal is achieved.
  world_border_expand_duration: 10

Note: The message about the world border expansion will now be displayed after the border has fully expanded.

Example: If you set this value to 10 (default), the message will appear 10 seconds after the border expansion begins.

• Added update check on plugin startup.

New Feature:

Added the Pot system, allowing players to contribute collectively towards expanding the world border. Players can now open the pot GUI with the command: /borderplus collective . Placeholders Added:

%borderplus_collective_progress_world%: Displays the percentage of the pot filled. %borderplus_collective_top_name_%: Shows the player’s name in the leaderboard of contributors. %borderplus_collective_player_contribution%: Displays how many items or coins the player viewing the placeholder has contributed to the pot. Tab Completion Added:

Added tab completion for the /borderplus collective command. Bug Fixes:

Fixed a bug where the world border expanded through the pot did not respect the maximum radius limit. Fixed an issue where coins were deducted even if the maximum radius of the world border was already reached.

• Now the phrases are taken from the right places.

• All messages translated into English.
• The menu is generated in English on the first launch.
• General code optimization.