ConstructionWand-Plugin

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

- 🔨 Resource Pack Support - Stone, Iron, Diamond, Netherite, Infinity - 🎯 Resource Pack Support - Right-click on a block surface to automatically extend placement of the same block - 👁️ Resource Pack Support - Particle effects show where blocks will be placed - 🎨 Resource Pack Support - Adjustable preview color and mode (full/corners/outline) - ⚡ Resource Pack Support - Building Extension enchantment increases maximum block placement - 🌍 Resource Pack Support - Simplified Chinese, Traditional Chinese, English, Classical Chinese - 🛡️ Resource Pack Support - Supports WorldGuard, Residence, GriefPrevention, etc. - 🚀 Resource Pack 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: - Server: 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 ```

| 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

```yaml

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)

```yaml 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

```bash

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