\n
\n<\/p>\n
# Piggy Build<\/p>\n
A simple yet powerful mod designed to enhance your building experience in Minecraft. Piggy Build provides utilitarian features like directional placement, shape guides, and fast placement tools to make creative building smoother.<\/p>\n
<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Disclaimer<\/p>\n
**This is a personal project.** It comes **AS IS** and might destroy your stuff.
\n* **No Support:** Do not expect regular support or bug fixes.
\n* **No Forge Port:** There are **NO** plans to port this mod to Forge.
\n* **Use at your own risk.**<\/p>\n
Feel free to fork the project or submit a Pull Request if you want to contribute fixes or features!<\/p>\n
—<\/p>\n
## Features<\/p>\n
### \ud83d\udee0\ufe0f Placement Helpers
\n* **Directional Placement**: Lock your placement direction relative to the block face. Handy for placing logs, pillars, or pistons in specific orientations.
\n* **Diagonal Placement**: Easily place blocks diagonally, enabling faster construction.
\n* **Fast Placement**: Hold down to place blocks rapidly.
\n* **Fast Breaking**: Creative-mode utility to break blocks faster.
\n* **Directional Lock**: Lock your cursor to a specific block face for rapid, aligned placements across a surface.<\/p>\n
### \ud83c\udfc3 Navigation & Survival
\n* **Auto-MLG Engine**: A high-performance survival system that uses a **FallSimulator** to predict lethal falls and automatically execute recovery actions.
\n * **15+ Methods**: Water Bucket, Slime, Boats, Cobwebs, Twisting Vines, Powder Snow, Hay Bales, Bed, Ender Pearl, and more.
\n * **Dynamic Ranking**: `MlgMethodSelector` ranks survival methods based on health, fall distance, and inventory availability.
\n * **Precision Execution**: Uses the `PiggyActionQueue` at `HIGHEST` priority for frame-perfect, anti-cheat friendly interaction.
\n * **Seamless Handlers**: Automatically manages “cleanup” (removing water, jumping off slime) once safe.
\n* **Auto-Parkour**: The `AutoParkourHandler` monitors your movement and automatically performs jumps for clearable gaps. It integrates with `PerfMonitor` to adjust jump timing based on current server latency.<\/p>\n
### \ud83d\udcd0 Shape & Visual Guides
\n* **Light Level Overlay**: Press `L` to toggle a completely dynamic overlay that highlights areas where monsters can spawn!
\n * **Island Effect Outline**: Drawing inspiration from the best visual mods, the overlay perfectly traces the borders of danger.
\n * **Tier 1 (Orange)**: Warns you about areas that are exposed to the sky. Mobs will only spawn here at night.
\n * **Tier 2 (Red)**: Highlights deep dark areas (caves, under roofs) where mobs can spawn at any time.
\n * **Seamless Textures**: The outline intelligently maps to the floor and walls, seamlessly combining without any z-fighting or overlaps.
\n* **Shape Selectors**: Detailed guides for placing blocks in specific shapes.
\n * Lines
\n * Spheres
\n * Rings
\n * Blocks (Cubes)
\n* **Refined Placement Logic**: Shape placement now follows a sophisticated queue system that respects **CPS (Clicks Per Second) limits**.
\n * **Anti-Cheat Friendly**: Prevents instant-place bugs and ensures placement frequency matches configurable server limits.
\n * **Smooth Construction**: Blocks are placed sequentially at a controllable rate, making the building process feel more natural and preventing server kicks.<\/p>\n
### \ud83d\udee1\ufe0f Safety & Anti-Cheat
\nPiggy Build comes with a **”No Cheating Mode” enabled by default**.
\n* **Safety First**: This mode prevents you from using “cheat” features (Fast Place, Directional Placement, etc.) while in **Survival** or **Adventure** mode.
\n* **Fair Play**: Prevents accidental bans on servers that detect fast interaction frequencies.
\n* **Creative Freedom**: All features remain fully unlocked in Creative Mode.
\n* **Server Enforcement**: When connected to a server with **Piggy Admin**, anti-cheat settings are automatically synchronized and enforced.<\/p>\n
—<\/p>\n
## Controls<\/p>\n
You can rebind these keys in the standard Minecraft Controls menu under **”Piggy Build”**.<\/p>\n
| Action | Default Key | Description |
\n| :— | :— | :— |
\n| **Shape Selector** | `V` | Radial menu for shapes. Scroll to adjust size. |
\n| **Directional Place** | `Mouse Button 5` | Locks placement orientation. |
\n| **Auto-MLG Toggle** | `O` | Toggles the automatic survival engine. |
\n| **Auto-Parkour** | `P` | Toggles the automatic jump handler. |
\n| **Fast Place** | `Mouse Button 6` | Rapid placement while held. |
\n| **Light Level Overlay** | `L` | Toggles the mob spawn danger boundary. |<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
Access the configuration menu via **Mod Menu**.<\/p>\n
* **Highlight Color**: Customize the color of the shape guides.
\n* **Placement Overlay Color**: Change the color of the directional arrows\/overlays.
\n* **Light Level Overlay Color**: Configures the primary (Red) color for deep Danger areas.
\n* **Sky Light Level Overlay Color**: Configures the secondary (Orange) color for Warning areas exposed to the sky.
\n* **Fast Place Speed**: Adjust the delay (in ms) between block placements.
\n* **Fast Place Toggle**: Enable\/Disable fast placement globally.
\n* **No Cheating Mode**: Toggle anti-cheat safety (prevents use in Survival\/Adventure).<\/p>\n
### \ud83d\udda5\ufe0f For Server Owners
\nYou can install **Piggy Build** on the server to enforce anti-cheat rules for all connected clients.
\n* **Config File**: `config\/piggy-build-server.json`
\n* **Enforcement**: Set `”allowCheats”: false` to **force** the anti-cheat mode on all players.
\n * This overrides client settings. Even if a player disables “No Cheating Mode”, they will be blocked from using build tools in Survival.
\n * Clients will receive a message: *”Anti-Cheat Active: This server has forced anti-cheat ON.”*<\/p>\n
—<\/p>\n
## Dependencies & Installation<\/p>\n
### Requirements
\n* **Minecraft**: ~1.21.1
\n* **Fabric Loader**: >=0.18.1
\n* **Java**: >=21<\/p>\n
### Required Mods
\n* **Fabric API**: Any version
\n* **YACL (Yet Another Config Lib)**: >=3.6.1+1.21-fabric
\n* **Piggy Lib**: >=1.0.1
\n* *(Optional)* **Mod Menu**: >=11.0.3 – Highly recommended for accessing config.<\/p>\n
### Installation
\n1. Download the `.jar` file from Releases.
\n2. Install Fabric Loader for Minecraft 1.21.1.
\n3. Place the `piggy-build` jar (along with Fabric API, YACL, and Piggy Lib) into your `.minecraft\/mods` folder.
\n4. Launch the game!<\/p>\n
—<\/p>\n
## Inspiration<\/p>\n
This mod was inspired by:
\n– **MiniHUD** – For the concept of visual overlays and shape guides.
\n– **Tweakeroo** – For fast placement mechanics and building utilities.<\/p>\n
—<\/p>\n
**License**: CC0-1.0<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple yet powerful building mod for flexible block placement and shape selector.<\/p>\n","protected":false},"featured_media":121281,"template":"","meta":{"_minecraft_slug":"piggy-build","_minecraft_project_id":"SG3UDLVm","_minecraft_author":"porkyoot","_minecraft_license":"CC0-1.0","_minecraft_downloads":258,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"piggy-build.zip","_minecraft_size_bytes":4870621,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-15T20:38:01.038042Z","_minecraft_date_created":"2025-12-08T03:12:11.817798Z","_minecraft_date_modified":"2026-04-25T05:47:59.861625Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/piggy-build","_minecraft_icon_attachment_id":121281,"_minecraft_imported_at":"2026-06-07T03:10:55+00:00","_minecraft_import_hash":"27f02fe3ebddfed7fc5eca0c1cff1480","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,92],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-121280","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n