EntityLogger

Real-time entity tracking and world state monitoring for Minecraft, optimized for bot automation and external tools.

📊 What does this mod do?

EntityLogger continuously monitors your Minecraft world and logs all relevant entity data to a fast SQLite database. Perfect for creating AI bots, automation scripts, or analytics tools that need real-time access to game state information.

✨ Key Features

🎯 Three Organized Data Tables

1. Monster Tracking (monsters table)

• Logs all hostile mobs in your vicinity
• Tracks name, exact coordinates (x, y, z)
• Calculates distance to player
• Records health values
• Includes unique UUID for identification

2. Player Tracking (players table)

• Monitors all players in the area (including yourself)
• Same detailed information as monsters
• Perfect for multiplayer coordination

3. World State (world_time table)

• Current game day and tick count
• Moon phase information (important for mob spawning!)
• Human-readable time format: "Tag 5, Zeit: 14567 ticks, Mondphase: Vollmond 8/8"

⚡ Performance Optimized

• High-speed updates: Database refreshes 2x per second (every 10 ticks)
• WAL mode enabled: No database locking - read while the mod writes
• Snapshot-based: Always current data, no historical clutter
• Batch operations: Efficient SQL transactions for minimal overhead
• Concurrent access: Python/Java scripts can read database in real-time

🤖 Perfect for Bot Scripts

The mod is specifically designed for automation:

• Clean data structure - Easy to parse and query
• No timestamps to worry about - Always fresh snapshots
• Distance calculations included - Prioritize threats automatically
• Reliable updates - Consistent 10-tick refresh cycle

📦 What’s Included

The mod automatically creates logs/minecraft_entities.db with three simple tables:

-- Example: Get nearest monsters
SELECT name, x, y, z, distance_to_player 
FROM monsters 
ORDER BY distance_to_player ASC 
LIMIT 5;

-- Example: Find all players
SELECT name, x, y, z FROM players;

-- Example: Current game time SELECT game_day, game_ticks, moon_phase FROM world_time WHERE id = 1;

## 🎮 Use Cases

- **Combat Bots**: Automatically track and respond to nearby threats
- **Multiplayer Coordination**: Monitor teammate positions
- **Analytics**: Study mob spawning patterns and player behavior
- **Automation Scripts**: Build self-playing Minecraft bots
- **External Dashboards**: Create real-time monitoring interfaces
- **Machine Learning**: Collect training data for AI models

## 🔧 Technical Details

- **Client-side only** - No server installation needed
- **Lightweight** - Minimal performance impact
- **SQLite database** - No external database server required
- **Fabric mod** - Requires both Fabric Loader and Fabric API

### Requirements

- **[Fabric API 0.133.4+1.21.8](/mod/fabric-api/version/0.133.4+1.21.8)** (Required dependency)
- **Fabric Loader** for Minecraft 1.21.8
- **Java 17+**

## 📋 Monster List

Tracks all hostile mobs including:

- Basic: Zombie, Skeleton, Creeper, Spider, Witch, Slime
- Nether: Blaze, Wither Skeleton, Magma Cube, Hoglin, Piglin variants
- Ocean: Drowned, Guardian, Elder Guardian
- Illagers: Pillager, Vindicator, Evoker, Ravager, Vex
- Special: Warden, Breeze, Shulker, Silverfish
- **Excludes**: Enderman, Zombified Piglin, Ghast (configurable in future versions)

## 🚀 Getting Started

1. Install **Fabric Loader** for Minecraft 1.21.8
1. Download and install **[Fabric API 0.133.4+1.21.8](/mod/fabric-api/version/0.133.4+1.21.8)**
1. Drop EntityLogger into your `mods` folder
1. Launch Minecraft
1. Find the database at `logs/minecraft_entities.db`
1. Start building your automation scripts!

## 💻 Example Python Integration

```python
import sqlite3
import time

# Connect to the database
conn = sqlite3.connect('logs/minecraft_entities.db')
cursor = conn.cursor()

while True:
    # Get nearest monster
    cursor.execute("""
        SELECT name, distance_to_player 
        FROM monsters 
        ORDER BY distance_to_player ASC 
        LIMIT 1
    """)
    result = cursor.fetchone()
    
    if result:
        print(f"Warning! {result[0]} at {result[1]:.1f} blocks away!")
    
    time.sleep(0.5)  # Check twice per second

🤝 Community & Support

This mod is open for feature requests! If you’re building automation tools and need additional data logged, feel free to suggest improvements.

---

License: MIT
Supports: Minecraft 1.21.8 (Fabric)
Dependencies: Fabric API 0.133.4+1.21.8 (Required)
Java: 17+