DartPages

插件

· 作者 Xdart

该项目提供了一种更简便的方式来创建自定义的书籍。

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

DartPages 是一款轻量级、高性能且易于维护的 Minecraft Spigot 服务器交互式书籍系统(支持 1.18.2 至 26.2+)。

它允许管理员和玩家通过直观的聊天编辑器或人类可读的 YAML 文件,创建包含可点击链接、命令、丰富色彩、格式以及 PlaceholderAPI 占位符的交互式书面书籍。


功能特性

  • ? 基于聊天的书籍编辑器:手持书与笔(Material.WRITABLE_BOOK),输入 /dpages,直接在聊天中逐行输入文本。
  • ? 可点击的 URL:使用 Markdown 语法 [Label](https://example.com),并在安全检查后在玩家的浏览器中打开网页链接。
  • ⚡ 可点击的命令:使用 Markdown 语法 [Label](/command),玩家在点击时直接以自身身份执行命令。
  • ? 完整的颜色与格式支持:全面支持传统的 & 颜色代码、格式组合(如 &c&l[Text](/spawn))以及十六进制颜色(&#RRGGBB 或 <#RRGGBB>)。
  • ? PlaceholderAPI 集成:动态占位符(如 %player_name%、%statistic_deaths% 等)在 YAML 中按字面存储,并在阅读/渲染书籍时实时解析。
  • ? 智能分页:自动计算 Minecraft 实体书籍的物理页面边界,无需截断文本或损坏 Unicode 字符。
  • ? 多语言支持:开箱即用地完全本地化,支持 英语 (en_US)、俄语 (ru_RU)、西班牙语 (es_ES) 和 中文 (zh_CN)。
  • ?️ 零冗余且安全:无外部数据库依赖,无 NMS 依赖,无数据包库,并提供可配置的 URL 协议和命令安全规则。

目录结构

plugins/DartPages/
├── config.yml
├── books/
│   └── example_book.yml
└── languages/
    ├── en_US.yml
    ├── ru_RU.yml
    ├── es_ES.yml
    └── zh_CN.yml

命令与别名

主要命令:/dpages(别名:/dartpages、/dpage、/dartpage、/dpg)

命令 权限 描述
/dpages [create] dartpages.create 在聊天中启动交互式书籍创建会话(必须手持书与笔)。
/dpages give <player> <bookId> dartpages.give 向玩家发放渲染好的自定义书籍。
/dpages list dartpages.list 列出所有已注册的可用书籍。
/dpages info <bookId> dartpages.info 显示详细的元数据及行/页统计信息。
/dpages edit <bookId> dartpages.edit 将现有书籍加载到交互式的聊天编辑会话中。
/dpages delete <bookId> [confirm] dartpages.delete 安全地删除书籍定义。
/dpages reload dartpages.reload 重新加载 config.yml、语言文件以及所有书籍。
/dpages help dartpages.admin 显示命令帮助概览。

权限

权限 描述 默认值
dartpages.admin 授予访问所有 DartPages 管理命令的权限。 op
dartpages.create 允许在聊天中开始交互式书籍创建。 op
dartpages.give 允许向玩家发放书籍。 op
dartpages.list 允许列出书籍。 op
dartpages.info 允许检查书籍信息。 op
dartpages.edit 允许通过聊天编辑书籍。 op
dartpages.delete 允许删除自定义书籍。 op
dartpages.reload 允许重新加载插件配置。 op

交互式语法指南

1. 可点击的 URL

Visit our [Official Website](https://example.com) for updates!

2. 可点击的命令

Click [Teleport to Spawn](/spawn) or [Open Menu](/menu)

3. 带有链接的颜色和格式

&a&l[Claim Free Reward](/kit starter)
&c&l[Dangerous PvP Arena](/warp pvp)

4. 动态占位符

Welcome, &e%player_name%&r! Your balance is &a$%vault_eco_balance%.

YAML 书籍格式 (books/example_book.yml)

id: "example_book"

title: "&6&lServer Guide"

author: "DartPages"

lore:
  - "&7Interactive server guide"
  - "&eRight-click to read"

pages:
  - lines:
      - "&6&lWelcome!"
      - "&rHello %player_name%!"
      - ""
      - "Visit our [website](https://example.com)"
      - "&l[Home](/home)"
      - "&a[Spawn](/spawn)"

  - lines:
      - "&b&lUseful Commands:"
      - "&7- [Home](/home) &8(Teleport)"
      - "&7- [Spawn](/spawn) &8(Main hub)"
      - "&7- [Menu](/menu) &8(Server GUI)"
      - ""
      - "&dCreated with DartPages."

配置 (config.yml)

language: "en_US"
  finish-keyword: "EOF"
  next-page-keyword: "NEXT_PAGE"
  cancel-keyword: "CANCEL"
  overwrite-keyword: "OVERWRITE"
  timeout-seconds: 300
  max-lines: 65536

book:
  max-pages: 50
  max-page-characters: 256
  default-author: "DartPages"

give:
  drop-if-inventory-full: true

placeholderapi:
  enabled: true
  keep-unresolved: true

interaction:
  hover:
    command: "&7点击执行 &f/%command%"
    url: "&7点击打开 &f%url%"

security:
  allowed-url-schemes:
    - "http"
    - "https"

  commands:
    enabled: true
    mode: "ALLOW_ALL" # ALLOW_ALL, ALLOWLIST, DENYLIST
    allowed: []
    denied:
      - "op"
      - "deop"
      - "stop"
      - "reload"

debug:
  enabled: false

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源