🍇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

Last updated