Lore Expansion

The Lore Expansion modification is designed for pack authors and map creators who want to deepen the game's story and add unique narrative elements. Although originally developed for use with the Hardcore Questing Mode mod, it works equally well for adventure maps.

Full Customization via JSON

All lore elements are fully customizable through JSON files. You can modify titles, page text, page numbers, and even bind lore to specific dimensions. To add audio, simply record a sound file in .ogg format, place it in the appropriate folder, and specify the filename (without extension) in the corresponding JSON variable.

HQM Integration

When used with Hardcore Questing Mode, each lore page is registered as a separate item. You can assign lore pages as quest rewards or allow players to find them through other means. Discovered pages are automatically added to the lore book, which can be accessed by right-clicking the book or pressing the configurable hotkey (default L).

Click the image above to watch the tutorial video with commentary by Vaygrim

Progress Tracking System

Cells on the left display the total number of available lore pages. As pages are collected, the corresponding cells fill up. If a player misses any page, an empty cell indicates a gap in the collection. Any page can be replayed by selecting its icon and clicking "Play Again". The book can be closed while continuing to listen to the lore during gameplay.

Dimension Binding

If lore is marked for a specific dimension, it appears on separate tabs. Using the tabs on the left, players can switch between dimensions and view discovered lore for each one.

Narrative Features

Primary Lore

Some pages can be marked as primary lore—they automatically play upon acquisition without needing to open the journal. This enables creating unique narrative moments at key points in adventure maps. Use command blocks to give pages to players in specific areas, and the lore will automatically add to the journal and begin playing.

For example, in a map set on a space station or ship, lore could simulate announcements over loudspeakers or the voice of an AI directing the player to checkpoints.

Command Triggers

Lore pages can be configured to execute commands when added to the journal. When a player finds such a page, the specified commands run automatically, similar to command blocks. This eliminates the need for complex redstone circuits to activate commands and allows combining multiple functions in a single page.

JSON File Location

Lore configuration files are located at: %config%/LoreExpansion/lore/*.json