🌌 ssRTP — Next-Gen 3D Random Teleport Plugin

The futuristic, interactive 3D destination terminal & hazard-aware random teleportation system for modern Minecraft servers.

🌟 Why ssRTP?

Say goodbye to outdated, boring 2D chest menus. ssRTP brings teleportation into the modern era using native Minecraft Display Entities (BlockDisplay, ItemDisplay, TextDisplay, and Interaction).

A futuristic 3D holographic display floats directly in front of the player, featuring real-time hover elevation, floating levitation, custom dimension particles, interactive lore preview screens, and warp charging portal sequences — 100% vanilla client compatible with ZERO resource packs or client-side mods!

🚀 Key Features

🔮 100% Native 3D Display Entities — No armor stands, no invisible glitching, and no client mods or texture packs required.
👁️ Private Player Isolation — The 3D terminal is visible only to the player who opened it. Nearby players will never see visual clutter.
📐 Adaptive Symmetrical World Centering — Enabled worlds auto-center seamlessly! If you disable the End world, Overworld and Nether automatically adjust to the center and the panel resizes dynamically.
🖱️ Instant Left & Right-Click Support — Dual-layer input engine triggers teleportation whether players attack (left-click/arm swing) or interact (right-click) in Survival, Creative, or Adventure mode.
✨ Dynamic 3D Hover & Motion Animations:
- Hover Lift: Aiming at an icon glides it forward along the Z-axis with an interactive floating tilt.
- Thematic Particles: Emerald glimmers for Overworld, fire sparks for Nether, void rift particles for The End.
- Ambient Levitation: Harmonic sine-wave idle bobbing gives the terminal a living presence.
- Warp Charging Sequence: 3D spinning animation and swirling vortex before safe teleportation.
🎨 Universal Text & Color Formatting:
- MiniMessage gradients: <gradient:#00e5ff:#b388ff>Text</gradient>
- MiniMessage rainbow: <rainbow>Text</rainbow>
- Hex RGB formats: &#rrggbb, {#rrggbb}, <#rrggbb>, &x&r&r&g&g&b&b
- Standard legacy color codes: &a, &b, &l, etc.
- Full PlaceholderAPI (PAPI) integration across lore and messages.
🛡️ Intelligent Hazard Detection — Smart column scanning automatically avoids lava, fire, campfires, powder snow, cacti, magma, bedrock, and void.
🌌 Nether Ceiling Safety — Restricts Nether RTP between Y=32 and Y=120, preventing players from ever getting stuck on the roof.
📁 Clean Two-File Configuration:
- config.yml for engine settings, radius, and animation toggles.
- messages.yml for world lores, display names, and all system texts.

📜 Commands & Permissions

Command	Aliases	Description	Permission	Default
`/ssrtp`	`/rtp`, `/srtp`	Opens the 3D destination menu	`ssrtp.use`	Everyone (`true`)
`/ssrtp help`	—	Shows the interactive help list	`ssrtp.use`	Everyone (`true`)
`/ssrtp go <world>`	—	Teleport directly to a specified world	`ssrtp.use`	Everyone (`true`)
`/ssrtp version`	`/ssrtp ver`	Shows author & version information	`ssrtp.use`	Everyone (`true`)
`/ssrtp discord`	—	Displays the official Discord link	`ssrtp.use`	Everyone (`true`)
`/ssrtp open [player]`	—	Remotely opens the 3D menu for a player	`ssrtp.admin`	`op`
`/ssrtp status`	—	Checks active world availability & status	`ssrtp.admin`	`op`
`/ssrtp reload`	—	Reloads `config.yml` & `messages.yml` instantly	`ssrtp.admin`	`op`
`/ssrtp setworld <key>`	—	Binds your current world to a destination	`ssrtp.admin`	`op`
`/ssrtp setcenter <key>`	—	Sets RTP center coordinates to your location	`ssrtp.admin`	`op`
`/ssrtp cooldown reset [player]`	—	Clears teleport cooldown for a player	`ssrtp.admin`	`op`

Bypass Permission: ssrtp.bypass.cooldown (Default: op) — Bypasses teleport cooldown timers.

⚙️ Configuration Preview

📄 Click to expand config.yml (Engine & World Settings)

# ==============================================================================
#                                   ssRTP 1.0.1
#              Modern 3D Destination Display & Random Teleport Plugin
#                         Author: SugamDev (ssStudio)
# ==============================================================================

menu:
  distance: 2.7
  vertical-offset: -0.28
  info-board-top-offset: 1.42
  info-board-width: 2.30
  info-board-height: 1.70
  info-animation-ticks: 8
  background-depth: 0.35
  target-range: 4.5
  close-distance: 8.0
  timeout-seconds: 60
  open-animation-ticks: 12
  close-animation-ticks: 8
  background-material: BLACK_STAINED_GLASS
  info-background-material: GRAY_STAINED_GLASS

  animations:
    enabled: true
    hover-lift: true
    hover-particles: true
    idle-bobbing: true
    opening-stagger: true
    teleport-warp-effect: true
    warp-ticks: 14

worlds:
  overworld:
    enabled: true
    world: world
    display-item: GRASS_BLOCK
    min-radius: 500
    max-radius: 5000
    console-command: ''
    player-command: ''
  nether:
    enabled: true
    world: world_nether
    display-item: NETHERRACK
    min-radius: 250
    max-radius: 2500
    console-command: ''
    player-command: ''
  end:
    enabled: true
    world: world_the_end
    display-item: END_STONE
    min-radius: 500
    max-radius: 5000
    console-command: ''
    player-command: ''

rtp:
  attempts: 50
  cooldown-seconds: 120

sounds:
  menu-click: UI_BUTTON_CLICK

💬 Click to expand messages.yml (Translations, Lores & Texts)

# ==============================================================================
#                                   ssRTP 1.0.1
#                                  messages.yml
# ==============================================================================

menu:
  title: '&#3AFB00&lssRTP &8| &#ffffffWorld Select'
  subtitle: '&#3AFB00Choose your destination &8• &fLeft or right-click to travel'
  footer: ''
  close-label: '&#FF0000&l✘&r Close'
  close-preview: '&c&lCLOSE MENU\n&7Click to close'

worlds:
  overworld:
    display-name: '&#3AFB00&lOVERWORLD TELEPORT'
    preview-lore:
      - '&7▶ &fStatus: &#3AFB00{world_status}'
      - '&#3AFB00Safe random destination'
      - '&7▶ &fRadius: &#3AFB00{min_radius}–{max_radius} blocks'
      - ''
      - '&7▶ &#3AFB00Left or right-click to travel'
  nether:
    display-name: '&#ff0000&lNETHER TELEPORT'
    preview-lore:
      - '&7▶ &7Status: {world_status}'
      - '&#FF0000Lava-aware safe search'
      - '&7▶ &7Radius: &f{min_radius}–{max_radius} blocks'
      - ''
      - '&7▶ &#FF0000Left or right-click to travel'
  end:
    display-name: '&#FFDB66&lTHE END TELEPOR'
    preview-lore:
      - '&7▶ &fStatus: &#FFDB66{world_status}'
      - '&#FFDB66Void-aware safe search'
      - '&7▶ &fRadius: &#FFDB66{min_radius}–{max_radius} Blocks'
      - ''
      - '&7▶ &#FFDB66Left or right-click to travel.'

messages:
  players-only: '&#FF4B2BThis command can only be used by a player.'
  no-permission: '&#FF4B2BYou do not have permission to use that ssRTP command.'
  menu-open: '&#78FFD6Aim at a destination icon, then left- or right-click to travel.'
  world-disabled: '&#FF4B2BRTP is disabled for &#FFFFFF{world}&#FF4B2B.'
  world-not-found: '&#FF4B2BWorld &#FFFFFF{world} &#FF4B2Bwas not found. Set it with &#FFFFFF/ssrtp setworld <world-key>&#FF4B2B.'
  searching: '&#00E5FFSearching for a safe location in &#FFFFFF{world}&#7F7F7F...'
  success: '&#00FF88Teleported to &#FFFFFF{world} &#00FF88at &#FFFFFF{x}, {y}, {z}&#00FF88!'
  failed: '&#FF4B2BNo safe location found in &#FFFFFF{world}&#FF4B2B. Try again or adjust radius.'
  cooldown: '&#FF6A00Please wait &#FFFFFF{seconds}s &#FF6A00before using RTP again.'
  reloaded: '&#00FF88ssRTP configuration reloaded successfully.'
  player-not-found: '&#FF4B2BPlayer &#FFFFFF{player} &#FF4B2Bis not online.'
  menu-opened-for: '&#00FF88Opened the RTP menu for &#FFFFFF{player}&#00FF88.'
  status-header: '&#00E5FF&lssRTP &#808080| &#B0B0B0World status'

🛠️ Installation & Setup

Download ssRTP-1.0.1.jar.
Drop it into your server's plugins/ folder.
Restart your server.
Customize plugins/ssRTP/config.yml and plugins/ssRTP/messages.yml to your liking.
Run /ssrtp reload to apply all changes instantly!

💻 Technical Specifications

Tested Server Software: Paper, Purpur, Folia, Spigot
Supported Versions: 1.19.4, 1.20.x, 1.21.x and newer
Required Java Version: Java 17+
Dependencies: None! (Optional: PlaceholderAPI for placeholders)

💬 Community & Support

Have questions, suggestions, or need help configuring the plugin? Join our official community:

👥 Discord Server: discord.gg/9wan5xYg8c
👨‍💻 Authers: SugamDev & DraculazXD
🏢 Studio: SS Studio

ssRTP

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details