CustomRTP – Random Teleport & Region Manager
⚡ Dependencies


This plugin requires LuckPerms (latest version) for region permissions and advanced permission handling.





Dependency Purpose Required?
LuckPerms Permission management per region ✅



Download LuckPerms:
LuckPerms SpigotMC
LuckPerms Website



Make sure LuckPerms is installed and loaded before using CustomRTP!
The plugin will NOT work without luckperms!


Features


Region-Based Random Teleport: Players can teleport randomly to specific regions.

Region Selector: Easy region selection with in-game tool.

Advanced Permission System: Assign permission per region; players can only teleport to allowed regions.

Cooldown & Delay: Prevent spam with teleport cooldown and delay.

GUI Support: Stylish GUI menu for region selection and deletion.

Multi-Language Support: Turkish, English, French, German, Russian, Chinese, Portuguese, and more.

Blacklist (Blocked Biomes & Blocks): Block teleporting to specific biomes or blocks.

Admin Panel & Reload: Instantly reload all settings with a single command.

Custom Tool: Region selection tool (Blaze Rod) for easy setup.

Error-Proof Controls: Auto-repair for missing/corrupt files, automatic language syncing, and more.





Commands


Command Description Permission
/rtp <region> Randomly teleports player to a selected region customrtp.use
/rtpgui Opens GUI to view and manage all regions customrtp.admin
/rtptool Gives you the region selection tool (Blaze Rod) customrtp.tool
/rtpreload Reloads all plugin and language files customrtp.admin





Permissions


Permission Description
customrtp.use Allows using RTP commands and GUI
customrtp.region.<region> Permission for teleporting to a specific region
customrtp.tool Allows using the region selection tool
customrtp.admin Allows all admin/reload commands
customrtp.bypass Bypass cooldown and delay restrictions





Plugin Highlights


Region Selection:
Use Blaze Rod to select two points, type the region name in chat, and the region is saved.

Teleport Delay:
After using /rtp, players must stand still for X seconds, or teleport is cancelled.

Teleport Cooldown:
Players must wait a set time before using /rtp again.

Blacklist:
Prevent teleporting to specific biomes or blocks via config.

Languages:
All language files are auto-generated and synced under /plugins/CustomRTP/lang/.

GUI Region Management:
Left-click to teleport, right-click to delete a region in the GUI.

Region Selector:
Define regions easily using the in-game selector

Self-Healing System:
Plugin auto-repairs broken or missing language/config files.





Config Example

cooldown-seconds: 15
delay-seconds: 3
language: lang_en


blocked-biomes:
- OCEAN
- DEEP_OCEAN
- RIVER
- FROZEN_OCEAN

blocked-blocks:
- LAVA
- WATER
- CACTUS
- MAGMA_BLOCK
- FIRE
- CAMPFIRE






Quick Usage


Use /rtptool → get Blaze Rod → select 2 corners → type region name in chat.

Use /rtpgui → open GUI → left-click to teleport, right-click to delete region.

Use /rtp <region> → randomly teleport to the selected region.





Troubleshooting


Plugin or language file missing/corrupt? Auto-fixes itself on startup.

Permission problems? Easily manage with LuckPerms or your favorite permissions plugin.





Feature Overview


Feature Available?
Region Selection ✅
GUI Menu ✅
Cooldown/Delay ✅
Multi-language Support ✅
Block/Biome Blacklist ✅
Admin Commands ✅

Premium Features (Planned)
These features are currently under development and will be exclusive to the Premium version of CustomRTP.

Full Advanced GUI:
Drag & drop region editing, custom icons, advanced filtering, region info popups, mass region import/export.

WorldEdit/FAWE Full Integration:
Import and export regions with one click, auto-detect WorldEdit selections, visualize regions directly in-game.

Region Flags & Advanced Rules:
Per-region PvP toggle, entry/exit commands, scheduled open/close times.

BungeeCord/Network Teleport:
Cross-server teleporting with region sync between multiple servers/networks.

Region Leaderboards:
Show top players by region usage in an interactive GUI, rewards for most-used regions.

Personalized RTP:
Allow players to create private/personal regions and manage their own RTP spots.

Enhanced Effects:
Custom particles, sounds, visual trails, and animated GUIs for all teleports.

Priority Teleport:
Premium users get reduced cooldowns/delays, bypass queue, or priority access.

Web Panel Integration:
Manage regions and settings via a modern web dashboard.

Want to unlock these features?
Stay tuned for the Premium release – and share your ideas or feature requests on Discord or in the plugin thread!