DartPages is a lightweight, high-performance, and maintainable interactive book system for Minecraft Paper and Spigot servers. It enables administrators and players to create interactive written books featuring clickable links, commands, rich colors, formatting, and PlaceholderAPI placeholders through an intuitive chat composer or human-readable YAML files.

Features

  • Chat-Based Book Composer: Hold a Book and Quill (Material.WRITABLE_BOOK), type /dpages, and enter text line by line directly in chat without wrestling with complex raw JSON formatting.
  • Clickable URLs: Use standard Markdown syntax [Label](https://example.com) to open web links safely in the player's browser with domain safety checks.
  • Clickable Commands: Use Markdown syntax [Label](/command) to execute commands directly as the player upon clicking.
  • Full Color & Formatting: Full support for legacy & color codes, formatting combinations (&c&l[Text](/spawn)), and Hex colors (&#RRGGBB or <#RRGGBB>).
  • PlaceholderAPI Integration: Dynamic placeholders (%player_name%, %statistic_deaths%, etc.) stored literally in YAML and resolved in real-time when the book is read or rendered.
  • Smart Page Wrapping: Automatic calculation of physical Minecraft book page boundaries without truncating text or corrupting Unicode characters.
  • Multi-Language Support: Fully localized out of the box in English (en_US), Russian (ru_RU), Spanish (es_ES), and Chinese (zh_CN).

Player & Admin Commands

Primary command: /dpages (Aliases: /dartpages, /dpage, /dartpage, /dpg)

Command Permission Description
/dpages [create] dartpages.create Start interactive book creation session in chat (must hold Book and Quill).
/dpages give <player> <bookId> dartpages.give Give a rendered custom book to a player.
/dpages list dartpages.list List all available registered books.
/dpages info <bookId> dartpages.info Display detailed metadata and line/page statistics.
/dpages edit <bookId> dartpages.edit Load an existing book into an interactive chat edit session.
/dpages delete <bookId> [confirm] dartpages.delete Delete a book definition safely.
/dpages reload dartpages.reload Reload config.yml, language files, and all books.
/dpages help dartpages.admin Show admin help and usage guide.

YAML Book Definition Structure

Books can also be authored and customized directly via YAML files inside plugins/DartPages/books/:

title: "Server Guide"
author: "Admin"
pages:
  - "Welcome to mc.SEONBI.lt!\n\n[Visit Website](https://seonbi.lt)\n[Claim Land](/claims)"
  - "Check your stats:\nYour Name: %player_name%\nDeaths: %statistic_deaths%"

Source and documentation reference: Modrinth Project