RPG Lore
No reviews yet
A data-driven lore book mod for Minecraft Forge 1.20.1. Define custom books via simple JSON files and have them drop from mobs based on configurable conditions.
Does not follow a specific thematic focus apart from vanilla Minecraft.
Includes a large focus on traversing worlds with enhanced world generation, structures, dungeons, and more for players to find unique loot.
Features role-playing elements like character progression, quests, and story-driven gameplay.
Includes a custom backstory, written world-building, or narrative writing within the project or through external content.
Adds extra equipment such special items and accessories specifically using the Baubles or Curios mods.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Includes educational content aimed towards newer modded Minecraft players, usually guiding the player through specific mods.
Projects that have been proven to or clearly use AI-generated art assets, including project logo. Projects with this tag are automatically excluded from all Pack Finder results.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
Must be installed on both the client and the server.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
RPG Lore
Data-driven lore books that drop from mobs. Collect them all in the Lore Codex.
RPG Lore lets modpack makers and server owners add custom lore books to their world using simple JSON files. Books drop from mobs based on configurable conditions -- entity type, biome, dimension, time of day, weather, Y-level, and more. No coding required.
Key Features
Lore Books
- Fully data-driven -- each
.jsonfile in the config folder becomes a lore book. Add, edit, or remove books without recompiling. - Conditional drops -- control exactly which mobs drop which books with 11 different filter types.
- Custom styling -- per-book title color, author color, description, enchantment glint toggle, and generation labels.
- Stylized title page -- every book opens with an auto-generated title page featuring the book's title (scaled, bold, colored) and author.
- Custom book GUI -- lore books use a unique texture distinct from vanilla written books.
- Per-player copy limits -- optionally restrict how many times each player can receive a specific book.
- Looting scaling -- optionally increase drop chance with the Looting enchantment.
Lore Codex
- Personal collection book -- a soul-bound item that stores your lore books directly inside it.
- Books go into the Codex -- when you pick up a new lore book, it's consumed from the world and stored in the Codex. No inventory clutter.
- Browsable GUI -- custom parchment-styled screen with paginated book list, collection counter (n/N), and per-book Read and Copy actions.
- Copy mechanic -- create a physical copy of any collected book into your inventory. Copies always go to your inventory with generation incremented.
- Soul-bound -- granted on first login, kept on death, cannot be dropped.
- Duplicate prevention -- toggle to block picking up lore books you've already collected.
- Curios API support -- equip the Codex in a dedicated "codex" Curios slot. Soft dependency -- works without Curios installed.
For Pack Makers
- Hot-reloadable -- use
/rpglore reloadto apply changes without restarting. - 11 drop condition types -- entity type, entity tags, biome, biome tags, dimension, Y-range, time of day, weather, player kill requirement, per-book chance override, and per-player copy limits.
- Book categories -- organize books with the
categoryfield for clean Codex grouping. - Codex exclusion -- hide debug or temporary books from the Codex with
codex_exclude. - Per-book glint -- toggle the enchantment shimmer on/off per book.
- Comprehensive README -- auto-generated
_README.txtin the config folder documents every field.
Administration
/rpglore reload-- hot-reload all book definitions/rpglore give-- give books to players (with optional copy-limit tracking)/rpglore list-- list all loaded books with categories/rpglore collection-- players can view their own collection (no OP required)/rpglore codex give/reset/add/remove/status-- full Codex administration
Quick Start
- Drop the JAR into your
mods/folder. - Start the game once -- the mod generates example configs and a sample book.
- Add your
.jsonbook files toconfig/rpg_lore/books/. - Use
/rpglore reloadto apply changes. - Players receive a Lore Codex on first join. Right-click to browse your collection.
Example Book Definition
{
"title": "The Ancient Battle",
"author": "Unknown Chronicler",
"weight": 5,
"title_color": "FFD700",
"description": "A faded account of a great battle.",
"category": "History",
"drop_conditions": {
"mob_types": ["minecraft:zombie", "minecraft:skeleton"],
"biome_tags": ["minecraft:is_overworld"],
"time": "NIGHT_ONLY"
},
"pages": [
"Long ago, in these very fields...",
"The battle raged for three days..."
]
}Configuration
All settings are in config/rpg_lore/server.toml and config/rpg_lore/client.toml. Every Codex feature can be individually toggled on or off.
Compatibility
- Curios API (optional) -- equip the Codex in a dedicated Curios slot. All features work from either inventory or Curios slot. The mod functions fully without Curios installed.
Localization
Localized in 60 languages including English, Chinese, Spanish, Hindi, Arabic, French, German, Russian, Japanese, Korean, and 50 more.
Requires: Minecraft 1.20.1 | Forge 47.3.0+ | Java 17 Optional: Curios API 5.4.7+ License: MIT Source: GitHub
RPG Lore
Data-driven lore books that drop from mobs. Collect them all in the Lore Codex.
RPG Lore lets modpack makers and server owners add custom lore books to their world using simple JSON files. Books drop from mobs based on configurable conditions -- entity type, biome, dimension, time of day, weather, Y-level, and more. No coding required.
Key Features
Lore Books
- Fully data-driven -- each
.jsonfile in the config folder becomes a lore book. Add, edit, or remove books without recompiling. - Conditional drops -- control exactly which mobs drop which books with 11 different filter types.
- Custom styling -- per-book title color, author color, description, enchantment glint toggle, and generation labels.
- Stylized title page -- every book opens with an auto-generated title page featuring the book's title (scaled, bold, colored) and author.
- Custom book GUI -- lore books use a unique texture distinct from vanilla written books.
- Per-player copy limits -- optionally restrict how many times each player can receive a specific book.
- Looting scaling -- optionally increase drop chance with the Looting enchantment.
Lore Codex
- Personal collection book -- a soul-bound item that stores your lore books directly inside it.
- Books go into the Codex -- when you pick up a new lore book, it's consumed from the world and stored in the Codex. No inventory clutter.
- Browsable GUI -- custom parchment-styled screen with paginated book list, collection counter (n/N), and per-book Read and Copy actions.
- Copy mechanic -- create a physical copy of any collected book into your inventory. Copies always go to your inventory with generation incremented.
- Soul-bound -- granted on first login, kept on death, cannot be dropped.
- Duplicate prevention -- toggle to block picking up lore books you've already collected.
- Curios API support -- equip the Codex in a dedicated "codex" Curios slot. Soft dependency -- works without Curios installed.
For Pack Makers
- Hot-reloadable -- use
/rpglore reloadto apply changes without restarting. - 11 drop condition types -- entity type, entity tags, biome, biome tags, dimension, Y-range, time of day, weather, player kill requirement, per-book chance override, and per-player copy limits.
- Book categories -- organize books with the
categoryfield for clean Codex grouping. - Codex exclusion -- hide debug or temporary books from the Codex with
codex_exclude. - Per-book glint -- toggle the enchantment shimmer on/off per book.
- Comprehensive README -- auto-generated
_README.txtin the config folder documents every field.
Administration
/rpglore reload-- hot-reload all book definitions/rpglore give-- give books to players (with optional copy-limit tracking)/rpglore list-- list all loaded books with categories/rpglore collection-- players can view their own collection (no OP required)/rpglore codex give/reset/add/remove/status-- full Codex administration
Quick Start
- Drop the JAR into your
mods/folder. - Start the game once -- the mod generates example configs and a sample book.
- Add your
.jsonbook files toconfig/rpg_lore/books/. - Use
/rpglore reloadto apply changes. - Players receive a Lore Codex on first join. Right-click to browse your collection.
Example Book Definition
{
"title": "The Ancient Battle",
"author": "Unknown Chronicler",
"weight": 5,
"title_color": "FFD700",
"description": "A faded account of a great battle.",
"category": "History",
"drop_conditions": {
"mob_types": ["minecraft:zombie", "minecraft:skeleton"],
"biome_tags": ["minecraft:is_overworld"],
"time": "NIGHT_ONLY"
},
"pages": [
"Long ago, in these very fields...",
"The battle raged for three days..."
]
}
Configuration
All settings are in config/rpg_lore/server.toml and config/rpg_lore/client.toml. Every Codex feature can be individually toggled on or off.
Compatibility
- Curios API (optional) -- equip the Codex in a dedicated Curios slot. All features work from either inventory or Curios slot. The mod functions fully without Curios installed.
Localization
Localized in 60 languages including English, Chinese, Spanish, Hindi, Arabic, French, German, Russian, Japanese, Korean, and 50 more.
Requires: Minecraft 1.20.1 | Forge 47.3.0+ | Java 17 Optional: Curios API 5.4.7+ License: MIT Source: GitHub
Screenshots
Gallery
-
Lore Codex (Opened) The GUI for the Lore Codex. -
Lore Codex Tool-Tip The Tool-Tip for the Lore Codex. -
Display Message on Pick-Up of Lore Book The message which displays when a Lore Book is picked up. -
Lore Book Title Page Title Page of the Default Lore Book. -
Default Lore Book Page 1 The first page of the default Lore Book. -
Default Lore Book Page 2 The second page of the default Lore Book. -
Lore Book Tool-Tip (Copy) What the tool-tip for a Lore Book copy looks like.
-
Screenshot of Floating Lore Book -
Screenshot of Holding a Lore Book -
Screenshot of First Page for Lore Book -
Screenshot of Title Page for Lore Book
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers