角色扮演游戏背景设定

一个数据驱动的传说书模组,适用于Minecraft Forge 1.20.1。通过简单的JSON文件定义自定义书籍,并根据可配置条件让它们从生物身上掉落。

冒险

RPG Lore

由生物掉落的数据驱动式传说书籍。在传说图鉴中收集全部书籍。

RPG Lore 让整合包作者和服务器管理者通过简单的 JSON 文件向世界中添加自定义传说书籍。书籍会根据可配置的条件从生物身上掉落——实体类型、生物群系、维度、一天中的时间、天气、Y 轴高度等等。无需编写代码。


主要特性

传说书籍

  • 完全数据驱动 —— 配置文件夹中的每个 .json 文件都会成为一本传说书籍。无需重新编译即可添加、编辑或移除书籍。
  • 条件掉落 —— 通过 11 种不同的过滤类型精确控制哪些生物掉落哪些书籍。
  • 自定义样式 —— 每本书可设置标题颜色、作者颜色、描述、附魔光效开关以及世代标签。
  • 风格化标题页 —— 每本书打开时都会显示自动生成的标题页,包含书名(缩放、加粗、带颜色)和作者。
  • 自定义书籍 GUI —— 传说书籍使用与原版成书不同的独特纹理。
  • 每位玩家的副本上限 —— 可选择限制每位玩家获得某本特定书籍的次数。
  • 抢夺缩放 —— 可选择让掉落几率随抢夺附魔等级提升。

传说图鉴

  • 个人收藏书 —— 一件灵魂绑定物品,将你的传说书籍直接存储在其中。
  • 书籍进入图鉴 —— 当你拾取一本新的传说书籍时,它会从世界中消耗并存入图鉴。不会弄乱物品栏。
  • 可浏览 GUI —— 自定义羊皮纸风格界面,带有分页书籍列表、收藏计数器(n/N)以及每本书的阅读和复制操作。
  • 复制机制 —— 将任何已收集的书籍制作成实体副本放入你的物品栏。副本始终会进入你的物品栏,世代等级递增。
  • 灵魂绑定 —— 首次登录时获得,死亡后保留,无法丢弃。
  • 防重复 —— 可切换以阻止拾取你已收集过的传说书籍。
  • Curios API 支持 —— 将图鉴装备到专用的“codex” Curios 槽位中。软依赖——即使未安装 Curios 也能正常工作。

面向整合包作者

  • 支持热重载 —— 使用 /rpglore reload 无需重启即可应用更改。
  • 11 种掉落条件类型 —— 实体类型、实体标签、生物群系、生物群系标签、维度、Y 轴范围、一天中的时间、天气、玩家击杀要求、每本书的几率覆盖以及每位玩家的副本上限。
  • 书籍分类 —— 使用 category 字段组织书籍,使图鉴分组更清晰。
  • 图鉴排除 —— 使用 codex_exclude 从图鉴中隐藏调试或临时书籍。
  • 每本书光效 —— 可为每本书单独开启或关闭附魔闪光。
  • 全面的 README —— 配置文件夹中自动生成 _README.txt,记录每个字段的说明。

管理

  • /rpglore reload —— 热重载所有书籍定义
  • /rpglore give —— 将书籍给予玩家(可选择追踪副本上限)
  • /rpglore list —— 列出所有已加载的书籍及其分类
  • /rpglore collection —— 玩家可查看自己的收藏(无需 OP 权限)
  • /rpglore codex give/reset/add/remove/status —— 完整的图鉴管理

快速开始

  1. 将 JAR 放入你的 mods/ 文件夹。
  2. 启动游戏一次 —— 模组会生成示例配置和一本示例书籍。
  3. 将你的 .json 书籍文件添加到 config/rpg_lore/books/。
  4. 使用 /rpglore reload 应用更改。
  5. 玩家首次加入时会获得一本传说图鉴。右键单击即可浏览你的收藏。

书籍定义示例

{
  "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..."
  ]
}

配置

所有设置均位于 config/rpg_lore/server.toml 和 config/rpg_lore/client.toml。每项图鉴功能均可单独开启或关闭。

兼容性

  • Curios API(可选)—— 将图鉴装备到专用的 Curios 槽位中。所有功能在物品栏或 Curios 槽位中均可使用。即使未安装 Curios,模组也能完整运行。

本地化

已本地化为 60 种语言,包括英语、中文、西班牙语、印地语、阿拉伯语、法语、德语、俄语、日语、韩语等 50 多种语言。


需要: Minecraft 1.20.1 | Forge 47.3.0+ | Java 17 可选: Curios API 5.4.7+ 许可证: MIT 源码: GitHub