ConstructionWand-Plugin

# 🏗️ Construction Wand <p align="center"> This document was generated by AI (not reviewed) </p> <p align="center"> <img src="https://img.shields.io/badge/Minecraft-1.16--1.21.4-green" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Folia-Supported-blue" alt="Folia Support"> <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License"> </p> A Minecraft server plugin inspired by the Forge mod (https://www.curseforge.com/minecraft/mc-mods/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 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 Empty Empty 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> ` | 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 | |--------|-----