LorePages — Multi-Page & Conditional Item Lore

Keep your item tooltips clean, interactive, and highly detailed without cluttering player screens.

Perfect for RPG, Survival, Skyblock, and MMORPG servers, LorePages lets you break down item descriptions, lore, stats, and recipes into clean, navigable pages that players can turn with a simple key press inside their inventories.

Demo:
MMOItems


MythicMobs


Vanilla



Key Features

Multi-Page Lore: Split long item descriptions or item stats into multiple pages using a simple separator line (`---page---`).
Interactive Page Turning: Players can turn pages by hovering over an item in their inventory and pressing their Swap Offhand key (default: `F`).
Auto-Centered Page Footer: Displays dynamic navigation dots (e.g. `[ ● ○ ○ ]`) at the bottom of the tooltip. The plugin automatically calculates the pixel-width of the longest line and centers the footer dynamically. (May not work properly on item use icon have long width)
Audio Feedback: Configurable sound effects play when players successfully flip pages.
MythicMobs & MMOItems Integration: Automatically processes and bakes multi-page and conditional lores as soon as MythicMobs or MMOItems generates an item!
Vanilla Support: Fully compatible with Vanilla items. Items obtained via vanilla loot tables, custom crafting, or commands (like `/give`) will display navigable lore pages seamlessly.

How It Works (For Players)

Flipping through an item's lore is incredibly simple and seamless:
1. Open any inventory (Survival inventory, chests, virtual menus).
2. Hover the mouse cursor over the item with multiple pages.
3. Press your Swap Hand / Offhand key (default: F).
4. The item turns to the next page and plays a click sound.

---

How to Configure Items (For Creators)

1. Setting Up Multi-Page Lore
To split an item's lore into pages, simply add `---page---` on its own line in your item's lore configuration. This works out-of-the-box with **MythicMobs**, **MMOItems**, and **Vanilla** commands:

MythicMobs Example

MMOItems Example
In your MMOItems lore format configuration (e.g. under `language/loreformat.yml`):

#### Vanilla `/give` Command Example
For vanilla items, you can use standard lore components in command blocks or chat:

2. Setting Up Conditional Lore (`{itemData}`)
Show lines only if specific NBT/Persistent Data tags exist on the item.
Format: `{itemData:<tag_name>}Your Lore Text`
Use `{itemData:*}` to keep the line if the item has *any* custom persistent data tags (excluding system keys).

If the item does not have the `critical_modifier` PDC tag, that line will automatically be stripped from the tooltip.


Configuration (`config.yml`)

Fully customize the appearance of page indicators, layout alignment, and page-flip sounds:

Commands & Permissions
/lorepages reload- Reloads the configuration file - lorepages.admin

Aliases: /lp, /lorepage


Requirements & Installation

1. Server Software: Paper, Purpur, or Folia/Spigot (Version `1.21.x` or newer recommended).
2. Java Version: Java 21 or newer.
3. Compatible Plugins: Works with [MythicMobs]( https://www.spigotmc.org/resources/5702/) /, [MMOItems]( https://www.spigotmc.org/resources/39267/), and some other custom item manager/GUI plugins. (I did't test other much)

Installation Steps
1. Download the `LorePages-{version}.jar` file.
2. Drop it into your server's `plugins/` directory.
3. Restart your server.
4. Configure your items and start splitting lore into pages!