SpawnerFinder

A client-side Minecraft mod that displays nearby mob spawners in your HUD with color-coded information showing spawner type, coordinates, and distance to help you locate dungeons efficiently.

v1.1.0 - The Massive Update

New Features:

• Spawner Group Finder: Automatically identifies groups of spawners that can be activated simultaneously!
  • Displays "Spawner Groups found" on the right side of the HUD.
  • Shows the optimal activation coordinates (centroid) where effective farm stacking is possible.
  • Lists individual spawners within each group.
  • Sorts groups by size (largest groups first) to help you find the best farm locations instantly.
• Keybind Controls:
  • O: Toggle the entire Mod ON/OFF.
  • I: Expand/Collapse the spawner lists (shows top 5 vs all).
• Performance Overhaul:
  • Completely rewrote the scanning engine to use "Loaded Chunks" instead of brute-force block checking.
  • Zero Lag Spikes: 100% efficient CPU usage, even on low-end hardware.
• Visual Improvements:
  • Improved HUD readability with cleaner fonts and removal of unnecessary shadows.
  • "Spawners found" header is now clearly visible with a separator line.
  • Right-side HUD for group information to keep the screen organized.

🎯 Features

Core Functionality

• Real-time Spawner Detection - Automatically scans for mob spawners within 128 blocks of your position
• Color-Coded Display - Each mob type has a unique color for instant recognition
• Distance Tracking - Shows exact distance to each spawner in meters
• Coordinate Display - Provides precise X, Y, Z coordinates for easy navigation
• HUD Integration - Clean, non-intrusive overlay that shows the 5 closest spawners

Supported Mob Types

Client-Side Only & Anti-Cheat Safe

• ✅ 100% Client-Side - No server modifications required
• ✅ Server Safe - Cannot be detected by anti-cheat systems
• ✅ No Network Traffic - Uses only locally available data
• ✅ Works on Any Server - Compatible with vanilla and modded servers
• ✅ HUD Only Display - No visual overlays or ESP to avoid behavior detection

📋 Requirements

• Minecraft: 1.21.8
• Fabric Loader: 0.17.3 or higher
• Fabric API: 0.136.1+1.21.8 or higher
• Java: 21 or higher

🚀 Installation

1. Install Fabric Loader - Download from FabricMC
2. Download Fabric API - Get it from Modrinth or CurseForge
3. Download SpawnerFinder - Get the latest release from the releases page
4. Install the Mod - Place spawnerfinder-1.0.0.jar in your .minecraft/mods/ folder
5. Launch Minecraft - Start the game with the Fabric profile

🎮 Usage

In-Game Display

Once installed, the mod automatically starts working:

1. HUD Location - Spawner information appears in the top-left corner of your screen
2. Automatic Updates - The list refreshes every 2 seconds as you move around
3. Distance Sorting - Spawners are automatically sorted by distance (closest first)
4. Format - Each entry shows: Mob Type: X, Y, Z (Distance)

Example Display

Closest Spawners:
Skeleton: 245, 23, -156 (12.3m)
Zombie: 267, 18, -145 (28.7m)
Spider: 223, 31, -178 (35.1m)
Cave Spider: 289, 15, -134 (45.6m)
Blaze: 201, 22, -189 (52.4m)

⚠️ Important Behavioral Warnings

Why HUD-Only Design?

This mod intentionally uses HUD display only instead of visual overlays (ESP/wallhacks) for important safety reasons:

• Behavior Tracking Protection - Many servers use behavior analysis that can detect players looking directly at blocks through walls
• Anti-Cheat Evasion - Visual ESP mods can trigger anti-cheat systems when players exhibit "impossible" knowledge
• Natural Gameplay - HUD display encourages normal exploration rather than direct navigation to hidden spawners

Recommended Usage

• ✅ Use coordinates for general direction - Navigate naturally toward the area
• ✅ Explore normally - Don't beeline directly to spawners through walls
• ✅ Mine/dig naturally - Follow normal cave systems and mining patterns
• ❌ Don't stare at walls - Avoid looking directly at spawner locations through blocks
• ❌ Don't tunnel straight - Avoid digging direct paths to spawners

Server Safety Notes

While this mod is technically undetectable:

• Behavior matters more than the mod itself - How you act is what gets you caught
• Play naturally - Use the information as a guide, not a GPS
• Respect server rules - Some servers prohibit any form of spawner detection
• When in doubt, don't use - Better safe than banned

🔧 Technical Details

Performance

• Efficient Scanning - Only scans every 2 seconds to minimize performance impact
• Optimized Range - 128-block radius provides good coverage without excessive computation
• Memory Friendly - Lightweight implementation with minimal memory usage

Compatibility

• Fabric Ecosystem - Built using standard Fabric APIs
• Mod Compatibility - Should work alongside most other client-side mods
• Resource Pack Safe - Doesn't interfere with texture packs or shaders

Security & Design Philosophy

• No Server Detection - Uses only client-side world data
• Anti-Cheat Safe - Behaves identically to vanilla client from server perspective
• No Visual ESP - Deliberately avoids rendering overlays to prevent behavior tracking
• HUD-Only Information - Provides data without encouraging suspicious movement patterns
• No Unfair Advantage - Only shows information about loaded chunks

🛠️ Building from Source

Prerequisites

• Java 21 or higher
• Git

Build Steps

# Clone the repository
git clone <repository-url>
cd spawnerfinder

# Build the mod
./gradlew build

# Find the built JAR
ls build/libs/spawnerfinder-1.0.0.jar

📝 License

This project is licensed under the CC0-1.0 License - see the LICENSE file for details.

🤝 Contributing

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

Development Setup

1. Clone the repository
2. Import into your IDE (IntelliJ IDEA recommended)
3. Run ./gradlew genEclipseRuns or ./gradlew genIntellijRuns
4. Use the generated run configurations for testing

📞 Support

• Issues - Report bugs or request features via GitHub Issues
• Compatibility - Check the requirements section for supported versions
• Performance - If you experience lag, try reducing render distance

🔄 Version History

v1.0.0

• Initial release
• Basic spawner detection and HUD display
• Support for common mob types
• Client-side only implementation

🚨 Disclaimer

This mod is designed for exploration and convenience, not cheating.

Key Points:

• Information Only - Shows data about spawners in loaded chunks, doesn't provide ESP/wallhacks
• Behavior Responsibility - How you use this information determines if you get caught, not the mod itself
• Server Rules - Always check and respect individual server policies regarding client modifications
• Natural Play Encouraged - Use coordinates as guidance for exploration, not direct navigation

Legal Notice:

• This mod only accesses data already available to your Minecraft client
• No server-side detection is possible through technical means
• Player behavior and movement patterns are your responsibility
• The developers are not responsible for any bans resulting from suspicious gameplay behavior

Remember: The goal is enhanced exploration, not circumventing game mechanics. Play responsibly!