Mob Journal is a lightweight and immersive mod that automatically records every mob you've encountered in your world. Track your discoveries, see detailed descriptions, and browse mobs by name or mod.

🧠 Features

📝 Auto-Discovery – Mobs are added as you wander close to them.
📚 In-Game Journal UI – A beautifully rendered double-page book to browse mobs.
🔍 Search & Filters – Search by name or mod (e.g. @mythology).
🧟 Mob Details – Health, armor, drop preview, and kill/death stats.
🔔 Toasts – Get a custom notification when you discover a new mob.
🎨 Custom Descriptions – Add your own JSON-based mob descriptions (optional).

💡 Usage

Open the journal with J (configurable in controls) (Only works if you have the Mob Journal item in your inventory)
Scroll through pages using the arrow buttons.
Click on a mob to view its details.
Use the search bar to find mobs quickly.
- Search by mod using @modid, e.g. @minecraft or @mobs_of_mythology.
Alt + Left click on a mob inside the grid list or detail will open up its render config!

🛠️ Custom Descriptions

Descriptions can be provided per mob or by default per mod. More on this in the README.

You can add custom mob descriptions using JSON files in:

assets/journal/mobs_desc/<mob_namespace>/<mob_name>.json

Supports simple Markdown with in-game formatting, icons, and loot placeholders.

✅ Requirements

Porting to Forge is not planned