RPG Lore
由数据驱动的掉落自生物的传说书籍。在传说法典中收集它们。
RPG Lore 允许整合包制作者和服务器管理员使用简单的 JSON 文件向世界中添加自定义传说书籍。书籍基于可配置的条件从生物身上掉落——包括实体类型、生物群系、维度、一天中的时间、天气、Y 轴高度等。无需编写代码。
主要特性
传说书籍
- 完全数据驱动 -- 配置文件文件夹中的每个
.json 文件都会变成一本传说书籍。添加、编辑或删除书籍而无需重新编译。
- 条件掉落 -- 通过 11 种不同的过滤类型精确控制哪些生物掉落哪些书籍。
- 自定义样式 -- 支持每本书的标题颜色、作者颜色、描述、附魔光泽开关以及生成标签。
- 风格化扉页 -- 每本书打开时都会自动生成一个扉页,包含缩放、加粗、着色的书名和作者信息。
- 自定义书籍 GUI -- 传说书籍使用与原版书不同的独特纹理。
- 每位玩家复制限制 -- 可选择限制每位玩家获得特定书籍的次数。
- 抢夺附魔加成 -- 可选择让掉落几率随抢夺附魔等级增加。
传说法典 (Lore Codex)
- 个人收藏之书 -- 一件灵魂绑定物品,直接将你的传说书籍存储在其中。
- 书籍存入法典 -- 当你拾取新的传说书籍时,它将从世界中消失并存储进法典。不会造成物品栏杂乱。
- 可浏览的 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 -- 完整的法典管理功能
快速开始
- 将 JAR 文件放入
mods/ 文件夹。
- 启动游戏一次 -- 模组会生成示例配置和一本示例书籍。
- 将你的
.json 书籍文件添加到 config/rpg_lore/books/。
- 使用
/rpglore reload 应用更改。
- 玩家在首次加入时会获得传说法典。右键点击即可浏览你的收藏。
示例书籍定义
{
"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
RPG Lore
Data-driven lore books that drop from mobs. Collect them all in the Lore Codex.
RPG Lore lets modpack makers and server owners add custom lore books to their world using simple JSON files. Books drop from mobs based on configurable conditions -- entity type, biome, dimension, time of day, weather, Y-level, and more. No coding required.
Key Features
Lore Books
- Fully data-driven -- each
.json file in the config folder becomes a lore book. Add, edit, or remove books without recompiling.
- Conditional drops -- control exactly which mobs drop which books with 11 different filter types.
- Custom styling -- per-book title color, author color, description, enchantment glint toggle, and generation labels.
- Stylized title page -- every book opens with an auto-generated title page featuring the book's title (scaled, bold, colored) and author.
- Custom book GUI -- lore books use a unique texture distinct from vanilla written books.
- Per-player copy limits -- optionally restrict how many times each player can receive a specific book.
- Looting scaling -- optionally increase drop chance with the Looting enchantment.
Lore Codex
- Personal collection book -- a soul-bound item that stores your lore books directly inside it.
- Books go into the Codex -- when you pick up a new lore book, it's consumed from the world and stored in the Codex. No inventory clutter.
- Browsable GUI -- custom parchment-styled screen with paginated book list, collection counter (n/N), and per-book Read and Copy actions.
- Copy mechanic -- create a physical copy of any collected book into your inventory. Copies always go to your inventory with generation incremented.
- Soul-bound -- granted on first login, kept on death, cannot be dropped.
- Duplicate prevention -- toggle to block picking up lore books you've already collected.
- Curios API support -- equip the Codex in a dedicated "codex" Curios slot. Soft dependency -- works without Curios installed.
For Pack Makers
- Hot-reloadable -- use
/rpglore reload to apply changes without restarting.
- 11 drop condition types -- entity type, entity tags, biome, biome tags, dimension, Y-range, time of day, weather, player kill requirement, per-book chance override, and per-player copy limits.
- Book categories -- organize books with the
category field for clean Codex grouping.
- Codex exclusion -- hide debug or temporary books from the Codex with
codex_exclude.
- Per-book glint -- toggle the enchantment shimmer on/off per book.
- Comprehensive README -- auto-generated
_README.txt in the config folder documents every field.
Administration
/rpglore reload -- hot-reload all book definitions
/rpglore give -- give books to players (with optional copy-limit tracking)
/rpglore list -- list all loaded books with categories
/rpglore collection -- players can view their own collection (no OP required)
/rpglore codex give/reset/add/remove/status -- full Codex administration
Quick Start
- Drop the JAR into your
mods/ folder.
- Start the game once -- the mod generates example configs and a sample book.
- Add your
.json book files to config/rpg_lore/books/.
- Use
/rpglore reload to apply changes.
- Players receive a Lore Codex on first join. Right-click to browse your collection.
Example Book Definition
{
"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..."
]
}
Configuration
All settings are in config/rpg_lore/server.toml and config/rpg_lore/client.toml. Every Codex feature can be individually toggled on or off.
Compatibility
- Curios API (optional) -- equip the Codex in a dedicated Curios slot. All features work from either inventory or Curios slot. The mod functions fully without Curios installed.
Localization
Localized in 60 languages including English, Chinese, Spanish, Hindi, Arabic, French, German, Russian, Japanese, Korean, and 50 more.
Requires: Minecraft 1.20.1 | Forge 47.3.0+ | Java 17 Optional: Curios API 5.4.7+ License: MIT Source: GitHub
评论 0
登录后参与评分
还没有评论,来抢沙发吧