OreVision - Minecraft Fabric Mod

A powerful yet simple Fabric mod for Minecraft 1.21.4 that helps you locate ores by drawing colored lines through blocks to show exactly where they are!

Translated to: German, French, Spanish, Italian, Dutch, Polish

Features

• Multi-Ore Tracking: Tracks up to 10 nearest ores simultaneously (configurable)
• Color-Coded Visualization: Each ore type has its own distinctive color:
  • Coal: Gray
  • Iron: Tan
  • Copper: Orange
  • Gold: Golden Yellow
  • Redstone: Red
  • Lapis Lazuli: Blue
  • Diamond: Cyan
  • Emerald: Green
• 3D Axis Lines: Draws lines in all three dimensions (X, Y, Z) from each ore
• See Through Walls: Lines render through blocks so you can see ores even when they're hidden
• Toggle On/Off: Press O key (configurable) to enable/disable the mod
• Fully Configurable: Customize which ores to track, search radius, and more
• Optimized Search: Uses spherical search algorithm for better performance
• Client-Side Only: Works in both singleplayer and multiplayer without server-side installation

Compatibility

• Minecraft Version: 1.21.4
• Mod Loader: Fabric Loader 0.16.9+
• Required Dependencies:
  • Fabric API 0.110.0+1.21.4
  • Cloth Config API (bundled with mod)
• Optional Dependencies:
  • ModMenu (for mod menu integration)
• Java Version: Java 21 or higher
• Side: Client-side only (no server installation needed)

Installation

1. Install Fabric Loader

   • Download and install Fabric Loader for Minecraft 1.21.4
   • Run the installer and select your Minecraft installation

2. Install Fabric API

   • Download Fabric API for version 1.21.4
   • Place the Fabric API JAR file in your .minecraft/mods folder

3. Install OreVision

   • Download orevision-1.2.0.jar from releases
   • Place it in your .minecraft/mods folder
   • Launch Minecraft with the Fabric profile

Usage

Basic Usage

1. Launch Minecraft with OreVision installed
2. The mod is enabled by default
3. Press O to toggle the mod on/off
4. Colored lines will appear showing the locations of nearby ores
5. Follow the lines to find ores easily!

Controls

• O Key: Toggle OreVision on/off (shows message in action bar)
• K Key: Open configuration screen in-game

Configuration

OreVision offers two convenient ways to configure the mod:

In-Game Configuration Screen (Recommended)

The easiest way to configure OreVision is through the in-game configuration screen:

1. Using Keybinding: Press K while in-game to open the config screen
2. Using ModMenu: If you have ModMenu installed, click the config button next to OreVision in the Mods menu

The configuration screen provides an intuitive interface with:

• Sliders for adjusting Max Ores (1-50) and Search Radius (8-128 blocks)
• Toggle Switches for each ore type
• Tooltips explaining what each setting does
• Live Preview - changes take effect immediately after saving

Manual Configuration (Advanced)

OreVision creates a configuration file the first time you run it. Here's how to customize it:

Finding the Config File

1. Navigate to your Minecraft folder (.minecraft)
2. Open the config folder
3. Find orevision.json

Windows: %APPDATA%\.minecraft\config\orevision.json
Mac: ~/Library/Application Support/minecraft/config/orevision.json
Linux: ~/.minecraft/config/orevision.json

Understanding the Config File

When you open orevision.json, you'll see something like this:

{
  "maxOres": 10,
  "searchRadius": 16,
  "enabledByDefault": true,
  "enabledOres": {
    "COAL": true,
    "IRON": true,
    "COPPER": true,
    "GOLD": true,
    "REDSTONE": true,
    "LAPIS": true,
    "DIAMOND": true,
    "EMERALD": true
  }
}

Configuration Options Explained

maxOres

• What it does: Maximum number of ores to track at once
• Default: 10
• Example: Change to 5 to only track the 5 nearest ores

"maxOres": 5

searchRadius

• What it does: How far (in blocks) to search for ores
• Default: 16
• Example: Change to 128 to search really far

"searchRadius": 128

Note: Larger values may impact performance seriously!

enabledByDefault

• What it does: Whether the mod starts enabled when you launch the game
• Default: true
• Example: Set to false to start with the mod disabled

"enabledByDefault": false

enabledOres

• What it does: Controls which ore types to track
• Options: true (enabled) or false (disabled)

Common Configuration Examples

Example 1: Only Track Valuable Ores

Only show diamonds, emeralds, and gold:

"enabledOres": {
  "COAL": false,
  "IRON": false,
  "COPPER": false,
  "GOLD": true,
  "REDSTONE": false,
  "LAPIS": false,
  "DIAMOND": true,
  "EMERALD": true
}

Example 2: Mining for Resources

Track iron, coal, and redstone for gathering materials:

"enabledOres": {
  "COAL": true,
  "IRON": true,
  "COPPER": false,
  "GOLD": false,
  "REDSTONE": true,
  "LAPIS": false,
  "DIAMOND": false,
  "EMERALD": false
}

Example 3: Speedrunning Setup

Only diamonds for speedruns:

{
  "maxOres": 3,
  "searchRadius": 32,
  "enabledByDefault": true,
  "enabledOres": {
    "COAL": false,
    "IRON": false,
    "COPPER": false,
    "GOLD": false,
    "REDSTONE": false,
    "LAPIS": false,
    "DIAMOND": true,
    "EMERALD": false
  }
}

Example 4: Performance Mode

Reduce search radius and track fewer ores for better performance:

{
  "maxOres": 5,
  "searchRadius": 32,
  "enabledByDefault": true,
  "enabledOres": {
    ...
  }
}

How to Apply Configuration Changes

In-Game Config Screen: Changes are saved and applied immediately when you click "Done"

Manual JSON Editing:

1. Close Minecraft (important!)
2. Edit the orevision.json file with any text editor (Notepad, TextEdit, etc.)
3. Save the file
4. Launch Minecraft again
5. Your changes will be active!

Important: Make sure your JSON syntax is correct! Each line except the last one in a section needs a comma (,).

Building from Source

1. Make sure you have JDK 21 installed

2. Run the build command:

   ./gradlew build
   

   On Windows:

   gradlew.bat build
   

3. The compiled mod JAR will be in build/libs/orevision-1.3.0.jar

Installation

1. Install Fabric Loader

   • Download and install Fabric Loader for Minecraft 1.21.4
   • Run the installer and select your Minecraft installation

2. Install Fabric API

   • Download Fabric API for version 1.21.4
   • Place the Fabric API JAR file in your .minecraft/mods folder

3. Install OreVision

   • Download orevision-1.3.0.jar from releases
   • Place it in your .minecraft/mods folder
   • Launch Minecraft with the Fabric profile

Development

To set up the development environment:

./gradlew genSources

Then import the project into your IDE (IntelliJ IDEA or Eclipse).

To run the client for testing:

./gradlew runClient

License

MIT License