🏗️ 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

| Wand | Max Blocks | Durability | Base Material |
|——|———–|——–|———-|
| Stone Construction Wand | 9 | 131 | Stone Pickaxe |
| Iron Construction Wand | 27 | 250 | Iron Pickaxe |
| Diamond Construction Wand | 128 | 1561 | Diamond Pickaxe |
| Netherite Construction Wand | 256 | 2031 | Netherite Pickaxe |
| Infinity Construction Wand | 1024 | ∞ | Nether Star |

🔧 Installation

Download the latest plugin JAR file
Place the JAR file in your server’s plugins folder
Restart the server
(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

Craft or obtain a construction wand via command
Hold the construction wand
Ensure you have the blocks to place in your inventory
Right-click on a block surface
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.

| Level | Bonus |
|——|——|
| I | +15% |
| II | +30% |
| III | +50% |
| IV | +75% |
| V | +100% |

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

ConstructionWand-Plugin

截图

介绍