Middle-Earth Additions: Factions

Middle-Earth Additions: Factions

📖 概述

Middle-Earth Additions: Factions 是 Middle-Earth 模组的强大附属模组，可自动追踪玩家所属的派系，并与兼容 PlaceholderAPI 的模组无缝集成。非常适合想在聊天、前缀及其他 UI 元素中显示派系信息的服务器。

✨ 功能

🏰 自动追踪派系

• 实时检测：自动检测玩家加入 Middle-Earth 模组中派系的情况

• 持久化存储：将派系数据以 JSON 文件形式存储在世界存档目录中

• 零配置：开箱即用，无需额外设置

🔗 PlaceholderAPI 集成

• 广泛兼容：兼容 StyledChat、LuckPerms 以及任何支持 PlaceholderAPI 的模组

• 多种占位符：提供多种占位符格式，适用于不同用途

• 可选依赖：可独立运行；安装 PlaceholderAPI 后功能更完善

🧭 称号菜单（新增）

• 打开方式：游戏中按默认按键 O 打开派系称号菜单。可在“Middle Earth Additions”类别下的控制设置中重新绑定按键。

• 派系面板：简洁的面板会显示你当前的派系图标和五个称号节点。

• 善恶阵营变体：菜单会根据你的阵营倾向（善良/邪恶）调整，并更换按钮图标和等级名称（例如：士兵→骑士→队长→男爵→领主，或战士→乌鲁克→酋长→将军→霸主）。

• 线性晋升：必须按顺序解锁。尝试预览或解锁后续节点时，会显示前置条件提示。

• 需求与反馈：工具提示会显示银币、金币和经验等级要求，并以颜色标示状态。资源不足或缺少前置条件时，会通过快捷栏消息提示。

• 派系图标：左上角的派系按钮会显示符合派系特色的物品（例如刚铎盾牌、魔多木盾等）。

• 已解锁增益列表：面板会列出已解锁等级的增益（例如：速度提升 10%、箭矢伤害 +0.5、生命值 +1 颗心、抗性光环）。

🎮 玩家命令

• 切换显示：玩家可以控制是否在聊天中显示自己的派系

• 测试工具：内置调试命令，可用于测试占位符功能

🛠️ 开发者 API

• 公共 API：提供简洁接口，供其他模组访问派系数据

• 类型安全：妥善处理 null 值和错误

• 文档：提供完整的 JavaDoc 和用法示例

📋 要求

必需依赖

• Minecraft：1.21.1

• Fabric Loader：0.16.14+

• Fabric API：最新版本

• Middle-Earth Mod：1.5.3-1.21.1-alpha 或兼容版本

可选依赖

• PlaceholderAPI：2.4.0+（增强占位符支持）

• StyledChat：用于集成聊天格式设置

• LuckPerms：用于集成基于权限的前缀/后缀

🚀 安装

1. 安装 Fabric Loader 和 Fabric API

1. 安装 Middle-Earth 模组

1. 下载此模组并放入 mods 文件夹

1. （可选）安装 PlaceholderAPI 以增强兼容性

1. 启动服务器/世界

📝 可用占位符

基本占位符

| 占位符 | 描述 | 示例输出 |
|————-|————-|—————-|
| %mefaction% | 格式化的派系名称 | Gondor |
| %mefaction_full% | 完整的派系标识符 | me:gondor |
| %mefaction_display% | 带派系名称的显示文本（启用时） | [Gondor] PlayerName |
| %metitle% | 玩家称号 | Soldier |

支持的派系

所有《Middle-Earth》模组派系均受支持，并采用适当的格式：

| 派系 ID | 显示名称 |
|————|————–|
| me:gondor | 刚铎 |
| me:rohan | 洛汗 |
| me:dale | 河谷镇 |
| me:longbeards | 长须族 |
| me:longbeards.erebor | 孤山 |
| me:lothlorien | 罗丝洛立安 |
| me:mordor | 魔多 |
| me:misty_mountains_goblins | 迷雾山脉 |
| me:isengard | 艾森加德 |
| me:shire | 夏尔 |
| me:bandit | 强盗 |

🎯 使用示例

StyledChat 集成

{

"chat": {

"format": "<%mefaction% {player_name}> {message}"

}

}

效果：大家好！

LuckPerms 前缀

/lp user PlayerName meta setprefix 100 "%mefaction% "

效果：玩家显示为“刚铎 玩家名称”

自定义聊天格式

{

"style": {

"chat": "[%mefaction%] %player% » %message%"

}

}

效果：[刚铎] 玩家名称 » 中土世界，你好！

🎮 命令

玩家命令

• /togglefaction – 切换是否在名称中显示派系

• 显示你当前的派系状态

• 预览你的名称显示效果

管理员命令

• /viewfactiondata – 查看所有已存储的派系数据

• 列出所有玩家及其派系

• 显示玩家总数

• /exportfactiondata – 显示派系数据文件位置

• 显示 JSON 存储文件的路径

• 显示当前存储统计信息

• /testfactionplaceholder – 测试占位符功能

• 供服务器管理员使用的调试工具

• 显示玩家可用的所有占位符

• 显示当前切换状态

📊 数据存储

派系数据会自动保存至 [world]/faction_data.json：

{

"player-uuid-here": {

"playerId": "player-uuid",

"playerName": "PlayerName",

"disposition": "good",

"factionId": "me:gondor",

"spawnId": "me:gondor.minas_tirith",

"timestamp": 1672531200000

}

}

数据字段

• playerId：玩家的唯一标识符

• playerName：玩家当前名称

• disposition：派系阵营（善良/邪恶/中立）

• factionId：Middle-Earth 模组中的完整派系标识符

• spawnId：关联的出生地点

• timestamp：上次更新时间（毫秒）

🤝 兼容性

已测试的兼容项目

• ✅ StyledChat – 完整支持聊天格式

• ✅ LuckPerms – 集成前缀/后缀

• ✅ TAB – 集成记分板和玩家列表

• ✅ MiniMOTD – 支持服务器 MOTD 占位符

🛠️ 配置

本模组无需任何配置即可运行。所有设置都会根据你安装的 Middle-Earth 模组自动检测和配置。

自定义选项

• 玩家的切换状态会在服务器重启后保留

• 可通过 API 自定义派系名称格式

• JSON 数据位置与地图存档关联，支持多地图

📄 许可证

本模组采用保留所有权利许可证发布。详情请参阅 LICENSE 文件。

🙏 致谢

• Middle-Earth Mod – 提供了精彩的中土世界体验

• PlaceholderAPI – 提供了出色的占位符系统

• Fabric Community – 提供了模组框架和工具

---

祝你在中土世界冒险愉快！🧙‍♂️⚔️🏰