小猪建造

小猪建造

一个简单而强大的建筑模组,支持灵活的方块放置和形状选择器。

工具

build test release

Piggy Build

一款简单而强大的模组,旨在提升你在 Minecraft 中的建造体验。Piggy Build 提供定向放置、形状引导和快速放置工具等实用功能,让创造模式建造更加流畅。

一个全息界面,用于在 Minecraft 中建造环形等形状


⚠️ 免责声明

这是一个个人项目。 按原样提供,可能会破坏你的东西。

  • 无支持:不要期望获得定期支持或错误修复。
  • 无 Forge 移植:没有将此模组移植到 Forge 的计划。
  • 使用风险自负。

如果你想贡献修复或功能,欢迎 Fork 本项目和提交 Pull Request!


功能

🛠️ 放置辅助

  • 定向放置:锁定相对于方块面的放置方向。非常适合在特定方向上放置原木、柱子或活塞。
  • 对角放置:轻松地斜向放置方块,加快建造速度。
  • 快速放置:按住即可快速放置方块。
  • 快速破坏:创造模式实用工具,可更快地破坏方块。
  • 方向锁定:将光标锁定到特定方块面,以便在表面上快速、对齐地放置。

🏃 导航与生存

  • Auto-MLG 引擎:一个高性能生存系统,使用 FallSimulator 预测致命坠落并自动执行恢复操作。
    • 15+ 种方法:水桶、黏液块、船、蜘蛛网、缠怨藤、细雪、干草块、床、末影珍珠等。
    • 动态排名:MlgMethodSelector 根据生命值、坠落距离和物品栏可用性对生存方法进行排名。
    • 精确执行:使用 PiggyActionQueue 以 HIGHEST 优先级实现帧完美、对反作弊友好的交互。
    • 无缝处理:安全后自动管理“清理”工作(移除水、从黏液块上跳下)。
  • 自动跑酷:AutoParkourHandler 监控你的移动,并自动为可跨越的间隙执行跳跃。它与 PerfMonitor 集成,根据当前服务器延迟调整跳跃时机。

📐 形状与视觉引导

  • 光照等级叠加层:按 L 切换一个完全动态的叠加层,高亮显示怪物可以生成的区域!
    • 岛屿效果轮廓:借鉴优秀视觉模组的灵感,该叠加层完美勾勒出危险区域的边界。
    • 一级(橙色):警告你暴露在天空下的区域。怪物只会在夜间在此生成。
    • 二级(红色):高亮显示深暗区域(洞穴、屋顶下),怪物可随时在此生成。
    • 无缝纹理:轮廓会智能地贴合地板和墙壁,无缝结合,无任何 z-fighting 或重叠。
  • 形状选择器:为按特定形状放置方块提供详细引导。
    • 线
    • 球体
    • 环
    • 方块(立方体)
  • 精细化放置逻辑:形状放置现在遵循复杂的队列系统,遵守 CPS(每秒点击次数)限制。
    • 对反作弊友好:防止瞬间放置漏洞,并确保放置频率符合可配置的服务器限制。
    • 平滑建造:方块以可控速率依次放置,使建造过程更自然,并防止被服务器踢出。

🛡️ 安全与反作弊

Piggy Build 默认启用 “禁止作弊模式”。

  • 安全优先:此模式阻止你在生存或冒险模式下使用“作弊”功能(快速放置、定向放置等)。
  • 公平游戏:防止在检测快速交互频率的服务器上被误封。
  • 创造自由:在创造模式下所有功能完全解锁。
  • 服务器强制:连接到装有 Piggy Admin 的服务器时,反作弊设置会自动同步并强制执行。

控制

你可以在 Minecraft 标准控制菜单的 “Piggy Build” 分类下重新绑定这些按键。

操作 默认按键 描述
形状选择器 V 形状径向菜单。滚动调整大小。
定向放置 鼠标按键 5 锁定放置方向。
Auto-MLG 开关 O 切换自动生存引擎。
自动跑酷 P 切换自动跳跃处理器。
快速放置 鼠标按键 6 按住时快速放置。
光照等级叠加层 L 切换怪物生成危险边界。

配置

通过 Mod Menu 访问配置菜单。

  • 高亮颜色:自定义形状引导的颜色。
  • 放置叠加层颜色:更改方向箭头/叠加层的颜色。
  • 光照等级叠加层颜色:配置深度危险区域的主(红色)颜色。
  • 天空光照等级叠加层颜色:配置暴露在天空下的警告区域的次(橙色)颜色。
  • 快速放置速度:调整方块放置之间的延迟(毫秒)。
  • 快速放置开关:全局启用/禁用快速放置。
  • 禁止作弊模式:切换反作弊安全功能(阻止在生存/冒险模式下使用)。

🖥️ 面向服务器管理员

你可以在服务器上安装 Piggy Build,为所有连接的客户端强制执行反作弊规则。

  • 配置文件:config/piggy-build-server.json
  • 强制执行:设置 "allowCheats": false 以对所有玩家强制启用反作弊模式。
    • 这会覆盖客户端设置。即使玩家禁用了“禁止作弊模式”,他们在生存模式下也会被阻止使用建造工具。
    • 客户端将收到消息:“Anti-Cheat Active: This server has forced anti-cheat ON.”

依赖与安装

要求

  • Minecraft:~1.21.1
  • Fabric Loader:>=0.18.1
  • Java:>=21

必需模组

安装

  1. 从 Releases 下载 .jar 文件。
  2. 为 Minecraft 1.21.1 安装 Fabric Loader。
  3. 将 piggy-build jar(以及 Fabric API、YACL 和 Piggy Lib)放入你的 .minecraft/mods 文件夹。
  4. 启动游戏!

灵感来源

本模组灵感来自:

  • MiniHUD - 视觉叠加层和形状引导的概念。
  • Tweakeroo - 快速放置机制和建造实用工具。

许可证:CC0-1.0