# World Configuration

## Introduction

This file contains the configuration for each world. If you use the plot-setup `/plot setup` the file-input will be generated by the plugin according your setup-arguments. Another you must change the default value manually.

{% hint style="info" %}
For more information regarding block buckets, visit [this page](/plotsquared/features/block-bucket.md).
{% endhint %}

*Located in:* `/plugins/PlotSquared/config/worlds.yml`

## Default

```yaml
configuration_version: v5
worlds:
  # The name of the world
  plotworld:
    plot:
      # The road height above from Y 0
      height: 62
      # The plot biome
      biome: minecraft:forest
      # The material to use for the plot signs
      sign_material: OAK_WALL_SIGN
      # The road length around a plot
      size: 42
      # Uses the block bucket format:
      # ex: stone,grass_block
      filling: minecraft:stone
      # Whether plots should be merged
      auto_merge: false
      # Whether the plot should have a bedrock layer at the bottom
      bedrock: true
      # Whether signs should be created at the corner of a plot
      create_signs: true
      # Uses the block bucket format:
      # ex: stone,grass_block
      floor: minecraft:grass_block
    # Configure the wall
    wall:
      # Uses the block bucket format:
      # ex: stone,grass_block
      filling: minecraft:stone
      # Uses the block bucket format:
      # ex: stone,grass_block
      block_claimed: minecraft:sandstone_slab
      height: 62
      # Uses the block bucket format:
      # ex: stone,grass_block
      block: minecraft:stone_slab
      # Whether blocks should be placed on top of the border
      place_top_block: true
    misc_spawn_unowned: false
    # Configure the road
    road:
      # Uses the block bucket format:
      # ex: stone,grass_block
      block: minecraft:quartz_block
      # Apply flags for the road within the following pattern:
      # flags:
      #	  pvp: true
      #		gamemode: survival
      # Do NOT add them inside the brackets
      flags: {}
      # Road height from Y 0
      height: 62
      # Road width along a side of a plot
      width: 7
    # Configure the home
    home:
      # side, center/middle or x,z (relative to the plot) or x,y,z
      nonmembers: side
      # side, center/middle or x,z (relative to the plot) or x,y,z
      default: side
    # Schematic generating / auto pasting
    schematic:
      # Whether the user can choose between a schematic when they claim a plot
      specify_on_claim: false
      # Whether the schematic should be pasted on claim
      on_claim: false
      # Define the schematic within the following format:
      # file:
      #		example.schem
      file: 'null'
      schematics: []
    # Default plot chat mode (toggled with `/plot toggle chat`)
    chat:
      # Whether plotchat will be on always
      forced: false
      enabled: true
    # Command costs
    economy:
      # Can use ANTLR's lexer tokens for dynamic prices
      # See https://worldedit.enginehub.org/en/latest/usage/other/expressions/
      # for a list of supported arguments. The plot variable is referenced as plots
      prices:
        merge: 100
        sell: 100
        claim: 100
      # Whether the setting should be active
      use: false
    world:
      # Max world generation height (Y)
      max_gen_height: 319
      # Max build height (Y)
      max_height: 320
      gamemode: creative
      # Used for the gamemode flag
      # Min world generation height (Y)
      min_gen_height: -64
      # Min build height (Y)
      min_height: -63
      # World border expands dynamically (false = disabled)
      border: false
      # plot offset for the world-border around the claimed plots
      border_size: 1
    event:
      spawn:
        # Whether spawn eggs are enabled
        egg: false
        # Whether breeding is enabled
        breeding: false
        # Whether custom events are enabled
        custom: true
    # Whether natural mob spawning is enabled
    natural_mob_spawning: false
    # Whether spawners are spawning mobs
    mob_spawner_spawning: false
    # Global plot flags, see: https://intellectualsites.github.io/plotsquared-documentation/plot-flags
    flags: {}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://intellectualsites.gitbook.io/plotsquared/configuration/worlds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
