EnderPearlLogic

# ⚡ EnderPearlLogic — Advanced Ender Pearl Control System A lightweight, powerful and fully configurable plugin that gives you complete control over Ender Pearl behavior. EnderPearlLogic enhances gameplay by adding cooldowns, economy systems, effects, sounds and safety improvements — all designed to be stable, optimized and easy to configure. --- ## ✨ Core Features - **Custom cooldown system:** Control Ender Pearl usage per player - **Anti-spam protection:** Prevent message spam when players are on cooldown - **Admin bypass:** Ignore cooldown and restrictions for staff - **Vault economy support (optional):** Charge players per pearl usage - **Endermite control system:** Enable or disable spawn and Customize spawn chance - **Teleport effects:** Fully configurable (type, duration, amplifier) - **Custom sounds:** Launch & impact with volume and pitch control - **Custom damage system:** Modify or disable Ender Pearl damage --- ## 🚀 Advanced Systems - **PlaceholderAPI support (optional)** - **Configurable placeholder outputs** - **Real-time cooldown tracking** - **Update checker system** - **Automatic config updater (no broken configs)** - **Safe & optimized core:** - Respects other plugins - Prevents double execution - No memory leaks - Minimal performance impact --- ## 🔌 PlaceholderAPI Integration EnderPearlLogic supports **PlaceholderAPI** for dynamic data in scoreboards, holograms, tablists and more. ### Available Placeholders | Placeholder | Description | |------------|-------------| | `%enderpearllogic_cooldown_remaining%` | Remaining cooldown time | | `%enderpearllogic_cooldown_status%` | Cooldown status (ready / cooldown) | | `%enderpearllogic_cooldown_active%` | Returns true or false | All placeholder values are fully configurable in `config.yml`. --- ## ⚙️ Commands & Permissions ### Commands | Command | Description | Permission | |--------|------------|------------| | `/enderpearllogic reload` | Reload plugin configuration | `enderpearllogic.reload` | ### Permissions | Permission | Description | |-----------|------------| | `enderpearllogic.use` | Use Ender Pearls | | `enderpearllogic.reload` | Reload configuration | | `enderpearllogic.command` | Use base command | | `enderpearllogic.bypass` | Ignore cooldown & restrictions | | `enderpearllogic.update` | Receive update notifications | --- ## ⚙️ Configuration EnderPearlLogic provides a fully customizable configuration system: - Automatic config updates (adds missing options safely) - Backwards compatibility with older configs - Safe validation for all values - Fully configurable messages, placeholders, sounds and effects <details> <summary>config.yml</summary> <br> <pre><code> # ============================================================ # EnderPearlLogic v1.5 # Default configuration compatible with the public Spigot layout. # # Color codes with & are supported. # Set any message to "none" to stop sending that message. # Players with enderpearllogic.bypass ignore cooldown and economy cost. # Invalid values are logged as warnings and replaced or skipped safely. # # Official Bukkit documentation for configurable IDs: # Potion effects: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html # Sounds: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html # Use IDs available on your server version, for example SPEED or ENTITY_PLAYER_TELEPORT. # ============================================================ # ============================================================ # Permission reference # These permissions are registered in plugin.yml. # They are NOT configured here; manage them with your permissions # plugin, for example LuckPerms. # # enderpearllogic.use # Allows players to use Ender Pearls controlled by this plugin. # Default: everyone. # # enderpearllogic.bypass # Bypasses cooldown and economy cost. # Default: operators. # # enderpearllogic.reload # Allows /enderpearllogic reload and /eplreload. # Default: operators. # # enderpearllogic.command # Allows using /enderpearllogic without reload arguments. # Players without this permission will not see command usage. # Default: operators. # # enderpearllogic.update # Allows receiving update notifications when update-checker is enabled. # Operators also receive update notifications. # Default: operators. # ============================================================ # Cooldown in seconds for using Ender Pearls. # Requires enderpearllogic.use unless the player has enderpearllogic.bypass. # Set to 0 to disable the cooldown duration while keeping the rest # of the plugin features active. cooldown-time: 10 # Minimum delay, in seconds, between cooldown messages for the same player. # The plugin checks this only when the player actually tries to use an # Ender Pearl during cooldown. Set this to 0 to show a message on every # blocked attempt. cooldown-message-delay: 1 messages:

# ============================================================
# EnderPearlLogic v1. 5
# Default configuration compatible with the public Spigot layout.
#
# Color codes with & are supported.
# Set any message to "none" to stop sending that message.
# Players with enderpearllogic.bypass ignore cooldown and economy cost.
# Invalid values are logged as warnings and replaced or skipped safely.
#
# Official Bukkit documentation for configurable IDs:
# Potion effects: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
# Sounds: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# Use IDs available on your server version, for example SPEED or ENTITY_PLAYER_TELEPORT.
# ============================================================
# ============================================================
# Permission reference
# These permissions are registered in plugin.yml.
# They are NOT configured here; manage them with your permissions
# plugin, for example LuckPerms.
#
# enderpearllogic.use
# Allows players to use Ender Pearls controlled by this plugin.
# Default: everyone.
#
# enderpearllogic.bypass
# Bypasses cooldown and economy cost.
# Default: operators.
#
# enderpearllogic.reload
# Allows /enderpearllogic reload and /eplreload.
# Default: operators.
#
# enderpearllogic.command
# Allows using /enderpearllogic without reload arguments.
# Players without this permission will not see command usage.
# Default: operators.
#
# enderpearllogic.update
# Allows receiving update notifications when update-checker is enabled.
# Operators also receive update notifications.
# Default: operators.
# ============================================================
# Cooldown in seconds for using Ender Pearls.
# Requires enderpearllogic.use unless the player has enderpearllogic.bypass.
# Set to 0 to disable the cooldown duration while keeping the rest
# of the plugin features active.
cooldown-time: 10
# Minimum delay, in seconds, between cooldown messages for the same player.
# The plugin checks this only when the player actually tries to use an
# Ender Pearl during cooldown. Set this to 0 to show a message on every
# blocked attempt.
cooldown-message-delay: 1