ConstructionWand

🏗️ Construction Wand

This document was generated by AI (not reviewed)

A Minecraft server plugin inspired by the Forge mod Construction Wand. Allows players to quickly extend block placement, greatly improving building efficiency!

✨ Features

• 🔨 Five Construction Wands - Stone, Iron, Diamond, Netherite, Infinity
• 🎯 Smart Extension Placement - Right-click on a block surface to automatically extend placement of the same block
• 👁️ Real-time Preview - Particle effects show where blocks will be placed
• 🎨 Customizable Preview - Adjustable preview color and mode (full/corners/outline)
• ⚡ Enchantment System - Building Extension enchantment increases maximum block placement
• 🌍 Multi-language Support - Simplified Chinese, Traditional Chinese, English, Classical Chinese
• 🛡️ Region Protection Compatible - Supports WorldGuard, Residence, GriefPrevention, etc.
• 🚀 Folia Support - Fully compatible with Folia servers
• 📦 Resource Pack Support - Custom wand textures (supports 1.14-1.21.4+)

📋 Wand Types

🔧 Installation

1. Download the latest plugin JAR file
2. Place the JAR file in your server's plugins folder
3. Restart the server
4. (Optional) Install the resource pack for custom textures

Resource Pack Installation

Package the CWResourcepack folder as a ZIP file, then:

• Single Player/Client: Place in .minecraft/resourcepacks folder
• Server: Upload to the web and set the resource-pack URL in server.properties

📖 Usage

Basic Usage

1. Craft or obtain a construction wand via command
2. Hold the construction wand
3. Ensure you have the blocks to place in your inventory
4. Right-click on a block surface
5. The wand will automatically extend placement of the same block

Crafting Recipes

All wands follow the same crafting pattern:

  Empty    Empty   [Material]
  Empty   [Stick]   Empty
 [Stick]  Empty     Empty

💻 Commands

Main command: /constructionwand (aliases: /cw, /wand)

🔐 Permissions

Player Permissions (Default: Enabled)

Admin Permissions (Default: OP)

Permission Groups

⚔️ Enchantment System

Building Extension

Increases the wand's maximum block placement count.

How to Obtain:

• Use /cw enchant building_extension <level> command
• Enchant construction wands at an enchanting table (random level 1-5)

⚙️ Configuration

config.yml

# Language setting
language: "en_US"  # Options: zh_CN, zh_TW, en_US, lzh

# Preview settings
preview:
  # Particle color
  particle-color: "RED"  # RED, GREEN, BLUE, YELLOW, ORANGE, PURPLE, WHITE, AQUA, LIME or #RRGGBB
  # Preview mode
  mode: "full"  # full, corners, outline

# Region protection settings
protection:
  use-event-check: true
  use-worldguard: true

# Wand settings (customize each wand's properties)
wands:
  stone:
    enabled: true
    max-blocks: 9
    durability: 131
  # ... other wand configurations

Enchantment Configuration (enchant/building_extension.yml)

enabled: true
max-level: 10
levels:
  1: 0.15
  2: 0.30
  3: 0.50
  4: 0.75
  5: 1.00
  # ... higher levels
default-increment: 0.15

🌐 Multi-language Support

Supported languages:

• zh_CN - Simplified Chinese
• zh_TW - Traditional Chinese
• en_US - English
• lzh - Classical Chinese

Use /cw lang <language_code> to switch languages.

🔌 Compatibility

Server Software

• Spigot 1.16+
• Paper 1.16+
• Folia (fully supported)

Region Plugins

• WorldGuard
• Residence
• GriefPrevention
• Towny
• Lands
• PlotSquared

Minecraft Versions

• 1.16.x - 1.21.4+
• Automatically adapts CustomModelData format (legacy integer/new string)

📁 Project Structure

ConstructionWand/
├── src/main/java/org/little100/constructionWand/
│   ├── ConstructionWand.java      # Main plugin class
│   ├── action/                    # Block placement logic
│   ├── command/                   # Command handling
│   ├── enchant/                   # Enchantment system
│   ├── gui/                       # GUI interfaces
│   ├── i18n/                      # Internationalization
│   ├── listener/                  # Event listeners
│   ├── preview/                   # Preview system
│   ├── protection/                # Region protection
│   ├── recipe/                    # Crafting recipes
│   ├── utils/                     # Utility classes
│   └── wand/                      # Wand management
├── src/main/resources/
│   ├── config.yml                 # Configuration file
│   ├── plugin.yml                 # Plugin information
│   ├── enchant/                   # Enchantment configs
│   └── lang/                      # Language files
└── CWResourcepack/                # Resource pack

🛠️ Building

# Clone the repository
git clone https://github.com/Little100/ConstructionWand_Pugin.git

# Enter directory
cd ConstructionWand_Pugin

# Build
./gradlew build

# Output files are in build/libs/

📝 Changelog

v1.0.0

• Initial release
• Five construction wands
• Particle preview system
• Multi-language support
• Enchantment system
• Region plugin compatibility
• Folia support

📄 License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by: Construction Wand (Forge Mod)
• Thanks to all contributors and testers!

🐛 Bug Reports

If you find a bug or have a feature suggestion, please submit it on GitHub Issues.

Made with ❤️ by Little_100

GitHub Repository