Configuration

The configuration system for BlanketRTP has been overhauled in version 2.0. This file allows you to manage teleportation logic, dimension handling, performance settings, and visual effects.

File Location: config/blanketrtp/blanketrtp.json


Core RTP Options

Basic settings for the random teleportation mechanics.

"rtpEnabled": true,
"rtpRadius": 5000
  • rtpEnabled: Toggles the RTP mechanics globally.

  • rtpRadius: The maximum radius (in blocks) from the center of the world (0,0) where players can be teleported.


Dimension Redirects

Instead of a simple "blocked" list, BlanketRTP now uses a redirection system. If a player runs /rtp in a specific dimension, you can force them to teleport into a different one.

"dimensionRedirects": [
  {
    "from": "minecraft:the_end",
    "to": "minecraft:overworld"
  },
  {
    "from": "minecraft:the_nether",
    "to": "minecraft:overworld"
  }
]
  • from: The dimension the player is currently in.

  • to: The dimension the player will be sent to.

  • Note: If you want players to RTP normally within the End or Nether, simply remove these entries from the list.


Cooldown Management

Cooldowns are now tier-based, allowing you to give shorter wait times to ranked players or staff.

  • cooldownBypassPermission: Players with this permission ignore all cooldowns.

  • cooldowns: A list of tiers. The mod checks these top-to-bottom.

    • permission: The node required for this tier. Leave empty ("") for the default tier applicable to everyone.

    • duration: Time in seconds the player must wait.


Gliding Options

Settings for the "drop from the sky" mechanic.

General & Visuals

  • teleportHeight: The Y-level players are teleported to (drop height).

  • particlesEnabled: Toggles trail particles while gliding.

  • particleType: The ID of the particle to display.

Glider Item

Controls the item equipped automatically to allow flight (e.g., Elytra).

  • gliderSlot: The inventory slot to equip the item to (e.g., CHEST).

  • gliderItemId: The resource location of the item.

  • gliderNbtData: Raw NBT data string for the item. Use this for enchantments, names, or custom model data.

    • Example for Unbreaking: "{Damage:0,Enchantments:[{id:unbreaking,lvl:3}]}"


Performance (Slow Load)

To prevent server lag (TPS drops) when teleporting to ungenerated chunks, BlanketRTP can pre-load the area slowly before teleporting the player.

  • radius: The radius of chunks to load. 1 results in a 3x3 chunk area.

  • loadDelayMillis: The pause (in milliseconds) between loading each chunk. Higher numbers = smoother server performance but slower teleport startup.

  • keepLoadedSeconds: How long chunks stay forced loaded to ensure the player lands safely.


Biome RTP Settings

Settings for the /rtp biome <biome> command.

  • biomeMaxAttempts: How many random spots the mod checks to see if the biome matches.

  • biomeSearchBatchSize: How many chunks to check per tick (performance setting).


Permissions Configuration

You can customize the actual permission nodes and their default OP levels directly in the config.


Messages

Messages support MiniMessage formatting (e.g., <red>, <gradient:red:blue>).

Applying Changes: After editing the file, use /rtp reload to apply changes immediately without restarting the server.

Last updated