Structure Hunter - Meteor Client Addon

A Meteor Client addon for finding and tracking Minecraft structures from a world seed.

Features

• Structure Hunter Module: Find structures from world seed, track completion status
• Coord Snap Module: Instant or smooth rotation toward target coordinates
• Auto Tower Module: Automatically tower up to a specified Y level

Supported Structures

Overworld: Village, Pillager Outpost, Woodland Mansion, Stronghold, Ancient City, Desert Pyramid, Jungle Temple, Witch Hut, Shipwreck, Buried Treasure, Ocean Ruins, Ocean Monument, Trail Ruins, Trial Chambers, Mineshaft, Igloo

Nether: Nether Fortress, Bastion Remnant, Ruined Portal

End: End City

Requirements

• Java 21 JDK
• Minecraft 1.21.4
• Fabric Loader
• Meteor Client

Building the JAR

Step 1: Open Terminal

cd /path/to/structure-hunter-addon

Step 2: Build

./gradlew build

On Windows:

gradlew.bat build

Step 3: Find the JAR

The compiled JAR will be located at:

build/libs/structure-hunter-1.0.0.jar

Installation

1. Install Meteor Client for Minecraft 1.21.4
2. Copy structure-hunter-1.0.0.jar to your .minecraft/mods folder
3. Launch Minecraft with Fabric

Commands

Command	Description
.sh seed <seed>	Set the world seed
.sh find <type> <radius>	Find structures within radius
.sh goto <x> <z>	Navigate to coordinates
.sh add <type> <x> <z>	Add structure manually
.sh remove <id>	Remove a structure
.sh list	List tracked structures
.sh export	Export to clipboard
.sh import	Import from clipboard
.sh clear	Clear all structures
.sh gui	Open GUI
.sh nearest	Find nearest structure
.sh complete	Mark current as complete

Project Structure

structure-hunter-addon/
├── build.gradle.kts          # Build configuration
├── gradle.properties         # Version properties
├── settings.gradle.kts       # Gradle settings
├── gradle/
│   ├── libs.versions.toml    # Version catalog
│   └── wrapper/              # Gradle wrapper
├── gradlew                   # Unix build script
├── gradlew.bat               # Windows build script
├── LICENSE                   # GPL-3.0
└── src/main/
    ├── java/structurehunter/
    │   ├── StructureHunterAddon.java      # Entry point
    │   ├── modules/
    │   │   ├── StructureHunterModule.java
    │   │   ├── CoordSnapModule.java
    │   │   └── AutoTowerModule.java
    │   ├── utils/
    │   │   ├── FoundStructure.java
    │   │   ├── StructureType.java
    │   │   ├── StructureManager.java
    │   │   ├── SeedCalculator.java
    │   │   ├── CoordinateUtils.java
    │   │   └── StructureConfig.java
    │   ├── render/
    │   │   ├── StructureRenderer.java
    │   │   └── Cuboid.java
    │   ├── gui/
    │   │   ├── StructureMapScreen.java
    │   │   ├── StructureSearchScreen.java
    │   │   └── StructureListWidget.java
    │   ├── commands/
    │   │   └── StructureHunterCommand.java
    │   ├── events/
    │   │   ├── SeedChangedEvent.java
    │   │   ├── StructureAddedEvent.java
    │   │   └── StructureStatusChangedEvent.java
    │   └── mixin/
    │       └── ClientPlayerEntityMixin.java
    └── resources/
        ├── fabric.mod.json
        ├── structure-hunter.mixins.json
        └── assets/structure-hunter/icon.png

Configuration

Structures are saved to:

.minecraft/structure-hunter.json

License

GPL-3.0 License