Configuration Overview
Last updated
Last updated
BuildersWand uses a comprehensive configuration system with two main files: config.yml for plugin settings and wands.yml for wand definitions. Understanding how these work together will help you customize the plugin to fit your server's needs.
config.yml - Controls plugin behavior, permissions, performance, and integrations
wands.yml - Defines all available wands and their properties
lang - Folder containing all language files which contain the messages sent to users.
The configuration system is organized into sections:
General: Debug mode, language, version tracking
Wand: Rendering, physics, undo settings
Restrictions: Usage limits, permissions, world restrictions
Performance: Anti-lag, memory management, optimization
UI: Messages, sounds, visual feedback
Admin: Logging, monitoring, statistics
Integrations: Third-party plugin hooks
Global Defaults: Base settings for all wands
Individual Wands: Specific configurations for each wand tier
Validation: Configuration validation rules
Migration: Settings for config updates
Inheritance: Wands can inherit properties from other wands using inherit_from
Validation: Automatic checking of configuration values
Migration: Automatic updates when configuration versions change
Fallbacks: Default values when configuration is missing or invalid
The plugin automatically:
Creates default configuration files on first run
Validates all settings and reports errors
Migrates old configurations to new formats
Provides detailed logging for configuration issues
Backup Before Changes: Always backup your config files before making changes
Test Incrementally: Make small changes and test before proceeding
Monitor Logs: Check server logs for configuration warnings or errors
You can reload the configuration without restarting the server using:
/bw reload - Reloads both config.yml and wands.yml
Configuration changes take effect immediately
Wand properties are updated for all existing wands
If you encounter configuration issues:
Check the server console for error messages
Verify YAML syntax (proper indentation, quotes)
Ensure all required fields are present
Check that material names are valid for your server version
Use the validation system to identify problems
The configuration system is designed to be robust and user-friendly, with extensive error checking and helpful feedback to guide you through any issues.