<\/p>\n
# YoTPA<\/p>\n
YoTPA is a lightweight and powerful teleport request plugin with adaptive performance optimization. Simple to use, easy to configure, and built for modern Minecraft servers.<\/p>\n
## Features<\/p>\n
### Adaptive Performance System
\nThe plugin automatically detects your server’s available RAM and optimizes itself accordingly – zero configuration needed!<\/p>\n
**4 Performance Modes:**
\n– **ULTRA_LIGHT** – For 512 MB – 1 GB RAM (Free\/Cheap VPS)
\n – Best for: 5-10 players, minimal plugins
\n– **LIGHT** – For 1-2 GB RAM (Low-end servers)
\n – Best for: 10-15 players, light plugins
\n– **BALANCED** – For 2-4 GB RAM (Mid-range servers)
\n – Best for: 15-25 players, moderate plugins
\n– **HIGH_PERFORMANCE** – For 4+ GB RAM (High-end servers)
\n – Best for: 25+ players, any plugins<\/p>\n
**Performance Benefits:**
\n– 30-70% less memory usage
\n– 25-60% less CPU usage
\n– Up to 83% faster maintenance tasks
\n– Dynamic optimization based on your server specs<\/p>\n
### Core Features<\/p>\n
– **Simple TPA System** – Request to teleport to other players or invite them to you
\n– **Countdown Timer** – Configurable delay before teleporting with visual feedback
\n– **Title Display** – Clear visual indication of teleport countdown
\n– **Movement Detection** – Teleport cancels if player moves during countdown
\n– **Custom Sound Effects** – Fully customizable audio feedback using Minecraft’s sound registry
\n– **Config Validation** – Prevents server crashes from broken configs with detailed error messages
\n– **Permission System** – Fine-grained access control
\n– **Request Management** – Toggle receiving requests, cancel outgoing requests
\n– **Multi-Threading Support** – Thread-safe for more concurrent players
\n– **Customizable Messages** – Fully localizable and configurable messages<\/p>\n
### Internationalization (NEW in 1.4.0)<\/p>\n
Customize all plugin messages in any language with full MiniMessage support:<\/p>\n
“`yaml
\nprefix: “[YoTPA] ”<\/p>\n
commands: ### Custom Sound Effects<\/p>\n Customize all plugin sounds using Minecraft’s sound IDs:<\/p>\n “`yaml Test sounds in-game: `\/playsound minecraft:block.note_block.pling master @s`<\/p>\n ## Configuration<\/p>\n YoTPA’s `config.yml` file allows you to customize various aspects of the plugin:<\/p>\n – Request timeout duration ### Configuration File<\/p>\n “`yaml # Request timeout in seconds (how long before a request expires) # Request cooldown in seconds (how long before sending another request) # Teleport delay in seconds (countdown before actual teleport) # Performance mode settings # Sound effects (use Minecraft sound names) # Feature toggles ### Messages Configuration (messages.yml) # All messages are customizable teleport: ### Change Language to Spanish<\/p>\n Edit `messages.yml`: commands: Then use `\/tpareload` to apply changes!<\/p>\n ### Add Beautiful Gradients<\/p>\n “`yaml teleport: ### Customize Colors<\/p>\n “`yaml commands: ### Use Hex Colors<\/p>\n “`yaml teleport: **Placeholders:** ### Configuration Sections Explained<\/p>\n **General Settings:** **Performance Settings:** **Sound Settings:** **Feature Toggles:** ### Config Validation<\/p>\n When reloading with `\/tpareload`, the plugin validates: Example validation output: Warnings: Config not applied. Fix errors and try again. ## How to Edit and Reload<\/p>\n 1. Edit the `plugins\/YoTPA\/config.yml` file ## Commands Overview<\/p>\n | Command | Description | Permission | **Default:** All permissions are granted to all players by default.<\/p>\n ## Detailed Commands<\/p>\n ### TPA Command<\/p>\n Send a request to teleport to another player.<\/p>\n “` | Parameter | Type | Description | **Examples:** <\/p>\n **Notes:** —<\/p>\n ### TPAccept Command<\/p>\n Accept a pending teleport request from another player.<\/p>\n “` No parameters required – accepts the most recent teleport request.<\/p>\n **Examples:** <\/p>\n **Notes:** —<\/p>\n ### TPADeny Command<\/p>\n Deny a pending teleport request from another player.<\/p>\n “` No parameters required – denies the most recent teleport request.<\/p>\n **Examples:** <\/p>\n **Notes:** —<\/p>\n ### TPAHere Command<\/p>\n Request another player to teleport to your location.<\/p>\n “` | Parameter | Type | Description | **Examples:** <\/p>\n **Notes:** —<\/p>\n ### TPACancel Command<\/p>\n Cancel your outgoing teleport request.<\/p>\n “` No parameters required – cancels your most recent outgoing request.<\/p>\n **Examples:** **Notes:** —<\/p>\n ### TPAToggle Command<\/p>\n Toggle whether you want to receive teleport requests.<\/p>\n “` No parameters required – toggles your request reception status.<\/p>\n **Examples:** **Notes:** —<\/p>\n ### TPAReload Command<\/p>\n Reload the plugin configuration with validation.<\/p>\n “` No parameters required – reloads and validates the configuration file.<\/p>\n **Examples:** <\/p>\n **Notes:** —<\/p>\n ### TPAInfo Command<\/p>\n View plugin information and real-time statistics.<\/p>\n “` No parameters required – displays plugin information.<\/p>\n **Examples:** **Shows:** **Notes:** —<\/p>\n ### TPAStats Command<\/p>\n View teleport statistics and usage data.<\/p>\n “` No parameters required – displays teleport statistics.<\/p>\n **Examples:** **Shows:** **Notes:** ## Optimization Tips<\/p>\n ### For FREE\/LOW-SPEC servers (512 MB – 1 GB): ### For MID-RANGE servers (2-4 GB): ### For HIGH-END servers (4+ GB): ## Performance<\/p>\n YoTPA is built with performance in mind:<\/p>\n – **Lightweight** – Minimal impact on server TPS ## Installation<\/p>\n 1. Download the latest JAR from the releases — **Note:** This is my first plugin project!.<\/p>\n","protected":false},"excerpt":{"rendered":" YoTPA is a lightweight and powerful teleport request plugin with adaptive performance optimization. Simple to use, easy to configure, and built for modern Minecraft servers.<\/p>\n","protected":false},"featured_media":173234,"template":"","meta":{"_minecraft_slug":"yotpa","_minecraft_project_id":"FOGWowU7","_minecraft_author":"PhyschicWinter9","_minecraft_license":"MIT","_minecraft_downloads":389,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yotpa.zip","_minecraft_size_bytes":13708224,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T11:01:25.453785Z","_minecraft_date_created":"2025-06-16T23:27:36.360701Z","_minecraft_date_modified":"2026-04-12T14:39:10.552887Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yotpa","_minecraft_icon_attachment_id":173234,"_minecraft_imported_at":"2026-06-09T22:40:20+00:00","_minecraft_import_hash":"0195a7aab9c32a3443ed693bc85cbaae","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,123,869,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-173233","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-transportation","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n tpa:
\n sent: “Teleport request sent to {target}”
\n received: “{requester} wants to teleport to you.”
\n“`
\n**MiniMessage Features:**
\n– Rich text formatting (bold, italic, underlined)
\n– Color gradients: `
\n– Rainbow effect: `
\n– Hex colors: `<#FF5733>text<\/#FF5733>`<\/p>\n
\nsounds:
\n countdown: “block.note_block.pling”
\n success: “entity.enderman.teleport”
\n cancel: “entity.villager.no”
\n request: “entity.experience_orb.pickup”
\n“`<\/p>\n
\n– Cooldown between requests
\n– Teleport delay countdown
\n– Performance mode settings
\n– Sound effects for different actions
\n– Feature toggles (statistics, bStats, titles, sounds)<\/p>\n
\n# YoTPA Configuration v1.3.0-Adaptive
\n# Smart Auto-Optimization for All Server Sizes<\/p>\n
\n# Recommended: 30-120 seconds
\nrequest-timeout: 60<\/p>\n
\n# Recommended: 15-60 seconds
\nrequest-cooldown: 30<\/p>\n
\n# Recommended: 3-10 seconds
\nteleport-delay: 5<\/p>\n
\nperformance:
\n # Options: AUTO, ULTRA_LIGHT, LIGHT, BALANCED, HIGH_PERFORMANCE
\n mode: AUTO<\/p>\n
\nsounds:
\n countdown: “block.note_block.pling”
\n success: “entity.enderman.teleport”
\n cancel: “entity.villager.no”
\n request: “entity.experience_orb.pickup”<\/p>\n
\nfeatures:
\n statistics: true
\n bstats: true
\n titles: true
\n sounds: true
\n“`<\/p>\n
\n“`yaml
\n# Customize your prefix
\nprefix: “[YoTPA] ”<\/p>\n
\ncommands:
\n tpa:
\n usage: “Usage: \/tpa ”
\n sent: “Teleport request sent to {target}”
\n received: “{requester} wants to teleport to you.”<\/p>\n
\n countdown:
\n title: “Teleporting…”
\n subtitle: “Don’t move!”
\n message: “Teleporting in {seconds} seconds”
\n“`
\n## Customization Examples<\/p>\n
\n“`yaml
\nprefix: “[YoTPA] ”<\/p>\n
\n tpa:
\n usage: “Uso: \/tpa ”
\n sent: “Solicitud enviada a {target}”
\n received: “{requester} quiere teletransportarse a ti.”
\n“`<\/p>\n
\nprefix: “\u2726 YoTPA \u2726 ”<\/p>\n
\n countdown:
\n title: “Teleporting…”
\n message: “Teleporting in {seconds} seconds”
\n“`<\/p>\n
\nprefix: “[TPA] ”<\/p>\n
\n tpa:
\n sent: “Request sent to {target}”
\n“`<\/p>\n
\nprefix: “[YoTPA] ”<\/p>\n
\n success: “Teleported to {target} successfully!”
\n“`<\/p>\n
\n– `{player}` – Player name
\n– `{target}` – Target player name
\n– `{requester}` – Requester player name
\n– `{seconds}` – Number of seconds
\n– `{cooldown}` – Cooldown duration<\/p>\n
\n– `request-timeout` – How long (in seconds) teleport requests remain valid (recommended: 30-120)
\n– `request-cooldown` – Time (in seconds) before a player can send another request (recommended: 15-60)
\n– `teleport-delay` – Countdown time (in seconds) before teleportation happens (minimum: 1)<\/p>\n
\n– `performance.mode` – AUTO (recommended), ULTRA_LIGHT, LIGHT, BALANCED, or HIGH_PERFORMANCE
\n – AUTO automatically detects your server’s RAM and selects the best mode<\/p>\n
\n– All sounds use Minecraft’s sound registry format (lowercase with dots)
\n– The plugin validates sounds on config reload
\n– Full sound list: https:\/\/minecraft.wiki\/w\/Sounds.json<\/p>\n
\n– `statistics` – Enable or disable statistics tracking
\n– `bstats` – Enable or disable bStats metrics
\n– `titles` – Enable or disable title animations during countdown
\n– `sounds` – Enable or disable all sound effects<\/p>\n
\n– YAML syntax
\n– All values are in valid ranges
\n– Sounds exist in Minecraft’s registry
\n– Shows detailed error messages if invalid<\/p>\n
\n“`
\nConfiguration validation failed!
\n\u2717 teleport-delay must be at least 1 second
\n\u2717 Sound ‘countdown’ (invalid.sound) not found in registry<\/p>\n
\n\u2022 request-timeout (5) is very low, recommended: 30-120<\/p>\n
\nUsing previous configuration.
\n“`<\/p>\n
\n2. Save your changes
\n3. Use `\/tpareload` in-game to apply changes with validation<\/p>\n
\n| :—— | :———- | :——— |
\n| `\/tpa
\n| `\/tpaccept` | Accept a pending teleport request | `yotpa.tpaccept` |
\n| `\/tpadeny` | Deny a pending teleport request | `yotpa.tpadeny` |
\n| `\/tpahere
\n| `\/tpacancel` | Cancel your outgoing teleport request | `yotpa.tpacancel` |
\n| `\/tpatoggle` | Toggle receiving teleport requests | `yotpa.tpatoggle` |
\n| `\/tpareload` | Reload the plugin configuration | `yotpa.reload` |
\n| `\/tpainfo` | View plugin information and statistics | `yotpa.info` |
\n| `\/tpastats` | View teleport statistics | `yotpa.stats` |<\/p>\n
\n\/tpa
\n| :——– | :— | :———- |
\n| `player` | `string` | **Required**. The player name you want to teleport to |<\/p>\n
\n“`
\n\/tpa Steve # Request to teleport to player named Steve
\n\/tpa Alex123 # Request to teleport to player named Alex123
\n“`<\/p>\n
\n– You cannot send a request to yourself
\n– There is a configurable cooldown between sending requests (default: 30 seconds)
\n– Request will expire after a configurable time (default: 60 seconds)
\n– Target player will receive a notification with clickable accept\/deny buttons<\/p>\n
\n\/tpaccept
\n“`<\/p>\n
\n“`
\n\/tpaccept # Accept the pending teleport request
\n“`<\/p>\n
\n– Only works if you have a pending teleport request
\n– After accepting, the teleportation will begin with a countdown
\n– The player must stay still during the countdown or it will be cancelled
\n– If accepting a `\/tpa` request, the requester will teleport to you
\n– If accepting a `\/tpahere` request, you will teleport to the requester<\/p>\n
\n\/tpadeny
\n“`<\/p>\n
\n“`
\n\/tpadeny # Deny the pending teleport request
\n“`<\/p>\n
\n– Only works if you have a pending teleport request
\n– The requester will be notified that their request was denied
\n– Request is immediately removed from the system<\/p>\n
\n\/tpahere
\n| :——– | :— | :———- |
\n| `player` | `string` | **Required**. The player name you want to request to teleport to you |<\/p>\n
\n“`
\n\/tpahere Steve # Request Steve to teleport to you
\n\/tpahere Alex123 # Request Alex123 to teleport to you
\n“`<\/p>\n
\n– You cannot send a request to yourself
\n– There is a configurable cooldown between sending requests (default: 30 seconds)
\n– Request will expire after a configurable time (default: 60 seconds)
\n– The target player must accept with `\/tpaccept`<\/p>\n
\n\/tpacancel
\n“`<\/p>\n
\n“`
\n\/tpacancel # Cancel your pending request
\n“`<\/p>\n
\n– Only works if you have an active outgoing request
\n– The target player will be notified that the request was cancelled
\n– Useful if you sent a request by mistake<\/p>\n
\n\/tpatoggle
\n“`<\/p>\n
\n“`
\n\/tpatoggle # Toggle receiving teleport requests on\/off
\n“`<\/p>\n
\n– When toggled off, other players cannot send you teleport requests
\n– You will receive a message showing your current status
\n– Your setting persists across server restarts<\/p>\n
\n\/tpareload
\n“`<\/p>\n
\n“`
\n\/tpareload # Reload the plugin configuration
\n“`<\/p>\n
\n– Requires the `yotpa.reload` permission (default: op only)
\n– Validates YAML syntax and all configuration values
\n– Checks that all sounds exist in Minecraft’s registry
\n– Shows detailed errors if config is invalid
\n– Only applies config if all validation passes
\n– Useful after making changes to the config.yml file<\/p>\n
\n\/tpainfo
\n“`<\/p>\n
\n“`
\n\/tpainfo # View plugin info and stats
\n“`<\/p>\n
\n– Current performance mode (auto-detected based on RAM)
\n– Optimization level and settings
\n– Active teleport requests
\n– Ongoing teleports
\n– Memory usage statistics
\n– Plugin version<\/p>\n
\n– Useful for monitoring plugin performance
\n– Helps diagnose issues
\n– Shows how the plugin has optimized itself for your server<\/p>\n
\n\/tpastats
\n“`<\/p>\n
\n“`
\n\/tpastats # View teleport statistics
\n“`<\/p>\n
\n– Total teleport requests sent
\n– Total teleport requests received
\n– Success rate
\n– Most active players
\n– Other usage metrics<\/p>\n
\n– Requires `features.statistics: true` in config
\n– Statistics are tracked per player
\n– Data persists across server restarts<\/p>\n
\n– Keep mode as AUTO or ULTRA_LIGHT
\n– Limit total plugins to 5-8
\n– Set view-distance to 4 in server.properties
\n– Use Paper instead of Spigot
\n– Limit players to 5-10 concurrent<\/p>\n
\n– Use AUTO or BALANCED mode
\n– Can run 10-15 plugins
\n– view-distance 6-8
\n– 15-25 players should be fine<\/p>\n
\n– Use AUTO or HIGH_PERFORMANCE mode
\n– No significant plugin limitations
\n– view-distance 10-12
\n– 25+ players supported<\/p>\n
\n– **Thread-Safe** – No lag from concurrent operations
\n– **Memory Efficient** – Adapts to your server’s resources automatically
\n– **Async Operations** – Non-blocking task execution
\n– **Lock-Free** – No race conditions or deadlocks<\/p>\n
\n2. Place the JAR in your server’s `plugins` folder
\n3. Restart your server
\n4. That’s it! The plugin will auto-configure based on your server’s specs<\/p>\n
\n<\/p>\n