# YATPA<\/p>\n
<\/p>\n
YATPA is a teleport plugin\/mod project for modern Minecraft servers:
\n– `paper\/`: Paper plugin (1.21.x API target)
\n– `fabric\/`: Fabric dedicated-server mod (1.21.x Mojmap\/Fabric API scaffold)<\/p>\n
What makes YATPA stand out is that it combines full teleport-request\/home\/back\/spawn\/RTP\/death tooling with a clickable in-chat command UX (`\/tp` menu, paged pickers, and paged logs), while also exposing granular cost controls per teleport type. Economy mode is configurable as `NONE`, `XP_LEVELS`, `ITEM`, or `CURRENCY`; Paper supports `CURRENCY` through Vault (with EssentialsX or another Vault economy provider). OPs have an optional GUI menu to fine tune settings in-game.<\/p>\n
## Screenshots<\/p>\n
#### Help (via \/TPAHELP)
\n
\n#### Clickable TP Menu (via \/TP)
\n
\n#### Clickable TP Logs for OPs (via \/TPLOG)
\n
\n#### Clickable Home List (via \/TPHOME LIST)
\n
\n#### Clickable User List (via \/TPA with no username specified)
\n<\/p>\n
## Features<\/p>\n
– Clickable teleport menu: ## Notable Behavior<\/p>\n – Requests: ## Configuration<\/p>\n Paper config files: Fabric default config\/resource files: Runtime data (Paper) is stored under plugin data folder: Runtime data (Fabric) is stored under: ### Example Config YAML<\/p>\n “` Fabric `config.properties` supports the same restrictions with either: ## Permissions (Paper)<\/p>\n – `yatpa.op.reload` (default: op) ## License<\/p>\n Licensed under `GNU General Public License v3.0` (GPL-3.0-only). See [LICENSE](LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":" YATPA: A combination of various project ideas into one, but still lean and simple enough to be a viable replacement or solution to teleporting. Suitable for Fabric and Paper.<\/p>\n","protected":false},"featured_media":173089,"template":"","meta":{"_minecraft_slug":"yet-another-tpa","_minecraft_project_id":"uXOzLvOp","_minecraft_author":"cev-api","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":401,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yet-another-tpa.zip","_minecraft_size_bytes":1103668,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T10:59:26.507006Z","_minecraft_date_created":"2026-03-08T06:31:35.471571Z","_minecraft_date_modified":"2026-05-01T06:22:50.639330Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yet-another-tpa","_minecraft_icon_attachment_id":173089,"_minecraft_imported_at":"2026-06-09T22:33:20+00:00","_minecraft_import_hash":"ab48f0a68ce75223adfece002ab42667","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,97,89,126,127,92],"mod_loader":[99,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-173088","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-fabric","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-fabric","mod_loader-paper","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 – `\/tp`
\n – Includes shortcuts for homes, RTP, spawn, death-back, TPA\/TPHere, toggle, block, and unblock.
\n – Player pickers are paginated (5 per page) for `\/tpa`, `\/tphere`, `\/tpablock`, and `\/tpaunblock`.
\n– Player teleport requests:
\n – `\/tpa
\n – `\/tpahere
\n – `\/tpaccept`
\n – `\/tpdeny`
\n – `\/tpatoggle`
\n – `\/tpablock
\n – `\/tpaunblock
\n– Homes:
\n – `\/tphome set [name]`
\n – `\/tphome set default
\n – `\/tphome delete
\n – `\/tphome list`
\n – `\/tphome [name]` or `\/tpahome [name]`
\n – Home list is clickable and shows coordinates.
\n – The default home is marked with `(default)`.
\n– Utility teleports:
\n – `\/rtp`
\n – `\/spawn`
\n – `\/tpaback` or `\/tpdeath` (last death location, one use per death)
\n– OP commands:
\n – `\/ytp
\n – `\/ytp
\n – `\/ytp
\n – `\/ytp
\n – `\/tpoffline
\n – `\/tpalog [page]`
\n– In-game admin config (OP):
\n – `\/yatpa settings`
\n – `\/yatpa gui` (Paper, paginated inventory editor for all settings; click to toggle\/edit)
\n – `\/yatpa set
\n – `\/yatpa reload`
\n – `\/setspawn`
\n– Player help page:
\n – `\/tpahelp`
\n – `\/tphelp`
\n – `\/yatpa help`
\n – Public help intentionally excludes admin commands.
\n – When teleport costs are enabled, a `Costs` section is shown at the bottom listing only teleports with non-zero costs.<\/p>\n
\n – Timeout + cooldown are enforced.
\n – Accept\/deny messages are clickable.
\n – If an accepted delayed teleport is cancelled (move\/damage), the other player is notified.
\n– Teleports:
\n – Delayed teleports show a countdown.
\n – Costs are validated before countdown and charged on execution.
\n – Players are told exactly what they paid (XP, items, or currency).
\n – `ytp`\/`rtp` use safe landing checks to avoid unsafe blocks and lava.
\n – `\/tpaback` and `\/tpdeath` consume the saved death location after successful use, and require a new death to refresh.
\n– Teleport logging:
\n – `\/tpalog` is paginated and clickable.
\n – Log lines include context details (for example home name, target player, coords, or offline target) where relevant.
\n– Costs and settings:
\n – Cost modes: `NONE`, `XP_LEVELS`, `ITEM`, `CURRENCY`.
\n – Realm-specific RTP costs and min\/max RTP distance overrides are supported.
\n – Paper `\/yatpa gui` and `\/yatpa set` expose currency paths directly.
\n– Restrictions and routing:
\n – Per-dimension restrictions can disable `\/rtp` only or all YATPA teleports.
\n – `\/rtp` supports blacklist + optional overworld routing.
\n – Spawn destination is configurable via `settings.spawn.*` and `\/setspawn`.
\n– Platform note:
\n – Vault\/EssentialsX currency charging is Paper-only in this release.
\n – Command\/UX behavior in this README applies to both Paper and Fabric unless noted.<\/p>\n
\n– `paper\/src\/main\/resources\/config.yml`
\n– `paper\/src\/main\/resources\/messages.xml`
\n– `paper\/src\/main\/resources\/plugin.yml`<\/p>\n
\n– `fabric\/src\/main\/resources\/yatpa-fabric.properties`
\n– `fabric\/src\/main\/resources\/yatpa-fabric.yml`
\n– `fabric\/src\/main\/resources\/messages-fabric.xml`<\/p>\n
\n– `data\/players.yml`
\n– `data\/homes.yml`
\n– `data\/offline.yml`<\/p>\n
\n– `config\/yatpa\/store.json`<\/p>\n
\nsettings:
\n max_homes_default: 3
\n request_timeout_seconds: 60
\n request_cooldown_seconds: 30
\n teleport_delay_seconds: 5
\n cancel_on_move: true
\n cancel_on_damage: true
\n spawn_radius: 50
\n rtp_cooldown_seconds: 300
\n rtp:
\n default_min_distance: 64
\n default_max_distance: 2500
\n rtp_to_overworld: false
\n overworld_name: “world”
\n blacklisted_worlds: []
\n # Optional per-realm overrides
\n realm_min_distance:
\n overworld: 96
\n nether: 48
\n end: 128
\n realm_max_distance:
\n overworld: 3000
\n nether: 1500
\n end: 4000
\n dimension_restrictions:
\n # Use world names, realm aliases (overworld\/nether\/end), or namespaced ids.
\n # For namespaced ids in YAML, quote the key, for example “minecraft:the_nether”.
\n disable_rtp:
\n nether: true
\n disable_teleport:
\n # “minecraft:the_end”: true
\n landing:
\n mode: EXACT # EXACT or RANDOM_OFFSET
\n random_offset_max: 4
\n features:
\n enabled: true
\n tpa: true
\n tpahere: true
\n homes: true
\n rtp: true
\n costs:
\n enabled: false
\n mode: NONE # NONE, XP_LEVELS, ITEM, CURRENCY
\n xp_levels:
\n tpa: 4
\n tpahere: 4
\n home: 16
\n back: 0
\n # Per-realm RTP overrides (optional; overrides global if set)
\n rtp:
\n overworld: 30
\n nether: 0
\n end: 0
\n spawn: 8
\n item:
\n material: DIAMOND
\n tpa: 2
\n tpahere: 2
\n home: 20
\n back: 0
\n # Per-realm RTP overrides (optional; overrides global if set)
\n rtp:
\n overworld: 30
\n nether: 0
\n end: 0
\n spawn: 10
\n currency:
\n tpa: 0.0
\n tpahere: 0.0
\n home: 0.0
\n back: 0.0
\n # Per-realm RTP overrides (optional; overrides global if set)
\n rtp:
\n overworld: 0.0
\n nether: 0.0
\n end: 0.0
\n spawn: 0.0
\n spawn:
\n enabled: true
\n x: 0
\n y: 100
\n z: 0
\n yaw: 0
\n pitch: 0
\n world: world
\nsounds:
\n request_sent: ENTITY_EXPERIENCE_ORB_PICKUP
\n request_received: BLOCK_NOTE_BLOCK_PLING
\n countdown: BLOCK_BELL_USE
\n success: ENTITY_ENDERMAN_TELEPORT
\n cancelled: BLOCK_GLASS_BREAK
\neffects:
\n request_sent: PORTAL
\n request_received: ENCHANT
\n countdown: WAX_OFF
\n success: END_ROD
\n cancelled: SMOKE
\n“`<\/p>\n
\n– `settings.dimension_restrictions.disable_rtp=overworld,minecraft:the_nether`
\n– `settings.dimension_restrictions.disable_teleport=minecraft:the_end,my_custom_dimension`
\n– Dynamic keys like `settings.dimension_restrictions.disable_teleport.minecraft:the_nether=true`<\/p>\n
\n– `yatpa.op.tp` (default: op)
\n– `yatpa.op.tpoffline` (default: op)
\n– `yatpa.op.tpalog` (default: op)
\n– `yatpa.op.setspawn` (default: op)<\/p>\n