HereEngy

# HereEngy A premium (https://papermc.io) Minecraft plugin for **automated building, schematic recording, and construction animation** — capture structural blueprints using a Compass selection tool, view material lists, dynamically preview building footprints using local client particle outlines, and watch structures construct block-by-block with sound and particle effects! --- ## Features - **Compass Selection Tool** — Left-click a block with a standard **Compass** to set Point A (Anchor/relative origin), and Right-click to set Point B (opposite corner). Receives structural size and volume summaries instantly in chat. - **Global Blueprint Sharing** — Blueprints are saved to a shared global directory (`plugins/HereEngy/blueprints/<name>.json`). Any player can load, view, and construct any blueprint on the server. - **Shopping Lists (`/he info`)** — Detailed blueprint viewer displaying dimensions, block count, creator, and a compiled material list indicating the exact blocks and quantities required for construction. - **Visual Bounding Box Previews (`/he preview`)** — Project a glowing bounding box particle outline around the target footprint before building. Alignment updates dynamically as you adjust your line of sight. - **Gradual Build Tasks** — Constructs blueprints layer-by-layer (sorted Y-ascending, from the foundation up) at a safe rate of 10 blocks per tick. Minimizes server lag, avoids anti-cheat blocks, and creates a satisfying building animation with sound effects and block particles. - **Double-Block Optimization** — Intelligently detects and manages multi-block items (doors, beds, double tall plants) so they only count and consume **one** inventory item instead of two. - **HereRolePlay Integration** — Integrates with the **HereRolePlay** plugin, granting players **Crafting/Engineering Experience** upon completing blueprint constructions. - **Security Protection** — Only the original creator of a blueprint or a server Operator (`/op`) can delete saved blueprints from the server. --- ## Commands All commands can be prefixed with `/hereengy`, `/he`, or `/engy`. | Command | Description | Permission | | :--- | :--- | :--- | | `/he select` | Start a real-time visual selection box session targeting the block in sight. | `hereengy.use` | | `/he save <name>` | Save current selection area as a blueprint. | `hereengy.use` | | `/he load <name>` | Load blueprint as the player's active build template. | `hereengy.use` | | `/he rotate <left\|right\|mirror\|flip>` | Rotate or mirror the loaded blueprint in memory (supports `/he blueprint rotate <op>`). | `hereengy.use` | | `/he list` | List all saved blueprints and their creators. | `hereengy.use` | | `/he info ` | View blueprint details and required item quantities. | `hereengy.use` | | `/he preview` | Toggle dynamic visual particle bounding box of loaded blueprint. | `hereengy.use` | | `/he cancel` | Stop the player's running active building task. | `hereengy.use` | | `/he delete <name>` | Delete a blueprint (Creator or Operator only). | `hereengy.use` | --- ## How to Use (Step-by-Step HOWTO) ### 1. Selecting and Saving a Building 1. Stand near the building you want to capture. 2. Look at the base/ground block directly below the starting corner of your building, and run `/he select`. - A green particle bounding box will instantly render around the target block. - An interactive selection session starts in your chat (with a 60-second inactivity timeout). 3. **Adjust the Selection Box**: Type sizing commands in chat to wrap your building: - **Multi-axis assignment**: Type `x 10 y 15 z 12` to instantly resize. - **Negative / Inverted Selection**: You can select underground or backwards by typing negative numbers! For example, `x 20 y -10 z -20` to select down into the ground. - **Quick Adjustments**: Type `x` or `x+` to expand the X-axis by 1 block, `x-` to shrink it by 1 block (works for `y` and `z` too). 4. **Compass Adjustment**: You can also hold a **Compass** in your main hand and click blocks: - **Left-click** a block to update/re-center the starting anchor point. 5. **Filters & Conversions**: When saving, HereEngy automatically: - Ignores water, lava, grass, and non-placeable clutter blocks (like portal gates or frogspawn) so they aren't written to the blueprint. - Converts farmland (`FARMLAND`) and grass/dirt paths (`DIRT_PATH`) into normal `DIRT` blocks. 6. **Save**: Once the green particle outline perfectly wraps your building, type a single word in chat (e.g. `stone_tower` or `cozy_cabin`). This automatically verifies the box has blocks, saves the blueprint to disk, and ends selection mode. (You can also type `cancel` at any time to abort). ### 2. Loading and Orienting the Blueprint 1. Load your saved blueprint using `/he load <name>`. 2. **Rotate or Mirror**: You can dynamically rotate or flip the building before placing it: - `/he rotate right` (or `/he blueprint rotate right`) — Rotates the struc