Features
- Bypass world border restrictions for:
- Placing blocks (only possible by left clicking with a block)
- Breaking blocks
- Combat and entity interactions
- Player movement through border
- Visual block outline system for blocks beyond border (using display entities)
- Block breaking animations and effects
Realistic combat mechanics with critical hits & damage calculation based on armor and weapons
Installation
- Place the plugin JAR and packetevents.jar in your server's plugins/ folder
- Restart/reload your server
- Configure plugins/BeyondBorderUnlocked/config.yml to your needs
Warning
These actions beyond the world border are not intended by game design.
Unexpected bugs may occur, and the experience will differ from normal gameplay.
Test thoroughly before production use.
Configuration (config.yml)
Code (YAML):
building
: false
# Allow block placement beyond border (left click)
breaking
: true
# # Allow block breaking beyond border (left click)
walkthrough
: true
# Allow walking through border
hitting
: true
# Allow hitting entities beyond border
damage:
enabled
: true
# Enable custom border damage settings below (if false, the plugin does not modify the values below in your worlds)
buffer
: 5.0
# Distance before damage starts
amount
: 0.2
# Damage per second
blockOutline:
enabled
: true
# Show block outlines beyond border
size
: 0.009
# Size of outline segments
block
: BLACK_STAINED_GLASS
# Block type for outline
Commands
- /beyondborder reload - Reload configuration
- /beyondborder set <setting> <value> - Change settings
Available settings:
- building, breaking, walkthrough, blockOutline.enabled, hitting (true/false)
- damage.enabled, damage.buffer, blockOutline.size, damage.amount (numbers)
- blockOutline.block (text)
Permissions:
beyondborder.commands - Access to commands (default: op)
API Documentation
To use the api add
depends: BeyondBorderUnlocked to your plugin.yml
and this plugin as a compile-only dependency:
Code (Text):
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
compileOnly("com.github.max1mde:BeyondBorderUnlocked:1.0.0")
}
Accessing the API
Code (Java):
BeyondBorderUnlocked plugin
= BeyondBorderUnlocked.
getInstance
(
)
;
Config config
= plugin.
getPluginConfig
(
)
;
Events
- BlockBreakBorderEvent
- BlockPlaceBorderEvent
- AsyncEntityDamageBorderEvent
- AsyncEntityInteractBorderEvent
- Example Event Usage:
Code (Java):
@EventHandler
public
void onEntityDamage
(AsyncEntityDamageBorderEvent event
)
{
if
(event.
getDamager
(
)
instanceof Player
)
{
event.
setDamage
(event.
getDamage
(
)
*
1.5
)
;
// 50% more damage for example
}
}
Known Issues
- Blocks can only be placed using the left mouse button
- Walking through the world border is buggy due to required player teleportation
- Blocks sometimes continue breaking without holding the mouse button, or breaking progress resets even when holding the left mouse button
- The block selection outline box has incorrect sizing for certain blocks
Mechanics such as block breaking, damage calculations, and other interactions are not entirely accurate
Join the Discord server if you have any issues or
open an issue on GitHub
Do not use the review section below for suggestions/feature requests or support.