Got a question that the wiki doesn't answer? Ask on the forum (preferred), or join us on IRC.



From Wiki
Jump to: navigation, search
Check out the new WorldGuard documentation for WG 6+:

When you first run the server with WorldGuard installed, two types of configuration files will be generated:

  • A global configuration file will be generated at plugins/WorldGuard/config.yml.
  • For each world, a configuration will be generated at plugins/WorldGuard/worlds/worldname/config.yml.

The options in the global configuration affect the entire server. The per-world configuration files override settings from the global configuration file for each world respectively. For example, if you disable fire spread in the global configuration file, all worlds will have it disabled. However, one world can have it enabled by copying the setting into its configuration.

Setting Type Default Since Description
summary-on-start boolean true 1.2 Displays a summary about the WorldGuard settings for that world on start.
op-permissions boolean true 5.0 Gives all ops all permissions.
    item-durability boolean true 1.4 Change to 'false' to make tools invincible.
    remove-infinite-stacks boolean false 5.1 Enable to have WorldGuard scan player inventories and remove items with infinite stack sizes.
    disable-xp-orb-drops boolean false 5.3 Prevents experience orbs from dropping on death or from Bottles o' Enchanting, which may cause excessive lag.
chest-protection: (see chest protection)
    enable boolean false 5.0 Enable chest protection.
    allow-portal-anywhere boolean false 1.4 Allows illegal placement of portal blocks.
    no-physics-sand boolean false 1.4 Prevents sand from falling. (Note: May be broken.)
    no-physics-gravel boolean false 1.4 Prevents gravel from falling. (Note: May be broken.)
    disable-water-damage-blocks list [] 1.4 List of block ID numbers to prevent water from destroying. Remember to use block IDs and not item IDs, such as with redstone.
    vine-like-rope-ladders boolean false 5.6.3 Makes ladders behave like vines (can hang without support).
    block-tnt boolean false 1.0 Prevents TNT from being ignited entirely.
    block-tnt-block-damage boolean false 5.3 Prevents TNT from destroying the terrain while allowing it to damage entities.
    block-lighter boolean false 1.0 Prevents lighter (flint and stone) from being used entirely.
        enable boolean false 1.0 Restores the functionality of sponges to remove water when placed (like in Classic).
        redstone boolean false 1.x Allows redstone to be used with sponges.
        radius integer 3 1.2 Radius of the sponge effect.
    disable-lava-fire-spread boolean false 1.0 Prevents lava from causing fires.
    lava-spread-blocks list [] 1.0 List of block IDs to allow lava to spread to. If the value of this is not defined, then lava spread behavior will be unaffected.
    disable-fire-spread-blocks list [] 1.0 List of block IDs that can be burned. If the value of this is not defined, then fire spread behavior will be unaffected.
    disable-all-fire-spread boolean false 1.0 Prevents all fire spread.
    disable-health-regain boolean false 5.2 Prevents the healing effect that is caused by turning off monsters on the server. (Note: Currently prevents food from being eaten, due to a bug.)
    pumpkin-scuba boolean false 5.x Prevents drowning damage if the player wears a pumpkin helmet.
    anti-wolf-dumbness boolean false 5.0 Prevents wolves from getting hurt in the number of ways that wolves like to hurt themselves.
    disable-enderman-griefing boolean false 5.3 Prevents endermen from stealing and placing blocks.
    block-plugin-spawning boolean true 5.5 Prevents mob spawns triggered by plugins.
    block-creature-spawn list [] 5.0 List of creature names (like "Pig", "Chicken", etc.) for which to deny spawning.
    block-creeper-block-damage boolean false 2.2 Prevents creepers from destroying terrain, but allows them to hurt players.
    block-creeper-explosions boolean false 1.0 Prevents creepers from exploding.
    block-fireball-block-damage boolean false 5.3 Prevents fireballs from breaking blocks.
    block-fireball-explosions boolean false 5.3 Prevents fireballs from exploding at all.
    block-wither-explosions boolean false 5.6.x Prevents withers from exploding.
    block-wither-block-damage boolean false 5.6.x Prevents withers from destroying blocks.
    block-wither-skull-explosions boolean false 5.6.x Prevents wither skulls from exploding.
    block-wither-skull-block-damage boolean false 5.6.x Prevents wither skulls from destroying blocks.
    block-enderdragon-block-damage boolean false 5.6.x Prevents enderdragons from vaporizing blocks they fly through.
    block-enderdragon-portal-creation boolean false 5.6.x Prevents enderdragons from creating portals when they die.
    block-painting-destroy boolean false 5.6.x Prevents mobs from destroying paintings.
    block-item-frame-destroy boolean false 5.6.x Prevents mobs from destroying item frames.
    block-above-ground-slimes boolean false 5.6.x Prevents slimes from spawning above ground (e.g., in swamps).
    block-other-explosions boolean false 5.6.x Prevents explosions from any other sources (such as other plugins).
    block-zombie-door-destruction boolean false 5.6.x Prevents zombies from breaking doors when difficulty is set to hard.
    disable-ice-melting boolean false 5.2 Prevents ice from melting when heated.
    disable-snow-formation boolean false 5.2 Prevents snow from forming naturally.
    disable-mushroom-spread boolean false 5.2 Prevents mushrooms from spreading naturally.
    disable-snow-melting boolean false 5.2 Prevents snow from melting naturally.
    disable-leaf-decay boolean false 5.2 Prevents natural leaf decay.
    disable-ice-formation boolean false 5.2 Prevents ice from forming naturally.
    disable-grass-growth boolean false 5.3 Prevents grass from spreading to dirt.
    disable-mycelium-spread boolean false 5.6.1 Prevents mycelium from spreading to dirt.
    always-raining boolean false 5.1 Forces rain and snow all the time.
    disable-weather boolean false 5.1 Prevents rain and snow and forces clear weather all the time.
    disable-lightning-strike-fire boolean false 5.1 Prevents fire caused by lightning strikes.
    always-thundering boolean false 5.1 Enable constant thunder.
    prevent-lightning-strike-blocks list [] 5.1 List of block types IDs to prevent lightning from striking.
    disable-thunderstorm boolean false 5.1 Prevents thunderstorms.
    disable-pig-zombification boolean false 5.1 Prevents pigs from becoming zombie pigmen when struck by lightning.
    disable-powered-creepers boolean false 5.1 Prevents creepers from being charged when struck by lightning.
    disable-creature-trampling boolean false 5.1 Prevents creatures from trampling crops.
    disable-player-trampling boolean false 5.1 Prevents players from trampling crops.
    teleport-on-void-falling boolean false 5.0 When a player falls into the void, teleport the player somewhere safe.
    disable-drowning-damage boolean false 1.7 Prevents damage caused by drowning.
    disable-void-damage boolean false 5.0 Prevents damage caused by the void.
    disable-fire-damage boolean false 1.7 Prevents damage caused by fire.
    disable-lava-damage boolean false 1.7 Prevents damage caused by lava.
    disable-tnt-damage boolean false 5.3 Prevents damage caused by TNT.
    disable-mob-damage boolean false 5.0 Prevents damage caused by mobs.
    disable-fall-damage boolean false 1.7 Prevents damage caused by falls.
    disable-explosion-damage boolean false 5.0 Prevents damage caused by explosions.
    disable-suffocation-damage boolean false 1.8 Prevents damage caused by suffocation.
    disable-contact-damage boolean false 1.8 Prevents damage caused by contact. (E.g., cacti.)
    disable-lightning-damage boolean false 5.0 Prevents damage caused by lightning.
    teleport-on-suffocation boolean false 1.8 Teleports the player to the top of the block when a player is found inside a block. Exploitable to get to places that the player shouldn't be able to.
    disable-death-messages boolean false 5.3 Disables the death messages added in Minecraft 1.8.
regions: (see region protection)
    enable boolean true 2.1 Enable region protection.
    max-region-count-per-player int 7 5.0 Maximum number of regions per player (if using /region claim).
    max-claim-volume int 30000 5.0 Maximum volume of a region (if using /region claim).
        default int 7  ? Maximum number of regions a player may own (if using /region claim).
    claim-only-inside-existing-regions boolean false 5.0 Does not work correctly with certain regions. Don't depend on it.
    high-frequency-flags boolean false 5.0 Enables the use of region high frequency flags (such as water flow). Disabling this may reduce some server load.
    wand int 334 3.0 ID of the item used for checking the regions at a given block. Default is leather. Requires the worldguard.region.wand permission.
    invincibility-removes-mobs boolean false 5.3 Enable to have mobs be removed inside invincibility areas when they attack a player.
    sql: (global config only)
        use boolean false  ? Use SQL database for region storage.
        dsn string see desc.  ? SQL database location. Default is "jdbc:mysql://localhost/worldguard".
        username string worldguard  ? Username to connect to SQL database.
        password string worldguard  ? Password to connect to SQL database.
    use-scheduler (global config only) boolean true  ? Use the scheduler for tasks.
    use-creature-spawn-event boolean true  ? Toggles use of mob-spawning and deny-spawn flags
    use-player-move-event boolean true  ? Toggles use of exit/entry and greeting/farewell flags. Disabling this may boost performance, but disables those flags.
    block-potions list [] 5.6.1 Blocks certain potions. List should use the names of Bukkit's Potion Effect Types
    block-potions-overly-reliably boolean false 5.6.1 Enable this if the previous option isn't blocking potions well enough. May cause odd behavior.

Blacklist-related configuration can be found on the blacklist page.

Navigation menu