# \u26a1 EnderPearlLogic \u2014 Advanced Ender Pearl Control System<\/p>\n
A lightweight, powerful and fully configurable plugin that gives you complete control over Ender Pearl behavior.<\/p>\n
EnderPearlLogic enhances gameplay by adding cooldowns, economy systems, effects, sounds and safety improvements \u2014 all designed to be stable, optimized and easy to configure.<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
– **Custom cooldown system:** Control Ender Pearl usage per player
\n– **Anti-spam protection:** Prevent message spam when players are on cooldown
\n– **Admin bypass:** Ignore cooldown and restrictions for staff
\n– **Vault economy support (optional):** Charge players per pearl usage
\n– **Endermite control system:** Enable or disable spawn and Customize spawn chance
\n– **Teleport effects:** Fully configurable (type, duration, amplifier)
\n– **Custom sounds:** Launch & impact with volume and pitch control
\n– **Custom damage system:** Modify or disable Ender Pearl damage <\/p>\n
—<\/p>\n
## \ud83d\ude80 Advanced Systems<\/p>\n
– **PlaceholderAPI support (optional)**
\n– **Configurable placeholder outputs**
\n– **Real-time cooldown tracking**
\n– **Update checker system**
\n– **Automatic config updater (no broken configs)**
\n– **Safe & optimized core:**
\n – Respects other plugins
\n – Prevents double execution
\n – No memory leaks
\n – Minimal performance impact <\/p>\n
—<\/p>\n
## \ud83d\udd0c PlaceholderAPI Integration<\/p>\n
EnderPearlLogic supports **PlaceholderAPI** for dynamic data in scoreboards, holograms, tablists and more.<\/p>\n
### Available Placeholders<\/p>\n
| Placeholder | Description |
\n|————|————-|
\n| `%enderpearllogic_cooldown_remaining%` | Remaining cooldown time |
\n| `%enderpearllogic_cooldown_status%` | Cooldown status (ready \/ cooldown) |
\n| `%enderpearllogic_cooldown_active%` | Returns true or false |<\/p>\n
All placeholder values are fully configurable in `config.yml`.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Commands & Permissions<\/p>\n
### Commands<\/p>\n
| Command | Description | Permission |
\n|——–|————|————|
\n| `\/enderpearllogic reload` | Reload plugin configuration | `enderpearllogic.reload` |<\/p>\n
### Permissions<\/p>\n
| Permission | Description |
\n|———–|————|
\n| `enderpearllogic.use` | Use Ender Pearls |
\n| `enderpearllogic.reload` | Reload configuration |
\n| `enderpearllogic.command` | Use base command |
\n| `enderpearllogic.bypass` | Ignore cooldown & restrictions |
\n| `enderpearllogic.update` | Receive update notifications |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
EnderPearlLogic provides a fully customizable configuration system:<\/p>\n
– Automatic config updates (adds missing options safely) <\/p>\n —<\/p>\n ## \ud83c\udfaf Use Cases<\/p>\n – **Survival servers:** Prevent Ender Pearl abuse —<\/p>\n ## \ud83d\udcbb Compatibility<\/p>\n – **Minecraft:** 1.20.x \u2192 1.21.x ### Optional dependencies —<\/p>\n ## \u2764\ufe0f Designed for Performance<\/p>\n EnderPearlLogic is built to be **lightweight, safe and efficient**. Simple to install, safe to use, and ready for your minecraft server. \u2694\ufe0f<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" A plugin that enhances Ender Pearl usage with cooldowns, customizable messages, damage control, configurable sounds, and teleportation effects.<\/p>\n","protected":false},"featured_media":64006,"template":"","meta":{"_minecraft_slug":"enderpearllogic","_minecraft_project_id":"lUP9IoeG","_minecraft_author":"ThaRialSniper","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":846,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"enderpearllogic.zip","_minecraft_size_bytes":144625,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T09:08:49.249475Z","_minecraft_date_created":"2024-10-03T06:07:16.409298Z","_minecraft_date_modified":"2026-04-21T20:58:13.482964Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/enderpearllogic","_minecraft_icon_attachment_id":64006,"_minecraft_imported_at":"2026-06-03T16:35:07+00:00","_minecraft_import_hash":"a3314e4a09a3ddab5485975348b32298","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,866,90,127,128,129,869],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-64005","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-minigame","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Backwards compatibility with older configs
\n– Safe validation for all values
\n– Fully configurable messages, placeholders, sounds and effects <\/p>\nconfig.yml<\/summary>\n
\n# ============================================================\n# EnderPearlLogic v1.5\n# Default configuration compatible with the public Spigot layout.\n#\n# Color codes with & are supported.\n# Set any message to \"none\" to stop sending that message.\n# Players with enderpearllogic.bypass ignore cooldown and economy cost.\n# Invalid values are logged as warnings and replaced or skipped safely.\n#\n# Official Bukkit documentation for configurable IDs:\n# Potion effects: https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/potion\/PotionEffectType.html\n# Sounds: https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/Sound.html\n# Use IDs available on your server version, for example SPEED or ENTITY_PLAYER_TELEPORT.\n# ============================================================\n\n# ============================================================\n# Permission reference\n# These permissions are registered in plugin.yml.\n# They are NOT configured here; manage them with your permissions\n# plugin, for example LuckPerms.\n#\n# enderpearllogic.use\n# Allows players to use Ender Pearls controlled by this plugin.\n# Default: everyone.\n#\n# enderpearllogic.bypass\n# Bypasses cooldown and economy cost.\n# Default: operators.\n#\n# enderpearllogic.reload\n# Allows \/enderpearllogic reload and \/eplreload.\n# Default: operators.\n#\n# enderpearllogic.command\n# Allows using \/enderpearllogic without reload arguments.\n# Players without this permission will not see command usage.\n# Default: operators.\n#\n# enderpearllogic.update\n# Allows receiving update notifications when update-checker is enabled.\n# Operators also receive update notifications.\n# Default: operators.\n# ============================================================\n\n# Cooldown in seconds for using Ender Pearls.\n# Requires enderpearllogic.use unless the player has enderpearllogic.bypass.\n# Set to 0 to disable the cooldown duration while keeping the rest\n# of the plugin features active.\ncooldown-time: 10\n\n# Minimum delay, in seconds, between cooldown messages for the same player.\n# The plugin checks this only when the player actually tries to use an\n# Ender Pearl during cooldown. Set this to 0 to show a message on every\n# blocked attempt.\ncooldown-message-delay: 1\n\nmessages:\n # Prefix added before plugin messages. Use \"none\" to disable it.\n prefix: \"&bEnderPearlLogic &8>> \"\n\n # Placeholders: {time}, {seconds}, %time%, %seconds%.\n cooldown: \"&7You must wait &c{time} &7seconds before using another Ender Pearl.\"\n\n # Sent when a pearl is successfully thrown.\n use: \"&7You used an Ender Pearl! Teleporting...\"\n\n # Sent after the ender pearl teleport succeeds.\n success: \"&aTeleportation successful!\"\n\n # Sent after \/enderpearllogic reload.\n reload: \"&aEnderPearlLogic configuration reloaded successfully!\"\n\n # Sent when a player cannot use Ender Pearls.\n no-permission: \"&cYou do not have permission to use Ender Pearls.\"\n\n # Command and safety messages.\n reload-no-permission: \"&cYou do not have permission to reload this plugin.\"\n reload-error: \"&cThe configuration could not be reloaded. Check the console.\"\n config-error: \"&cThere is a configuration problem. Safe values will be used.\"\n command-usage: \"&eUsage: &f\/enderpearllogic reload\"\n command-no-permission: \"&cYou do not have permission to use this command.\"\n\n # Economy messages. Placeholders: {cost}, {balance}.\n not-enough-money: \"&cYou need &e{cost} &cto use an Ender Pearl. Your balance: &e{balance}&c.\"\n cost-charged: \"&7Ender Pearl cost charged: &e{cost}&7.\"\n economy-error: \"&cThe economy payment could not be completed. Try again later.\"\n\n # Update message. Placeholders: {current}, {latest}, {url}.\n update-available: \"&eA new EnderPearlLogic version is available: &f{latest} &7(current: &f{current}&7). &b{url}\"\n\n# Custom damage dealt by an Ender Pearl when it hits a mob or player.\nenderpearl-damage:\n enabled: true\n amount: 5.0\n\n# Potion effect applied to the player after teleporting.\n# Valid effect IDs:\n# https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/potion\/PotionEffectType.html\nteleport-effect:\n enabled: true\n type: \"SPEED\"\n\n # Duration in seconds.\n duration: 5\n\n # 0 = level I, 1 = level II.\n amplifier: 1\n\n# Sound played when an Ender Pearl is thrown.\n# Valid sound IDs:\n# https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/Sound.html\nlaunch-sound:\n enabled: true\n type: \"ENTITY_ENDER_PEARL_THROW\"\n volume: 1.0\n pitch: 1.0\n\n# Sound played when an Ender Pearl impacts.\n# Valid sound IDs:\n# https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/Sound.html\nhit-sound:\n enabled: true\n type: \"ENTITY_ENDERMAN_TELEPORT\"\n volume: 1.0\n pitch: 1.0\n\n# Endermite spawn control after a successful Ender Pearl teleport.\n# The plugin cancels the vanilla Ender Pearl Endermite spawn and applies\n# this chance itself, which keeps behavior consistent across supported versions.\nendermite:\n # Set to false to fully disable Endermites from Ender Pearls.\n enabled: true\n\n # Spawn chance from 0.0 to 1.0.\n # 0.0 = never, 0.05 = 5%, 1.0 = always.\n chance: 0.05\n\n# Optional Vault economy support.\n# Requires Vault and an economy plugin. Disabled by default.\n# If Vault or an economy provider is missing, only this feature is disabled.\n# Players with enderpearllogic.bypass are not charged.\n# The cost is charged only when the Ender Pearl launch is valid.\neconomy:\n enabled: false\n\n # Money charged for a valid Ender Pearl launch.\n # Set to 0.0 to avoid charging even if economy is enabled.\n cost: 0.0\n\n # Sends messages.cost-charged after a successful payment.\n send-cost-charged-message: true\n\n# Optional update checker.\n# Enabled by default. Uses a lightweight Spigot resource version endpoint\n# based on the configured resource URL. Notifications are shown only to OPs\n# or players with enderpearllogic.update.\n# The main resource URL, the \/updates URL, or the numeric resource id are accepted.\n# This does not download updates automatically.\nupdate-checker:\n enabled: true\n resource-url: \"https:\/\/www.spigotmc.org\/resources\/enderpearllogic.120087\/\"\n\n# Optional PlaceholderAPI support.\n# If PlaceholderAPI is not installed, this does nothing.\n# Registered placeholders:\n# - %enderpearllogic_cooldown_remaining%\n# - %enderpearllogic_cooldown_status%\n# - %enderpearllogic_cooldown_active%\nplaceholders:\n enabled: true\n\n # Values returned by PlaceholderAPI placeholders.\n # These values do not use messages.prefix.\n # Color codes with & are supported if your placeholder target supports colors.\n values:\n # Returned by %enderpearllogic_cooldown_remaining% when no cooldown is active.\n # During cooldown, the placeholder returns the remaining seconds as a number.\n cooldown-remaining-none: \"0\"\n\n # Returned by %enderpearllogic_cooldown_status%.\n cooldown-status-cooldown: \"cooldown\"\n cooldown-status-ready: \"ready\"\n\n # Returned by %enderpearllogic_cooldown_active%.\n cooldown-active-true: \"true\"\n cooldown-active-false: \"false\"\n<\/code><\/pre>\n<\/details>\n
\n– **PvP servers:** Improve combat balance
\n– **Minigame servers:** Add custom teleport mechanics
\n– **Networks:** Stable and scalable solution <\/p>\n
\n– **Java:** 17 or higher
\n– **Platforms:** Paper, Spigot, Purpur <\/p>\n
\n– Vault (economy system)
\n– PlaceholderAPI (placeholders) <\/p>\n
\nIt minimizes resource usage while ensuring stable behavior across different server setups.<\/p>\n