🍇DS-PearlFix

DS-PearlFix is a lightweight plugin designed to solve a specific Minecraft exploit where players can use Ender Pearls to bypass walls, barriers, and corners. This plugin ensures fair gameplay by preventing this glitch without introducing additional complexity.

Main Features

🛡️ Advanced Protection

• Robust Glitch Detection: Detects EnderPearl teleport exploits

• Automatic Correction: Prevents players from bypassing walls

• Violation Notifications: Alerts staff about exploit attempts

• Lightweight Solution: Minimal performance impact

Configuration

Settings.yml File

# Version of the configuration file, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 6.0
Plugin-Version: 6.0

# Plugin messages, you can edit them according to your needs.
Messages:
  Prefix: '<aqua>Fruit</aqua><white>Forge</white> <dark_gray><bold>» </bold></dark_gray>'
  Reload: '<green>Plugin ready!'
  No-Perms: "<red>You don't have permission to do that"
  Unsafe-Location: "<red>Teleport canceled due to unsafe location!"
  No-Corner: "<red>You cant teleport to a corner!"
  Very-Close: "<red>You can't throw a pearl so close to a block!"
  Block-Glitch-Message: "<red>%player% just tried to block glitch using an enderpearl at %coords%"

# Permission required to bypass the plugin
Permissions:
  Staff: 'pearlfix.message'
  Bypass: 'pearlfix.bypass'
  Reload: 'pearlfix.reload'

# Launch verification distance of the EnderPearl. I recommend NOT altering
# this value, but it is editable according to your needs. However, making
# it shorter could hinder detection, while making it longer could render the EnderPearl useless
Check-Distance: 1.75

Configuration Options

Messages

• Prefix: Prefix that appears in all plugin messages

• Reload: Message shown when the plugin reloads correctly

• No-Perms: Message shown when a player doesn't have permissions

• Unsafe-Location: Message when a teleport is canceled due to unsafe location

• No-Corner: Message when trying to teleport to a corner

• Very-Close: Message when trying to throw a pearl too close to a block

• Block-Glitch-Message: Alert message for staff when a glitch attempt is detected

Permissions

• Staff: pearlfix.message - Receive notifications about glitch attempts

• Bypass: pearlfix.bypass - Bypass plugin restrictions

• Reload: pearlfix.reload - Reload plugin configuration

Technical Configuration

• Check-Distance: 1.75 - Verification distance for EnderPearl launch

  • ⚠️ Recommendation: DO NOT alter this value

  • A shorter value could hinder detection

  • A longer value could render EnderPearls useless

Commands

/pearlfix reload

Reloads the plugin configuration.

• Required permission: pearlfix.reload

• Usage: /pearlfix reload

Permissions

Permission	Description	Default
pearlfix.message	Receive staff notifications about glitch attempts	OP
pearlfix.bypass	Bypass all plugin restrictions	OP
pearlfix.reload	Reload plugin configuration	OP

How It Works

1. Detection: The plugin monitors all EnderPearl throws

2. Verification: Calculates the trajectory and destination of the pearl using Check-Distance

3. Prevention: Cancels teleports that could result in bypassing blocks

4. Notification: Alerts staff with permissions when a glitch attempt is detected

Message Variables

In plugin messages you can use the following variables:

• %player% - Name of the player who attempted the glitch

• %coords% - Coordinates where the glitch was attempted

Installation

1. Download the plugin .jar file

2. Place it in your server's plugins/ folder

3. Restart the server

4. Configure permissions as needed

5. Customize messages in Settings.yml if desired

Compatibility

• Minecraft Version: 1.13 - 1.21.7

• Platforms: Spigot, Paper, Purpur

• Dependencies: None

Support

To report bugs or request features:

• Discord: https://fruitforge.com/discord

---

Plugin developed by FruitForge Studio