Unstuck Plugin

Description

The Unstuck plugin is designed for Minecraft Spigot servers to help players who are trapped in the bedrock layer at height 127. This plugin provides a simple commands to teleport players to a safer location, ensuring they can continue their adventure without being stuck.

Features

• Unstuck Command: A command that players can use to teleport themselves out of the bedrock layer.
• Safe Teleportation: The plugin calculates a safe location above the bedrock layer or to a predefined safe zone.
• Configurable Settings: Server admins can configure the safe teleport location or the height to which players should be teleported.
• Permission-Based Access: Only players with the appropriate permissions can use the unstuck command, ensuring fair use.

Commands

• /stuck - Teleports the player to a safer location

• /escape - Player escapes to a safer location

Permissions

There is no need for them.

Installation

1. Download the plugin jar file.
2. Place the jar file in the plugins folder of your Spigot/Paper server.
3. Restart the server to load the plugin.
4. Configure the plugin settings in the generated config.yml file if necessary.

Configuration

The config.yml file allows server admins to set the safe teleport location or the height to which players should be teleported. Example configuration:
```yaml

Unstuck Configuration for Minecraft Java

Time in seconds between uses of /stuck command

cooldown-seconds: 30

Radius from current position to search for a safe spot

search-radius: 5

Maximum number of attempts to find a safe location

max-attempts: 50

Y-coordinate range for safe locations

These are adjusted based on world min/max Y if necessary

For 1.21+ worlds, the plugin will auto-adjust if these are defaults

min-y: 32
max-y: 120

Enable debug logging (only use for troubleshooting)

debug: false

Skip hazardous blocks when teleporting (lava, fire, cactus, etc.)

avoid-hazardous-blocks: true

Avoid unstable blocks like leaves and snow layers

avoid-unstable-blocks: true

Print success message when player gets unstuck (disable to reduce spam)

print-success-message: true