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

Wand	Material	Core
Stone	Cobblestone	Stone Pickaxe
Iron	Iron Ingot	Iron Pickaxe
Diamond	Diamond	Diamond Pickaxe
Netherite	Netherite Ingot	Netherite Pickaxe
Infinity	Nether Star	Nether Star

💻 Commands

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

Command	Description	Permission
`/cw help`	Show help information	None
`/cw list`	List all wand types	None
`/cw preview`	Toggle preview mode	`constructionwand.preview`
`/cw gui`	Open settings GUI	`constructionwand.settings`
`/cw give <type> [player]`	Give a wand	`constructionwand.give`
`/cw itemgui`	Open item acquisition GUI	`constructionwand.itemgui`
`/cw enchant <enchantment> <level>`	Enchant a wand	`constructionwand.enchant`
`/cw lang <language>`	Switch language	`constructionwand.lang`
`/cw reload`	Reload configuration	`constructionwand.reload`
`/cw nbtdebug`	Debug NBT information	`constructionwand.nbtdebug`

🔐 Permissions

Player Permissions (Default: Enabled)

Permission	Description
`constructionwand.use`	Allow using construction wands
`constructionwand.use.stone`	Allow using stone construction wand
`constructionwand.use.iron`	Allow using iron construction wand
`constructionwand.use.diamond`	Allow using diamond construction wand
`constructionwand.use.netherite`	Allow using netherite construction wand
`constructionwand.use.infinity`	Allow using infinity construction wand
`constructionwand.preview`	Allow toggling preview mode
`constructionwand.settings`	Allow opening settings GUI

Admin Permissions (Default: OP)

Permission	Description
`constructionwand.give`	Allow giving wands
`constructionwand.itemgui`	Allow opening item acquisition GUI
`constructionwand.enchant`	Allow using enchant command
`constructionwand.lang`	Allow switching server language
`constructionwand.reload`	Allow reloading configuration
`constructionwand.nbtdebug`	Allow using NBT debug
`constructionwand.bypass`	Bypass region protection checks

Permission Groups

Permission Group	Description
`constructionwand.player`	Includes all player permissions
`constructionwand.admin`	Includes all permissions

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