PatternsGUI

PatternsGUI is a client-side Minecraft utility mod built for Forge (1.20.1) designed to visually construct, edit, and manage complex WorldEdit block patterns and block states in-game.

Instead of typing long, error-prone commands like //set 33%stone,67%oak_log[axis=x], PatternsGUI provides an intuitive graphical user interface (GUI) to build, preview, and generate these commands instantly.

---

🚀 Key Features

• Visual Pattern Builder: Add blocks from your main hand, adjust their relative weights with interactive + and - buttons, and watch the percentage distribution calculate in real-time.
• Deep Block State Integration: Configure block properties (such as orientations, boolean flags, or numerical values) through a custom interactive sub-screen (BlockStateSelectorScreen).
• Auto-Orientation Generator: Automatically duplicate a block pattern entry across all its valid orientations (axes or directions) with a single click—perfect for natural-looking log walls, stairs, and rotating blocks.
• Smart Presets & Auto-Suggest System: Save, load, and manage your constructed patterns locally. Presets are serialized to a local JSON file (config/patternsgui/presets.json) and feature an auto-suggesting search UI inside the screen.
• Flexible Input/Output:
  • Copy to Clipboard: Copy patterns directly for manual pasting into chat or external documents.
  • Paste & Parse: Instantly parse patterns/commands from your clipboard back into the GUI.
  • Direct Command Injection: Send commands directly to the server via /set or /replace with the "Apply" button.
• Contextual Replacement Target: Automatically detects the block you are looking at, or scans surrounding blocks to suggest the most common block as your /replace target.

---

🛠️ Build & Installation

To build the project from source, you only need Java 17 and a terminal. No heavy IDE setup is required.

Compiling the Mod

1. Clone the repository:

   git clone https://github.com/Varap228/PatternsGUI.git
   cd PatternsGUI

2. Compile the project using the Gradle wrapper:

   • Windows:

     gradlew build

   • Linux / macOS:

     ./gradlew build

3. Once completed, the compiled .jar file will be located in the build/libs/ directory. Drop this file into your Minecraft mods folder along with Minecraft Forge and WorldEdit.

---

🖥️ Workspace Setup (For Developers)

If you wish to modify the source code or debug in your preferred IDE:

IntelliJ IDEA

1. Open IntelliJ and import the build.gradle file as a project.
2. Run the Gradle task to generate run configurations:

   ./gradlew genIntellijRuns

3. Refresh the Gradle project in your IDE.

Eclipse

1. Generate the Eclipse run configurations:

   ./gradlew genEclipseRuns

2. Import the project into Eclipse as an Existing Gradle Project.

---

📝 License

This project is open-source and available under the terms specified in the LICENSE.txt file.