Module: rtp

Overview

Module

Provides random teleportation.

Color Boxes

Note

◉ Features

• Per-dimension settings

• Real-time searching feedback.

• Full async chunk loading and chunk generation. (Lag-free)

• Customization of center x and center z

• Customization of min range and max range

• Supported circle and rectangle shape.

• Respect world border.

• Skip any liquid block.

• Filter the result by min Y and max Y

• Filter the result by specified blocks

• Filter the result by specified biomes

• Filter the result by chunk inhabited time

Tip

◉ Improve the performance of rtp.

It's highly recommended to pre generate the world chunks using chunky mod.

If the target chunk is not generated, then we have to generate it while doing the random teleport.

To generate a chunk requires about 2 seconds to 10 seconds.

Which will slow down the process of /rtp.

If you pre generates the world chunks, then it will be fast.

Tip

◉ Limit the usage of /rtp command

You can use command_cooldown module, to setup a cooldown for /rtp command.

To prevent abuse.

Configurations

The following JSON content is provided for reference only. It must NOT be copied directly into the configuration directory, as it does not represent valid JSON syntax.

Config

• File Name: config.json
• File Content:

Click to see the default content...

config/fuji/modules/rtp/config.json

{
  /* Define `rtp` setup for each `dimension`. */
  "dimensions": {
    "settings": [
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "minecraft:overworld"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 1000
        /* See `minRange`. */,
        "max_range": 5000
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": -64
        /* See `minY`. */,
        "max_y": 320
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      },
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "minecraft:the_nether"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 1000
        /* See `minRange`. */,
        "max_range": 5000
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": 0
        /* See `minY`. */,
        "max_y": 128
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      },
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "minecraft:the_end"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 1000
        /* See `minRange`. */,
        "max_range": 5000
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": 0
        /* See `minY`. */,
        "max_y": 256
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      },
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "fuji:overworld"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 1000
        /* See `minRange`. */,
        "max_range": 5000
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": -64
        /* See `minY`. */,
        "max_y": 320
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      },
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "fuji:the_nether"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 1000
        /* See `minRange`. */,
        "max_range": 5000
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": 0
        /* See `minY`. */,
        "max_y": 128
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      },
      {
        "enable": true
        /* The `target dimension` of this setup. */,
        "dimension": "fuji:the_end"
        /* The `center x` used as the `origin` for `rtp`. */,
        "center_x": 0
        /* See `centerX`. */,
        "center_z": 0
        /* Use `circle` shape or `rectangle` shape for `rtp`? */,
        "circle": false
        /* The `relative x/z distance` is ranged `(minRange, maxRange]`. */,
        "min_range": 0
        /* See `minRange`. */,
        "max_range": 48
        /* The `relative y distance` is ranged `(minY, maxY]`. */,
        "min_y": 0
        /* See `minY`. */,
        "max_y": 256
        /* Max try times before aborting a `rtp` request. */,
        "max_try_times": 16,
        "async_chunk_loading_timeout_ticks": 200,
        "chunk_inhabited_time_lower_than_ticks": 6000,
        "biomes": {
          "skip": [
            "minecraft:deep_cold_ocean",
            "minecraft:cold_ocean",
            "minecraft:frozen_ocean",
            "minecraft:deep_frozen_ocean",
            "minecraft:ocean",
            "minecraft:deep_ocean",
            "minecraft:lukewarm_ocean",
            "minecraft:warm_ocean",
            "minecraft:deep_lukewarm_ocean"
          ],
          "only_accept_biomes_mode": {
            "enable": false,
            "accept": [
              "minecraft:mushroom_fields",
              "minecraft:plains"
            ]
          }
        },
        "blocks": {
          "skip": [
            "minecraft:magma_block",
            "minecraft:cactus",
            "minecraft:powder_snow",
            "minecraft:void_air",
            "minecraft:sweet_berry_bush",
            "minecraft:campfire",
            "minecraft:fire"
          ]
        }
      }
    ]
  }
}

Commands

Command

• Command Syntax: /rtp [Dimension dimension]

• Document: Random rtp in specified dimension.

• Can be executed by console: false

• Required Level Permission: 0

• Required String Permission: null

Command

• Command Syntax: /rtp others <PlayerCollection others> [Dimension dimension]

• Document: Random rtp in specified dimension.

• Can be executed by console: true

• Required Level Permission: 4

• Required String Permission: null