header
Mob Journal avatar

Mob Journal

Donate
Install

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.

🛠️ 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