WildRTP++

A feature rich lightweight and simple random teleport plugin built originally for fun and for playing with friends — and now available for everyone.
Powered by Paper and compatible with Multiverse-Core, this plugin allows players to teleport to a random location in any world with optional invite mechanics.

✨ Features

• 🚀 Random teleport with configurable range
• 🌍 Full support for Overworld, Nether, and End
• 🔁 Optional Multiverse-Core world selection
• 🧠 Safe-Teleport system (avoids lava, void, caves, etc.)
• 🕒 Configurable cooldowns, delays, and movement cancellation
• 👥 Invite system — teleport solo or with friends
• ⚔️ PvP or movement cancels pending teleports
• ⚙️ Lightweight & beginner-friendly configuration

_____________________________________________________________________________________________

🧭 Commands

• /wild - Teleports you to a random location (range configurable & Multiverse compatible)
• /wildinvite - Invite players to teleport with you (max invites configurable)
• /wildaccept - Accept a teleport invite
• /wilddeny -Deny a teleport invite

Config.yml

Config.yml
# WildRTP++ Configuration
# By uCruz_

# Language: en_US (English) or pt_BR (Portuguese Brazil)
language: en_US

# General teleport settings
teleport:
  # Warmup time before teleport (in seconds)
  warmup-time: 10
  
  # Cooldown between teleports (in seconds)
  cooldown: 180
  
  # Minimum distance from spawn (in blocks)
  min-distance: 500
  
  # Maximum distance from spawn (in blocks)
  max-distance: 5000
  
  # Try to find safe location (max attempts)
  max-attempts: 25
  
  # Cancel teleport if player moves
  cancel-on-move: true
  
  # Cancel teleport if player is in PvP
  cancel-on-pvp: true
  
  # PvP time (in seconds) - player is considered in combat
  pvp-time: 10

# Allowed worlds for teleport
worlds:
  enabled:
    - world
    - world_nether
    - world_the_end
  
  # Default world if player is in a non-allowed world
  default-world: world

  # Map origin worlds to destination worlds
  # Format: origin_world: destination_world
  # If you want to teleport to the same world, leave empty or use the same name
  # You can use Multiverse world names here
  # 
  # Examples:
  # teleport-destinations:
  #   world: "world"              # Normal world -> stays in normal world
  #   world_nether: "world"       # Nether -> teleports to normal world
  #   world_the_end: "world"      # End -> teleports to normal world
  #   lobby: "survival"           # Lobby -> teleports to survival world (Multiverse)
  #
  # Leave empty {} to teleport in the same world the player is currently in
  teleport-destinations:
    world: "world_farm"
    world_nether: "world_nether"
    world_the_end: "world_the_end"

# Per-world teleport settings (optional)
# Override global settings for specific worlds
world-settings:
  world_nether:
    # Nether-specific distance (smaller range recommended)
    min-distance: 100
    max-distance: 1000
    # Min/Max Y levels for Nether teleports
    min-y: 32
    max-y: 120
  world_the_end:
    min-distance: 100
    max-distance: 500

# Group invite system
group:
  # Maximum players that can be invited
  max-invites: 5
  
  # Invite expiration time (in seconds)
  invite-timeout: 30
  
  # Update action bar every X ticks (20 ticks = 1 second)
  actionbar-update-interval: 10

# Dangerous blocks (plugin will avoid teleporting to these blocks)
dangerous-blocks:
  - LAVA
  - WATER
  - CACTUS
  - MAGMA_BLOCK
  - FIRE
  - SOUL_FIRE
  - CAMPFIRE
  - SOUL_CAMPFIRE
  - SWEET_BERRY_BUSH
  - POWDER_SNOW
  - WITHER_ROSE

# Sounds
sounds:
  # Sound when starting teleport
  start:
    enabled: true
    sound: ENTITY_ENDERMAN_TELEPORT
    volume: 1.0
    pitch: 1.0
  
  # Sound when completing teleport
  complete:
    enabled: true
    sound: ENTITY_ENDERMAN_TELEPORT
    volume: 1.0
    pitch: 1.2
  
  # Sound when cancelling teleport
  cancel:
    enabled: true
    sound: ENTITY_VILLAGER_NO
    volume: 1.0
    pitch: 1.0

# Notifications
notifications:
  # Notification type: CHAT, TITLE, BOTH, NONE
  type: BOTH
  
  # Title configuration
  title:
    fade-in: 10
    stay: 40
    fade-out: 10