HereEngy
一款优质的 Paper Minecraft 插件,用于自动化建筑、结构图录制和建造动画——使用罗盘选择工具捕获结构蓝图,查看材料清单,利用本地客户端粒子轮廓动态预览建筑足迹,并观看带有音效和粒子效果的逐块构建过程!
功能特性
- 罗盘选择工具 —— 用标准罗盘左击一个方块以设置 A 点(锚点/相对原点),右击设置 B 点(对角)。即时在聊天栏中接收结构尺寸和体积摘要。
- 全局蓝图共享 —— 蓝图保存至共享的全局目录 (
plugins/HereEngy/blueprints/<name>.json)。服务器上的任何玩家都可以加载、查看和建造任何蓝图。
- 购物清单 (
/he info) —— 详细的蓝图查看器,显示尺寸、方块数量、创建者以及编译好的材料清单,指明建造所需的精确方块和数量。
- 视觉边界框预览 (
/he preview) —— 在建造前,在目标足迹周围投射发光的边界框粒子轮廓。当你调整视线时,对齐方式会动态更新。
- 渐进式建造任务 —— 逐层构建蓝图(按 Y 轴升序排列,从地基向上),每秒刻构建 10 个方块的安全速率。最大限度地减少服务器延迟,避免反作弊拦截,并创造出带有音效和方块粒子的令人满意的建造动画。
- 双格方块优化 —— 智能检测和管理多格物品(如门、床、双层高植物),使它们仅消耗一个物品栏槽位而不是两个。
- HereRolePlay 集成 —— 与 HereRolePlay 插件集成,玩家在完成蓝图建造后将获得工艺/工程经验。
- 安全保护 —— 只有蓝图的原始创建者或服务器操作员(
/op)才能删除服务器上已保存的蓝图。
命令
所有命令都可以使用前缀 /hereengy、/he 或 /engy。
| 命令 |
描述 |
权限 |
/he select |
开始实时可视化选择框会话,瞄准当前视线的方块。 |
hereengy.use |
/he save <name> |
将当前选择区域保存为蓝图。 |
hereengy.use |
/he load <name> |
加载蓝图作为玩家的活跃建造模板。 |
hereengy.use |
/he rotate <left|right|mirror|flip> |
在内存中旋转或镜像已加载的蓝图(支持 /he blueprint rotate <op>)。 |
hereengy.use |
/he list |
列出所有已保存的蓝图及其创建者。 |
hereengy.use |
/he info [name] |
查看蓝图详情和所需物品数量。 |
hereengy.use |
/he preview |
切换已加载蓝图的动态可视化粒子边界框。 |
hereengy.use |
/he cancel |
停止玩家正在运行的活跃建造任务。 |
hereengy.use |
/he delete <name> |
删除蓝图(仅限创建者或操作员)。 |
hereengy.use |
使用方法(逐步指南)
1. 选择和保存建筑
- 站在你想要捕获的建筑附近。
- 注视建筑起始角落正下方的基础/地面方块,并运行
/he select。
- 一个绿色粒子边界框将立即渲染在目标方块周围。
- 聊天中将启动交互式选择会话(具有 60 秒无活动超时)。
- 调整选择框:在聊天中输入尺寸命令以包裹你的建筑:
- 多轴赋值:输入
x 10 y 15 z 12 以即时调整大小。
- 负向/反向选择:你可以通过输入负数来选择地下或向后区域!例如,输入
x 20 y -10 z -20 以选择进入地下的区域。
- 快速调整:输入
x 或 x+ 以将 X 轴扩展 1 个方块,输入 x- 以将其缩小 1 个方块(y 和 z 也适用)。
- 罗盘调整:你也可以在主手持有罗盘并点击方块:
- 过滤与转换:保存时,HereEngy 会自动:
- 忽略水、熔岩、草以及不可放置的杂物方块(如传送门框架或青蛙卵),以免它们被写入蓝图。
- 将耕地(
FARMLAND)和草/泥土路径(DIRT_PATH)转换为普通的 DIRT 方块。
- 保存:当绿色粒子轮廓完美包裹你的建筑时,在聊天中输入单个单词(例如
stone_tower 或 cozy_cabin)。这将自动验证框内是否有方块,将蓝图保存到磁盘,并结束选择模式。(你也可以随时输入 cancel 以中止)。
2. 加载和定向蓝图
- 使用
/he load <name> 加载你保存的蓝图。
- 旋转或镜像:你可以在放置之前动态旋转或翻转建筑:
/he rotate right(或 /he blueprint rotate right)—— 将结构顺时针旋转 90 度(交换宽度和深度)。
/he rotate left(或 /he blueprint rotate left)—— 将结构逆时针旋转 90 度。
/he rotate mirror —— 沿 X 轴镜像结构。
/he rotate flip —— 沿 Z 轴翻转结构。
- 注意:此旋转是在内存中应用的(不在磁盘上)。方向性方块(楼梯、箱子、门等)会自动旋转其方块状态。
3. 预览与放置
- 观察你想要建造建筑的地面方块,并运行
/he preview。
- 会出现一个红色的粒子轮廓,精确显示蓝图将建造的位置。
- 注意:该轮廓会自动位于你目标地面方块的 +1 个方块上方,因此建筑会稳稳地坐落在土壤表面,而不会下沉。
- 走到你希望放置的位置。
- 确保你的物品栏中有所需的材料(可检查
/he info)。如果你处于创造模式,则不会消耗材料。
- 在主手持有 指南针,潜行并按住 Shift+右键 点击地面方块。
- 建筑将逐块进行建造,完美地坐落在你点击的地面方块之上!你可以随时使用
/he cancel 取消建造任务。
HereEngy
A premium Paper 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 [name] |
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
- Stand near the building you want to capture.
- 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).
- 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).
- 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.
- 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.
- 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
- Load your saved blueprint using
/he load <name>.
- Rotate or Mirror: You can dynamically rotate or flip the building before placing it:
/he rotate right (or /he blueprint rotate right) — Rotates the structure 90 degrees clockwise (swaps width/depth).
/he rotate left (or /he blueprint rotate left) — Rotates the structure 90 degrees counter-clockwise.
/he rotate mirror — Mirrors the structure along the X-axis.
/he rotate flip — Flips the structure along the Z-axis.
- Note: This rotation is applied in-memory for your session (not on disk). Directional blocks (stairs, chests, doors, etc.) automatically rotate their block states.
3. Previewing and Placing
- Look at the ground block where you want to construct the building and run
/he preview.
- A red particle outline will appear showing exactly where the blueprint will build.
- Notice: The outline automatically sits +1 block above the ground block you target, so the building sits nicely on top of the soil instead of sinking.
- Walk to your desired placement spot.
- Make sure you have the required materials in your inventory (check
/he info). If you are in Creative Mode, materials are not consumed.
- Hold a Compass in your main hand, sneak, and Shift+Right-click the ground block.
- The building will construct block-by-block, sitting perfectly on top of the ground block you clicked! You can cancel the construction task at any time using
/he cancel.
评论 0
登录后参与评分
还没有评论,来抢沙发吧