HalalBuilds

HalalBuilds is a Paper Minecraft Java Edition plugin for admins and builders who want a safer structure workflow on top of FAWE/WorldEdit.

It lets staff save cuboid selections as named builds, copy/cut/paste structures, import/export Sponge .schem files, rotate placements, preview risky operations, and paste into uneven terrain with smart foundation support.

Best for: Minecraft server owners, Paper admins, builders, survival networks, SMP staff, and creative teams that need reusable structure saves with safer terrain placement.

Status

Current release candidate: 1.0.1

HalalBuilds v1 is command-based and ready for Paper + FAWE smoke testing. Inventory GUI, visual particle previews, clean scan modes, and WorldGuard/native protection are planned future work.

Target Stack

Item	Target
Minecraft	Java Edition
Server	Paper 1.21.11
Java	21
Build tool	Gradle Kotlin DSL
Language	Java
Runtime dependency	FAWE
Optional future integration	WorldGuard
Schematic format	Sponge .schem
Main class	com.halalbuilds.HalalBuildsPlugin

Features

• Cuboid selection workflow using WorldEdit/FAWE selections.
• Save selected builds by name.
• Copy selected builds into a temporary player clipboard.
• Cut selected builds by copying first, then removing the original.
• Paste saved builds or clipboard builds.
• Rotate pending previews or paste commands by 0, 90, 180, or 270 degrees.
• Preview/confirm/cancel flow for risky operations.
• Smart foundation mode for uneven terrain.
• Exact paste mode for raw schematic placement.
• Import .schem files from a controlled imports folder.
• Export saved builds to a controlled exports folder.
• Best-effort undo for the latest paste/cut.
• Safe name and path validation.
• LuckPerms-compatible permission nodes.

Install

1. Run Paper 1.21.11 with Java 21.
2. Install FAWE.
3. Download HalalBuilds-1.0.1.jar from GitHub Releases.
4. Place HalalBuilds-1.0.1.jar in the server plugins/ folder.
5. Start the server once.
6. Edit plugins/HalalBuilds/config.yml if needed.
7. Restart or run:

/hb reload

Generated folders:

plugins/HalalBuilds/
  builds/
  imports/
  exports/
  config.yml

Quick Start

Select the full cuboid around a build with the wand:

/hb wand

Save it:

/hb save starter_house

Preview, rotate, and confirm a paste:

/hb paste starter_house --preview
/hb rotate 90
/hb confirm

Use exact mode when you do not want smart foundation blocks:

/hb paste starter_house --mode exact --preview
/hb confirm

Important V1 Behavior

HalalBuilds v1 saves exactly what is inside the selected cuboid.

If the selection is only one block tall, it will save only a flat layer. Select from the bottom corner to the opposite top corner to capture a full building.

If a build was saved with an older test jar and pastes as air or appears to do nothing, delete and re-save it with 1.0.1.

Commands

Main command:

/halalbuilds

Aliases:

/hb
/halalbuild

Common commands:

/hb wand
/hb save <name>
/hb copy
/hb cut
/hb paste <name|clipboard>
/hb paste <name|clipboard> --preview
/hb rotate <0|90|180|270>
/hb confirm
/hb cancel
/hb import <filename> [name]
/hb export <name>
/hb list
/hb info <name>
/hb delete <name>
/hb undo
/hb reload

See COMMANDS_AND_PERMISSIONS.md for the complete command and permission reference.

Documentation

• USER_GUIDE.md - in-game usage guide.
• ADMIN_SETUP.md - FAWE, LuckPerms, and staff permission setup.
• HOW_TO_TEST.md - step-by-step smoke test guide.
• COMMANDS_AND_PERMISSIONS.md - commands, aliases, permissions, and examples.
• CONFIG.md - configuration reference.
• RELEASE_NOTES.md - release notes and known limits.
• GITHUB_RELEASE.md - release title, tag, description, and upload checklist.
• RELEASE_CHECKLIST.md - final release checklist.
• PROJECT_STATUS.md - current project status.
• REQUIREMENTS.md - product requirements.
• TECHNICAL_PLAN.md - architecture and algorithms.
• TEST_PLAN.md - manual and automated test plan.

License

HalalBuilds is released under the MIT License.

Build

Windows PowerShell:

$env:JAVA_HOME = (Resolve-Path '.tools\jdks\jdk-21.0.11+10').Path
$env:PATH = "$env:JAVA_HOME\bin;" + $env:PATH
.\gradlew.bat clean build --no-daemon

Release jar:

build/libs/HalalBuilds-1.0.1.jar

Roadmap

Planned future work:

• Inventory GUI build browser.
• Visual particle/block outline previews.
• Resource-pack enhanced icons.
• Clean scan modes for trimming air and filtering terrain blocks.
• WorldGuard integration.
• HalalBuilds-native protected regions.