premium banner
Records newly discovered mobs into your journal!

Description

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