Stuck?

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

- Permission-Based Access: A command that players can use to teleport themselves out of the bedrock layer. - Permission-Based Access: The plugin calculates a safe location above the bedrock layer or to a predefined safe zone. - Permission-Based Access: 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