FruitForge
  • Welcome
  • Free Resources
    • šŸ‡DS-PearlFix
    • šŸDS-Ads
    • šŸŠOrangeWhitelist
    • 🄄CocoVaults Lite
    • šŸ›ŒISleep
  • PREMIUM RESOURCE
    • 🄄CocoVaults
Powered by GitBook
On this page
  1. Free Resources

šŸ‡DS-PearlFix

PreviousWelcomeNextDS-Ads

Last updated 1 month ago

CtrlK
  • Main Features
  • Configuration
  • Commands
  • Permissions
  • How It Works
  • Message Variables
  • Installation
  • Compatibility
  • Support

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