Caution

The only official website for Meteorist is meteorist.pages.dev. Any other websites claiming to be Meteorist are NOT controlled by me and may contain malware or malicious content. Always download from the official source only.

📖 About

Free and open-source add-on for Meteor Client that adds modules, commands, and other useful features for anarchy servers.

📑 Table of Contents

• About
• Requirements
• Installation
• Features
• Project Structure
• Building from Source
• Contributing
• License
• Community

📦 Requirements

Required

• Java: 25 or higher
• Fabric Loader
• Meteor Client

Optional

• Baritone - required for ItemSucker module (pathfinding to items and returning to origin)
• Minescript - required for Minescript Integration module (custom script execution)

📥 Installation

1. Install Fabric Loader for your Minecraft version.
2. Install Meteor Client into your mods folder.
3. Download the latest Meteorist release from the official website or the releases page.
4. Drop the downloaded JAR into your .minecraft/mods folder.
5. Launch Minecraft using the Fabric profile.

🧩 Features

Modules

A wide variety of modules for automation, combat, movement, rendering, and general quality of life improvements.

View all modules

Commands

Custom commands for running scheduled instructions, managing player data, inspecting NBT data, and more.

View all commands

HUD elements

Ready-to-use Text HUD presets for displaying various statistics and stuff.

View all HUD elements

📁 Project Structure

Meteorist/
├── src/
│   ├── main/
│   │   ├── java/zgoly/meteorist/
│   │   │   ├── commands/      # Custom commands
│   │   │   ├── devmodules/    # Development-only modules
│   │   │   ├── events/        # Event handlers
│   │   │   ├── gui/           # Custom GUI screens
│   │   │   ├── hud/           # HUD elements
│   │   │   ├── mixin/         # Mixin classes
│   │   │   ├── modules/       # Game modules
│   │   │   ├── settings/      # Configuration settings
│   │   │   ├── utils/         # Utility classes
│   │   │   └── Meteorist.java # Main entry point
│   │   └── resources/
│   │       ├── assets/        # Mod stuff (icons, etc.)
│   │       ├── fabric.mod.json
│   │       └── meteorist.mixins.json
│   └── dev/java/              # Development stuff
├── gradle/                    # Gradle wrapper stuff
└── website/                   # Website stuff (meteorist.pages.dev)

🛠️ Building from Source

Prerequisites

• JDK: 25 or higher
• Git

Steps

# Clone the repository
git clone https://github.com/Zgoly/Meteorist.git
cd Meteorist

# Build with Gradle (Linux/macOS)
./gradlew build

# Build with Gradle (Windows)
gradlew.bat build

The compiled JAR will be in build/libs/.

Development Commands

# Run in development environment
./gradlew runClient

# Generate module/command/HUD element info JSON
./gradlew generateMeteoristInfo

# Clean build artifacts
./gradlew clean

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

• Report a bug
• Suggest a feature
• Report a crash

📄 License

This project is licensed under the GNU General Public License v3.0.

👥 Community

Join our Discord server for support and discussions.

---