SkyPetBoundaryBridge

ABOUT

SkyPetBoundaryBridge is a small compatibility plugin between
SuperiorSkyblock2 and SimplePets.

Some rideable pets can move players independently from the normal player
movement protections used by Skyblock plugins.

This can allow players to:

• Ride a pet outside their island.
• Travel through the void while mounted.
• Reach another player's island using a pet.
• Bypass normal island boundary restrictions.

SkyPetBoundaryBridge solves this by directly checking the location of the
mounted pet against SuperiorSkyblock2's island system.


HOW IT WORKS

When a player is riding a SimplePets pet, the plugin performs the following checks:

Outside SuperiorSkyblock2 island worlds, the plugin does absolutely nothing.


FEATURES

• SuperiorSkyblock2 world detection
  Only operates inside worlds registered as island worlds by SuperiorSkyblock2.
  
• Real island boundary detection
  Uses SuperiorSkyblock2's island API instead of manually calculating island sizes or borders.
  
• SimplePets detection
  Only affects pets recognized through the SimplePets API by default.
  
• Safe dismount
  Automatically removes the player from their pet when leaving a valid island area.
  
• Return to last valid position
  The player can automatically be sent back to the last valid location detected inside an island.
  
• Cross-island protection
  Can prevent a player from moving directly from one island to another during the same riding session.
  
• Optional pet despawn
  Can despawn only the exact SimplePets pet being ridden when a violation occurs.
  
• Bypass permission
  Staff members can completely bypass the protection.
  
• Message cooldown
  Prevents repeated boundary messages from spamming players.
  
• Runtime reload
  Configuration can be reloaded without restarting the server.
  
• Debug mode
  Optional detailed console information for troubleshooting.

ANTI-EXPLOIT PROTECTION

Simply dismounting the player is not always enough.

Without additional protection, a player could potentially do this:

SkyPetBoundaryBridge can remember the player's
last valid position inside an island.

When an invalid location is detected:

This prevents players from slowly progressing through invalid areas by
repeatedly mounting their pet.


CROSS-ISLAND PROTECTION

There is also protection against moving directly between two islands.

For example:

Even if the player somehow enters another valid island area without first
crossing a location where no island exists, SkyPetBoundaryBridge can detect
that the island UUID changed during the riding session.

With:

the player will be stopped.


PERFORMANCE

SkyPetBoundaryBridge was designed to be extremely lightweight.

It does NOT:

• Scan loaded chunks.
• Scan every entity in the world.
• Use getNearbyEntities() repeatedly.
• Search all islands every tick.
• Perform asynchronous Bukkit entity operations.
• Process unmounted players through the expensive pet checks.

The protection pass follows a filtered pipeline:

Expensive island and pet checks are therefore only relevant to players
who are actually riding something inside a SuperiorSkyblock2 island world.

The default interval is:

This provides very fast boundary detection.

You can increase the interval if desired.


DEPENDENCIES

Both plugins are required.

SuperiorSkyblock2
SpigotMC Resource

SimplePets
SpigotMC Resource

SkyPetBoundaryBridge will not load without these dependencies.


REQUIREMENTS

• Java 21 or newer
• Minecraft 1.21+
• SuperiorSkyblock2
• SimplePets

Important:
Your Minecraft version must also be supported by the installed versions
of SuperiorSkyblock2 and SimplePets.


INSTALLATION

1. Install SuperiorSkyblock2.
2. Install SimplePets.
3. Place SkyPetBoundaryBridge.jar inside your server's /plugins/ directory.
4. Restart the server.
5. Open /plugins/SkyPetBoundaryBridge/config.yml.
6. Configure the protection to your preference.

Recommended plugin structure:


DEFAULT CONFIGURATION


PROTECTION ACTIONS

There are currently two violation actions.


DISMOUNT

Recommended option.

When a violation is detected:

• The player is removed from the vehicle.
• The pet remains spawned.
• The player can optionally be returned to their last valid position.

This is the safest and least intrusive option.


DESPAWN_RIDDEN_PET

When a violation is detected:

• The player is dismounted.
• SkyPetBoundaryBridge identifies the exact SimplePets pet being ridden.
• Only that pet is removed.
• Other spawned pets are not intentionally removed.
• The player can be returned to their last valid position.

If SkyPetBoundaryBridge cannot safely identify the exact pet, it falls
back to leaving the pet untouched while still dismounting the player.


COMMANDS

Displays:

• Protection status
• SimplePets API status
• Check interval
• SimplePets-only mode
• Cross-island protection status
• Return-to-safe-position status
• Current violation action
• Tracked riding sessions

Reloads the configuration and restarts the protection task.


Command alias:

Examples:


PERMISSIONS

skypetbridge.admin


Default:


skypetbridge.bypass


Default:


RECOMMENDED CONFIGURATION

For most Skyblock servers:

This configuration provides strong protection while keeping the pet itself
untouched.


HOW IS AN INVALID AREA DETECTED?

SkyPetBoundaryBridge does not use a manually configured radius.

Instead, it asks SuperiorSkyblock2 which island owns the current location.

Conceptually:

This means the protection follows SuperiorSkyblock2's own island layout.


MULTI-ENTITY PET SUPPORT

Some pet implementations may internally use multiple Bukkit entities or
nested passenger/vehicle relationships.

SkyPetBoundaryBridge does not assume that:

is always the visible pet entity.

It follows the vehicle stack and uses SimplePets' public API to match the
vehicle against the player's spawned pets.

This improves compatibility with pets composed of helper entities.


WHAT DOES THE PLUGIN NOT AFFECT?

With the default configuration:

SkyPetBoundaryBridge does not intentionally restrict:

• Normal player movement
• Players that are not mounted
• Horses
• Boats
• Minecarts
• Other vehicle plugins
• Worlds that are not SuperiorSkyblock2 island worlds

TROUBLESHOOTING

If the protection does not seem to activate, run:

Make sure you see:

You can also temporarily enable:

and reload:

The plugin will print additional information when a boundary violation is detected.

It is recommended to disable debug mode after troubleshooting.


COMMON QUESTIONS

Does this replace SuperiorSkyblock2's protections?

No.

SkyPetBoundaryBridge only adds an additional compatibility layer for
rideable SimplePets.


Does it protect normal player movement?

No.

SuperiorSkyblock2 continues handling normal island protection.


Does it affect pets outside the Skyblock world?

No.

The plugin first verifies that the vehicle is inside a world registered
as an island world by SuperiorSkyblock2.


Can administrators bypass the protection?

Yes.

Give the player:


Will it despawn every pet owned by the player?

No.

When DESPAWN_RIDDEN_PET is enabled, the plugin attempts to
identify and remove only the specific pet associated with the mounted
vehicle.


Can I only dismount players without deleting their pet?

Yes.

Use:

This is also the recommended configuration.


Can players travel from their island to another island while mounted?

With:

the plugin tracks the island where the riding session started and blocks
entering a different island during the same session.


Can I change how often the protection checks players?

Yes.

Use:

Allowed values are automatically limited between 1 and 20 ticks.


DESIGNED FOR SKYBLOCK SERVERS

SkyPetBoundaryBridge has one job:


It does not attempt to replace either SuperiorSkyblock2 or SimplePets.

It simply connects their APIs and adds the missing boundary protection.


SUPPORT

When reporting an issue, please provide:

• Minecraft version
• Server software and version
• Java version
• SuperiorSkyblock2 version
• SimplePets version
• SkyPetBoundaryBridge version
• Output of /spb status
• Relevant console errors
• Your SkyPetBoundaryBridge configuration

Please do not use the review section for bug reports.


PLUGIN INFORMATION

Plugin: SkyPetBoundaryBridge
Version: 1.0.0
Author: Pixelbyte Studio
Dependencies: SuperiorSkyblock2, SimplePets