Plugin Integrations

Plugin Integrations

BuildersWand integrates with several popular Minecraft plugins to ensure compatibility and respect their protection systems. These integrations work automatically when the plugins are detected on your server.

Supported Integrations

WorldGuard

Purpose: Respects WorldGuard region protections and flags What it does: Checks if players have permission to build in WorldGuard regions before allowing wand usage Configuration:

advanced:
  integrations:
    worldguard:
      enabled: true
      check-regions: true
      allow-bypass: true

Bypass Permission: builderswand.bypass.worldguard

CoreProtect

Purpose: Logs all wand operations for rollback capability What it does: Automatically logs block placements and removals to CoreProtect's database Configuration:

advanced:
  integrations:
    coreprotect:
      enabled: true
      log-operations: true
      log-rollback: true

Features:

  • Logs block placements with player attribution

  • Logs block removals for rollback support

  • Respects CoreProtect's rollback system

ItemsAdder

Purpose: Supports custom blocks and items from ItemsAdder What it does: Allows wands to work with custom blocks and items added by ItemsAdder Configuration:

advanced:
  integrations:
    itemsadder:
      enabled: true
      support-custom-blocks: true
      support-custom-items: true

Features:

  • Detects and works with custom blocks

  • Supports custom item placement

  • Maintains custom block properties

Lands

Purpose: Respects Lands plugin area protections and land ownership What it does: Checks Lands area permissions for block placement and removal, supports both legacy and latest API versions Configuration:

advanced:
  integrations:
    lands:
      api-version: "auto-detect"
      fallback-enabled: true
      area-caching: true

Features:

  • Auto-detects best available Lands API version

  • Supports legacy and latest Lands API

  • Caches land data for improved performance

  • Respects land ownership and area permissions Bypass Permission: builderswand.bypass.lands

JobsReborn

Purpose: Integrates with JobsReborn for job-based rewards and restrictions What it does: Awards experience and money for wand usage based on player's job, with configurable restrictions Configuration:

advanced:
  integrations:
    jobsreborn:
      enabled: true
      award-experience: true
      award-money: true
      multipliers:
        experience: 1.0
        money: 1.0
      restrictions:
        allowed-jobs: ["Miner"]
        blocked-jobs: ["Builder"]

Features:

  • Awards job experience for wand usage

  • Awards job money for wand usage

  • Configurable experience and money multipliers

  • Job-based usage restrictions

  • Anti-exploit protection systems

  • Asynchronous reward processing

PatchPlaceBreak

Purpose: Provides anti-exploit protection that complements PatchPlaceBreak What it does: Implements custom validation system to prevent exploits when using wands Configuration:

advanced:
  integrations:
    patchplacebreak:
      enabled: true
      validate-placement: true
      respect-ephemeral-tags: true
      logging:
        blocked-attempts: false

Features:

  • Custom anti-exploit validation system

  • Respects temporary block protections

  • Rate limiting and spam prevention

  • Configurable validation levels

  • Debug logging for troubleshooting

Protection Plugins

GriefPrevention

Purpose: Respects GriefPrevention claim boundaries What it does: Checks if players have permission to build in GriefPrevention claims Bypass Permission: builderswand.bypass.griefprevention

Towny

Purpose: Respects Towny town and nation boundaries What it does: Checks town permissions for building and destroying blocks Bypass Permission: builderswand.bypass.towny

SuperiorSkyblock

Purpose: Respects SuperiorSkyblock island boundaries What it does: Only allows island members to use wands within their island area Bypass Permission: builderswand.bypass.skyblock

BentoBox

Purpose: Respects BentoBox island protections What it does: Checks island permissions for building and destroying blocks Bypass Permission: builderswand.bypass.bentobox

mcMMO

Purpose: Prevents mcMMO skill conflicts What it does: Marks blocks as placed by mcMMO to prevent skill conflicts Bypass Permission: builderswand.bypass.mcmmo

Integration Configuration

Global Settings

Integrations can be configured globally in config.yml:

advanced:
  integrations:
    worldguard:
      enabled: true
      check-regions: true
      allow-bypass: true
    
    coreprotect:
      enabled: true
      log-operations: true
      log-rollback: true
    
    itemsadder:
      enabled: true
      support-custom-blocks: true
      support-custom-items: true
    
    lands:
      api-version: "auto-detect"
      fallback-enabled: true
      area-caching: true
    
    jobsreborn:
      enabled: true
      award-experience: true
      award-money: true
      multipliers:
        experience: 1.0
        money: 1.0
      restrictions:
        allowed-jobs: []
        blocked-jobs: []
    
    patchplacebreak:
      enabled: true
      validate-placement: true
      respect-ephemeral-tags: true
      logging:
        blocked-attempts: false

Per-Wand Settings

Each wand can have its own integration settings in wands.yml:

wands:
  basic:
    integrations:
      worldguard:
        enabled: true
        bypass_permission: "builderswand.bypass.worldguard"
      griefprevention:
        enabled: true
        bypass_permission: "builderswand.bypass.griefprevention"
      towny:
        enabled: true
        bypass_permission: "builderswand.bypass.towny"
      lands:
        enabled: true
        bypass_permission: "builderswand.bypass.lands"
      superior_skyblock:
        enabled: true
        bypass_permission: "builderswand.bypass.skyblock"
      bentobox:
        enabled: true
        bypass_permission: "builderswand.bypass.bentobox"
      mcmmo:
        enabled: true
        bypass_permission: "builderswand.bypass.mcmmo"
      itemsadder:
        enabled: true
        bypass_permission: "builderswand.bypass.itemsadder"
      jobsreborn:
        enabled: true
        bypass_permission: "builderswand.bypass.jobsreborn"
      patchplacebreak:
        enabled: true
        bypass_permission: "builderswand.bypass.patchplacebreak"

How Integrations Work

Automatic Detection

BuildersWand automatically detects installed plugins and enables integrations accordingly. No manual setup is required.

Permission Checking

When a player uses a wand, the plugin checks all relevant integrations:

  • Verifies the player has permission in the current location

  • Respects protection plugin boundaries

  • Logs operations to compatible logging plugins

  • Handles custom blocks and items appropriately

  • Awards job rewards when applicable

  • Validates against anti-exploit systems

Bypass Permissions

Each integration has a bypass permission that allows administrators to override protection checks:

  • builderswand.bypass.worldguard

  • builderswand.bypass.griefprevention

  • builderswand.bypass.towny

  • builderswand.bypass.lands

  • builderswand.bypass.skyblock

  • builderswand.bypass.bentobox

  • builderswand.bypass.mcmmo

  • builderswand.bypass.itemsadder

  • builderswand.bypass.jobsreborn

  • builderswand.bypass.patchplacebreak

Troubleshooting Integrations

Integration Not Working

  • Check if the plugin is installed: BuildersWand only integrates with plugins that are actually installed

  • Verify plugin versions: Ensure you're using compatible versions of both plugins

  • Check permissions: Make sure players have the necessary permissions in the protection plugin

  • Review bypass permissions: Administrators can use bypass permissions to override restrictions

Performance Issues

  • Disable unused integrations: Turn off integrations for plugins you don't use

  • Check protection plugin settings: Some protection plugins have performance settings that can affect wand usage

  • Review logging settings: CoreProtect logging can impact performance on busy servers

  • Monitor JobsReborn integration: High reward multipliers can impact performance

Custom Block Issues

  • Verify ItemsAdder integration: Ensure ItemsAdder integration is enabled

  • Check custom block permissions: Some custom blocks may have their own permission requirements

  • Test with vanilla blocks first: Verify the wand works with vanilla blocks before testing custom ones

JobsReborn Issues

  • Check job restrictions: Verify allowed-jobs and blocked-jobs are configured correctly

  • Verify job assignments: Ensure players have valid jobs assigned

  • Check multipliers: High multipliers may cause performance issues

  • Review anti-exploit settings: Exploit prevention may block legitimate usage

PatchPlaceBreak Issues

  • Enable debug logging: Set blocked-attempts: true to see what's being blocked

  • Check validation settings: Adjust validate-placement and respect-ephemeral-tags as needed

  • Review rate limiting: Anti-exploit systems may block rapid wand usage

Best Practices

For Server Administrators

  • Enable only the integrations you actually use

  • Set up appropriate bypass permissions for staff

  • Monitor integration performance on busy servers

  • Keep all plugins updated to latest versions

  • Configure job restrictions carefully to prevent exploits

  • Test anti-exploit systems before going live

For Players

  • Understand the protection boundaries on your server

  • Contact administrators if you need access to protected areas

  • Report any issues with custom blocks or items

  • Be aware of job restrictions and requirements

  • Understand that anti-exploit systems may limit rapid usage

PreviousPermissions SetupNextPerformance Tuning

Last updated