BlanketRTP

BlanketRTP is a feature-rich, server-side Fabric mod that provides a fun, safe, and highly configurable random teleportation (RTP) system for your world. Whether you want to let players explore random locations, hunt for specific biomes, or gently glide down from the sky, BlanketRTP offers a polished and performant solution.

---

---

Dependencies

• Fabric API
• Fabric Language Kotlin
• E-Utils (EverlastingUtils)

---

Features

• Standard & Biome RTP: Teleport to a random safe location with /rtp or target a specific biome with /rtp biome <biome_id>.
• Smooth Gliding Mechanic: Instead of just appearing, players can be teleported high into the air and automatically start gliding, complete with customizable particle effects and a visually equipped Elytra.
• Performance-Focused "Slow Load": Prevents server lag (TPS drops) when teleporting to new chunks by pre-loading the destination area slowly before the player arrives.
• Tiered Cooldown System: Create different cooldowns for different player ranks using permissions (e.g., VIPs get a shorter cooldown).
• Dimension Redirection: Force players who use /rtp in certain dimensions (like The End or The Nether) to be teleported to a different, designated world.
• Extensive Configuration: Control everything from the teleport radius and cooldowns to the glider item's NBT, particle effects, and all user-facing messages.
• Admin Tools: Reload the configuration live with /rtp reload and forcibly stop a player's glide if needed.

---

Commands

The primary command is /rtp. All permission nodes are fully configurable in the config file.

Command	Permission	Description
/rtp	blanketrtp.rtp	Teleports the player to a random safe location.
/rtp no_glide	blanketrtp.rtp.noglide	Performs a random teleport but forces the gliding mechanic to be off for this one use.
/rtp biome <biome_id>	blanketrtp.rtp.biome	Finds and teleports the player to a random location within the specified biome.
/rtp biome <biome_id> no_glide	blanketrtp.rtp.biome	Teleports to a specific biome with gliding forced off.
/rtp reload	blanketrtp.admin.reload	Reloads the blanketrtp.json configuration file from disk.
/rtp stopgliding <player>	blanketrtp.admin.stopgliding	Forcibly stops the RTP-induced glide for the specified player.

---

Configuration

BlanketRTP uses a single, comprehensive configuration file located at config/blanketrtp/blanketrtp.json. It allows for deep customization of nearly every feature.

Main RTP Settings

• rtpRadius: The maximum distance (in blocks) from the world's center (0,0) that a player can be teleported to.
• dimensionRedirects: A powerful feature to control RTP across dimensions. By default, it's configured to send anyone who uses /rtp in The Nether or The End to the Overworld. You can remove these entries to allow RTP within those dimensions or add your own custom redirects.
• cooldowns: This list allows you to create a tiered cooldown system. The mod checks permissions from top to bottom. You can define tiers for different ranks (e.g., blanketrtp.cooldown.vip) and a default fallback with an empty permission ("").

Gliding System (glidingOptions)

This section controls the "drop from the sky" mechanic.

Setting	Description
enabled	The master switch to turn the gliding mechanic on or off globally.
teleportHeight	The height (Y-level) above the ground that players are teleported to before they start gliding.
particlesEnabled	Toggles the trail of particles that follows a player while they are gliding. You can customize the particleType, amount, and more.
glider	Controls the item visually equipped on the player. You can change the gliderItemId (e.g., to a custom-textured Elytra) and even specify its NBT data with gliderNbtData to make it appear enchanted or have a specific custom model.

Performance (slowLoadOptions)

This section is crucial for preventing lag on servers, especially when players teleport to ungenerated chunks.

• enabled: If true, the mod will slowly pre-load the chunks at the destination before teleporting the player.
• radius: The radius of chunks to load around the destination. A radius of 1 loads a 3x3 chunk area.
• loadDelayMillis: The pause (in milliseconds) between loading each chunk in the queue. A higher value means a slower, but smoother, teleport preparation that is less likely to impact server performance.
• keepLoadedSeconds: How long the chunks are kept force-loaded after the player arrives to ensure a smooth landing.

Messages

• Every message sent to the player is configurable, from cooldown notifications to success messages. They all support MiniMessage formatting, allowing for gradients, custom colors, and more.