Custom Structure

Create Custom Structure

  • Create a small structure (Max 16x16x16)

  • Place a bedrock as the position of the waystone later

  • Do /ws wand

  • Select the lowest position of your structure using left click

  • Select the highest position of your structure using right click

  • Do /ws save structure <structure name>

  • Check if your structure is successfully loaded using the command /ws listStructure

  • To check if your structure is properly saved, you can do /ws testStructure <structure name> and it will place the structure on your position relative to the lowest structure position.

  • Go see your structures.yml and add a structure manually

Structures.yml

Enable Structure Generation: false
# Warning: In order to keep the balance of the waystone usage
# It is highly recommended keeping the waystone rare as if
# making it very easy to obtain will allow players to abuse the
# waystone system.
Structures:
    # The structure name can be seen on the file name
    # Example: "demo.bin", then the name is "demo"
  - Structure Name: "demo"
    # Waystone Type must qualify these requirements:
    # - must allow all players to activate and use the waystone
    # - does not load and visible to all players at startup
    Waystone Type: public
    Waystone Environment: NORMAL
    Waystone Model: regular
    # Rename the generated waystone.
    # Will pick one of these names randomly.
    # Make it empty to disable auto renaming.
    Auto Rename:
      - Generated Waystone
      - Naturally Spawned Waystone
    # If one of these values above are not valid / not found, then this structure will not be generated
    Condition:
      # Only spawn on a new generated chunks
      Only New Chunks: true
      # Prevents structure to generate on spawn protected areas
      # as players will never be able to activate and use it anyway (except for Operators)
      Not At Spawn Protection: true
      # On what world can the structure spawn?
      # Set it empty to enable for all world
      Worlds:
        - my_example_world
      # The spawn chance percentage
      Spawn Chance Percentage: 80
      # every N of X * 16 coordinate
      # example, using value "10", will spawn the structure every 160 blocks at X axis
      # (also depends on Z Chunk distance)
      X Chunk Distance: 30
      # every N of Z * 16 coordinate
      # example, using value "10", will spawn the structure every 160 blocks at Z axis
      Z Chunk Distance: 30
      # The offset X coordinate range for the structure to spawn
      X Offset Range:
        Min: 5
        Max: 10
      # The offset z coordinate range for the structure to spawn
      Z Offset Range:
        Min: 5
        Max: 10
      # If true, it will find the highest block possible
      # If false, it will find the lowest block possible
      Spawn From Above: true
      # If Spawn From Above is true, and this is also true,
      # it will find the highest block, ignoring any tree leaves
      Ignore Trees: true
      # On what dimension can the structure spawn?
      Dimensions:
        - NORMAL
      # On what biomes can the structure spawn?
      # Set it to empty to enable for all biomes
      # Biomes: []
      Biomes:
        - PLAINS
        - SAVANNA
        - MOUNTAINS
        - DESERT
      # Prevents the structure to spawn on void
      Not On Void: true
      # Prevents floating structure by placing the structure on the lowest ground level
      # This is the most case for non-flat surface.
      Place On The Lowest Block Possible: false
  # You can use the template above to create more structures, remember that, there can only be 1 structure on a chunk.

Enable Structure Generation

This option controls whether the structure generation feature is enabled on your server. (Default to false). To enable this, set it to true

Structures

A list of map of Structure Configuration

Structure Name

The structure file name

Waystone Type

The structure waystone type

Waystone Environment

The structure waystone environment

Waystone Model

The structure waystone model

Auto Rename

The list of names that will be picked randomly and used as the generated waystone name

Condition > Only New Chunks

Only spawn in the new generated chunks (Useful if you don't want waystone to spawn randomly in your existing world), you can set this to true if you have a new world.

Condition > Not At Spawn Protection

Setting this to true will prevent the plugin to spawn a generated waystone in the spawn protected area (configurable in server.properties).

Condition > Worlds

List of world that will have the waystone spawned naturally.

Condition > Spawn Chance Percentage

The spawn chance percentage.

Condition > X Chunk Distance

The X Chunk gap between structures

Condition > Z Chunk Distance

The Z Chunk gap between structures

Condition > X Offset Range

The X offset. The Offset will be randomly picked between the minimum and the maximum offset range.

Condition > Z Offset Range

The Z Offset. The Offset will be randomly picked between the minimum and the maximum offset range.

Condition > Spawn From Above

Set this to true to spawn the waystone on the surface. Set it to false if you want to spawn the waystone below the surface (underground, caves, mineshafts, etc).

Condition > Ignore Trees

Will override and maybe place the waystone overlapping the tree's leaves if set to

Last updated