年鉴

欢迎来到Rusty的年鉴，通往Valheim迷人世界的入口！

Rusty的综合插件目录列出了游戏中加载的所有物品、部件和生物。

凭借触手可及的丰富信息，轻松探索瓦尔海姆的深处。

此外，Rusty's Almanac 不仅仅是文档。通过集成的可自定义成就系统和排行榜，用户可以打造自己独特的体验。

成就

年鉴让你可以使用以下方式定义自定义成就 .yml 成就文件夹中的文件。这些成就会在服务器和客户端之间同步，并在编辑时动态重新加载。

以下是可用选项 成就类型 你可以使用：

箭矢	箭矢射击次数	斧	弓
消耗品	生物群组	生物已驯服	死亡
空中距离	已奔跑距离	航行距离	已行走距离
击杀敌人	鱼	食物已食用	拾取物品
击杀	匕首	锤	材料
攻击命中次数	可拾取	玩家击杀数	长柄武器
药水	配方	护盾	长矛
法杖	剑	基地时间	离开基地时间
总跳跃次数	总采集量	奖杯	贵重物品
武器	收集物品	成就

成就文件结构

每个成就都定义为一个YAML文件，包含以下属性：

• 唯一ID唯一标识符字符串（例如， 武器.001）。
• 名称：成就的显示名称。
• 背景故事：简短描述或背景文本。
• 图标：游戏资源中的图标名称。
• 代币奖励： 完成成就的奖励代币。
• 需求：类型、阈值以及可选的组或预制体名称。

示例

• 击败来自生物群系的生物： 生物群成就类型 与 组 = 草甸.
• 达成里程碑（击杀、距离等）：设置 需求类型 至相关属性。
• 收集某一类型的所有物品（鱼、武器、奖杯等）：使用基于收集的类型。

提示

• 服务器运行时可以添加、更改或删除文件。
• 服务器自动将成就同步到客户端。
• 阈值可以保留在 0 用于自动检测（例如鱼的总数）。
• 需要为以下内容指定 PrefabName 击杀 和 可拾取 类型。
• 收集物品 需求.预制体名称 条目格式： 预制体名称,数量;预制体名称,数量

年鉴悬赏

年鉴悬赏系统允许玩家购买悬赏契约来猎杀特殊生物。

悬赏任务定义于 .yml 内部的文件 赏金 文件夹。管理员可以在运行时添加、移除或编辑悬赏条目——更改将同步到所有客户端。

每个悬赏条目可以定义：

• 唯一ID：悬赏任务的唯一标识符（例如， 巨魔.001）。
• 生物目标生物预制体名称（例如， 巨魔, 蛇）
• 名称：（可选）自定义名称覆盖；如果为空，将使用生成的名称。
• 图标: 赏金杯的精灵图或图标。
• 生物群系：赏金将生成的生物群系（草甸, 沼泽, 灰烬之地等等）。
• 生命值：覆盖悬赏的最大生命值。
• 等级：生物等级（影响难度）。
• 伤害倍率： 应用于悬赏目标攻击的倍率（例如， 1.5）。
• 图鉴代币奖励：完成赏金任务后获得的代币。
• 背景故事：在年鉴面板中显示的简短描述。
• 花费购买悬赏所需的物品或代币要求。

笔记

• 消耗可以是 年鉴代币 或普通物品（例如， 金币）。
• 如果悬赏目标消失或逃脱，费用将退还。
• 悬赏任务设有可配置的冷却时间（默认以分钟为单位）。

提示

• 你可以重新装填或编辑 .yml 服务器运行时更新悬赏文件；更改会自动同步。
• 接受悬赏后，地图上会标记出对应位置。
• 默认悬赏包括 野猪，脖颈，巨魔，蛇，憎恶，幽灵，洛克，追寻者蛮兵，堕落女武神.
• 使用 背景故事 为每次狩猎讲述一个简短的故事或背景文本。

示例条目

唯一ID：Troll.001 生物：巨魔 名称：森林潜行者 图标：TrophyFrostTroll 生物群系：黑森林，沼泽 生命值：1200 等级：3 伤害倍率：1.5 图鉴代币奖励：5 背景故事：“巨魔在黑森林中笨重穿行，它的脚步撼动大地，将沿途一切碾碎。” 费用：金币：10

年鉴商店

年鉴商店允许玩家购买临时增益、资源和物品。

商店物品定义于 .yml 其中的文件 商店 文件夹。管理员可以在游戏运行时添加、删除或修改商店条目。

每个商店条目可以定义：

• 名称商店物品名称。
• 背景故事：提示框中显示的简短描述。
• 图标显示的精灵名称。
• 费用：任选其一 年鉴代币 或其他物品作为支付。
• 状态效果： 购买时可选择应用的效果。
• 物品：给予玩家的可选奖励（如资源或装备）。
• 必需按键 购买物品需要可选密钥

示例

名称：洛丽特 费用： 物品： - 预制名：年鉴代币 数量：100 图标：蓝宝石 物品： - 预制名：蓝宝石 数量：1 品质：1 变体：0 背景故事：光芒在这颗宝石上锐利地反射 所需钥匙：焦黑_近战_迪恩温

笔记

• 年鉴令牌 是默认商店货币。
• 消耗品也可以是常规物品（例如 木头, 金币）。
• 状态效果必须与ObjectDB中的有效ID匹配。
• 物品条目需要有效的预制体名称和数量。
• 必需按键 应该是 预制体ID of creature, to check if player has killed at least one

提示

• 使用 lore 解释该商店物品的作用。
• 你可以重新装填或编辑 .yml 运行时加载文件；商店会自动更新。
• 当选择商店标签页时，年鉴面板将刷新。

自定义状态效果

你可以使用 Almanac 自定义状态效果管理器创建新的状态效果。

以下是可用的修饰符类型：

护甲	攻击耐力修正	格挡耐力修正	钝击伤害
钝击抗性	负重	切割伤害	砍伐抗性
伤害修正	伤害减免	闪避耐力修正	埃特尔
以太恢复修正	坠落伤害修正	火焰伤害	火焰抗性
冰霜伤害	冰霜抗性	生命值	生命恢复修正
体力道具修改器	跳跃耐力修正	吸血	闪电伤害
闪电抗性	最大下落速度	噪声修正	镐伤害
镐抗性	穿刺伤害	穿刺抗性	毒素伤害
毒素抗性	提升技能	体力消耗修正	斩击伤害
斩击抗性	潜行耐力修正	速度	精神伤害
精神抗性	体力	耐力恢复修正	游泳耐力修正
风移动修正	风行耐力修正

每个修饰符占用一个 浮点数 用于定义效果强度的值。

• 有些人喜欢 负重 是累加的。
• 其他大多是乘数。

提示

• 你可以在游戏内创建、删除或编辑文件，以实时预览提示框。
• 年鉴还为管理员内置了创建工具。
• 只有房主可以添加状态效果，其他所有人都会从房主那里获取数据
• 如果你是管理员，可以使用创建工具来定义你的状态效果文件，然后将该文件上传到你的服务器。

寻宝

年鉴让你可以自定义寻宝活动，使用 .yml TreasureHunt 文件夹中的文件。这些宝藏会在服务器和客户端之间同步，并在编辑时动态重新加载。

寻宝会在互动地图上创建标记，当你到达指定地点时便会生成战利品容器。玩家可以使用年鉴商店系统中的代币购买寻宝。

核心属性

• 名称寻宝活动的显示名称（例如“草甸秘藏”）。
• 背景故事显示给玩家的描述性风味文本。
• 图标：游戏资源中的图标名称（未指定时默认为“map”）。
• 生物群系：目标生物群系，宝藏将在此生成（见上方列表）。

费用系统

• 花费：购买此寻宝所需的代币/物品字典。
  • 使用 年鉴令牌 作为年鉴代币的密钥。
  • 示例： 消耗：{ "AlmanacToken": 10 } 获得10个代币。

战利品配置

• 战利品：可在宝箱容器中找到的物品列表。
  • 物品物品的预制体名称（例如"Coins"、"SilverOre"）。
  • 最小最小堆叠数量。
  • 最大最大堆叠数量。
  • 重量：掉落概率权重（数值越高，掉落几率越大）。

示例宝藏文件

名称：山间秘藏 背景：唯有勇攀嶙峋峭壁之人，方能揭开群山深藏的秘密。 图标：地图 生态：山地、平原 消耗：年鉴令牌：1 战利品： - 物品：银矿石 最少：10 最多：20 权重：1.0 - 物品：狼爪 最少：1 最多：20 权重：1.0 - 物品：邪教徒战利品 最少：1 最多：1 权重：1.0

对话系统

年鉴提供了一个全面的NPC对话系统，使用 .yml Dialogues 文件夹中的文件。这些对话会在服务器和客户端之间同步，并在文件被编辑时动态重新加载。

以下是可用的 指令类型 你可以使用：

• 退出：关闭对话
• 给予：将物品添加到玩家库存中
• 拿取：从玩家背包中移除物品
• 传送将玩家传送至指定位置
• 飞向: 女武神将玩家飞送到指定位置
• 地图标记：在地图上添加临时标记
• 开始赏金：开始悬赏
• 取消悬赏：取消当前赏金任务
• 完成赏金：悬赏奖励
• 开始寻宝： 开始寻宝
• 取消宝物取消进行中的寻宝活动
• 打开图鉴：打开图鉴面板
• 打开物品：打开图鉴物品页
• 开片：打开图鉴碎片标签页
• 打开生物图鉴：等等。
• 打开成就
• 打开商店
• 打开排行榜
• 未完成的悬赏
• 打开宝藏
• OpenMetrics
• 开启抽奖

对话文件结构

每个对话定义为一个YAML文件，包含以下属性：

• 唯一ID一个唯一标识符字符串（例如， npc.intro.001）。
• 标签：这个对话选项显示的按钮文本。
• 文本满足条件时显示的主要对话文本。
• 替代文本未满足要求时显示的替代文本。
• 对话：作为选项可用的对话ID列表。
• 动作：使用标签和参数执行的命令。
• 需求与该对话互动必须满足的条件。

动作指令

面板命令: 打开图鉴, 打开物品, 生物图鉴等，打开特定UI面板。

物品指令:

• 给： 给予玩家物品。参数： 物品名称，数量，品质？，变体？ ? = 可选
• 拿取从玩家那里拿走物品。参数格式相同。
• 3.7.93 更新说明：可以使用分号来给予或拿取多个物品

位置指令:

• 传送：立即传送玩家。参数： X，Y，Z
• 地图标记：添加临时地图标记。参数： X、Y、Z、标签、时长（秒）

活动指令:

• 开始赏金：开始赏金追猎。参数： 赏金ID
• 开始寻宝开始寻宝。参数： 宝藏ID
• 取消悬赏/取消宝物：取消进行中的狩猎。（若无进行中的狩猎则不会显示）

API命令

• 发放年鉴经验值：提供图鉴经验。参数 数量 - 已录制对话
• 发放搞怪经验：给予EpicMMO经验值。参数 数量 - 录制对话

需求系统

使用以下方式控制对话的可用时机：

• 按键玩家必须拥有特定的游戏钥匙（击败首领等）
• 非按键：玩家必须没有特定按键
• 击杀： 所需生物击杀数。格式： 生物名称，数量；另一生物，数量
• 未击杀玩家不得击杀的生物
• 成就： 必需成就 ID（以逗号分隔）
• 未达成成就：玩家不得拥有的成就
• 对话：所需对话ID（由 给 或 拿取 操作)
• 非对话：必需的 NOT 对话 ID
• 任务：需要已接受的任务。格式： 任务1,任务2
• 未完成任务： 必需任务从未接受
• 已完成任务：所需任务已完全完成
• 未完成的委托：所需任务未完全完成

文本特性

替代文本使用 替代文本 在未满足要求时显示不同的消息。

条件显示根据以下条件，对话会自动显示不同文本：

• 玩家是否拥有所需物品（用于Take命令）
• 玩家是否已领取奖励（用于发放命令）
• 是否满足条件

示例

基础对话:

UniqueID: npc.greeting Label: 你好啊 Text: 欢迎来到我们的村庄，旅行者！ Dialogues: - npc.ask_directions - npc.ask_trade Action: Type: Exit Label: 再会

物品交易:

唯一ID：npc.trade_sword 标签：我需要一把武器 文本：给，带上这把铁剑上路吧。 替代文本：我已经给过你一把剑了，记得吗？ 动作：类型：给予 标签：拿取剑 参数：铁剑，1，2，0 需求：击杀：赤血灵鹿，1

位置标记:

唯一ID：npc.mark_cave 标签：最近的洞穴在哪里？文本：北边有一个洞穴系统。我来帮你标记一下。动作：类型：地图标记 标签：标记洞穴 参数：100, 25, -150, 神秘洞穴, 180 // (3min)

基于需求的对话:

唯一ID：npc.veteran_talk 标签：跟我说说那些首领吧 文本：你已经证明了自己能对抗远古的邪恶！ 需求：已击杀：赤血灵鹿，1；gd_king，1 钥匙：defeated_bonemass

组织技巧

• 使用描述性的唯一ID，例如 商人.武器.介绍
• 按NPC类型或位置整理文件
• 使用以下内容创建对话树 对话 列表
• 使用文件夹分隔不同区域或故事线

技术说明

• 服务器运行时可以添加、更改或删除文件
• 服务器自动将对话同步到客户端
• 地图标记在设定的延迟秒数后消失
• 给予/获取命令自动防止重复交易
• 需求会实时检查

NPC

NPC可通过以下方式自定义： 管理员 在 免费 模式

随机对话

此外，你可以为每个NPC设置随机对话，在玩家靠近或离开时触发，或者每分钟触发一次。

YML 文件已同步，可在游戏过程中重新加载。

NPC动画

铁枪	阿特吉尔副手	附着阿斯克文	洛克斯
挂载桅杆	安装飞船	附着坐舰	安装王座
斧	斧副手	战斧	战斧副手
飞吻	格挡	弓	瞄准
弓火	挑战	加油	过来
畏缩	蹲伏	弩	弩箭射击
哭	跳舞	绝望	闪避
喝	双轴	副武器双斧	双刀
双持短刃副手	吃	负重	装备头部
装备于腰侧	装备中	弹性	钓鱼竿
鱼竿抛出	锻造	GPower	巨剑
巨剑副手	锤	甩头	锄头
在水中	交互	踢	刀
副武器刀	下跪	击倒	笑
次级锤	不不不	镐	放置盛宴
点	放松	闪电法杖充能	休息
咆哮	收割	耸肩	坐下
坐下	大锤	蓄力攻击	员工充电
解雇火球	闪电杖	rapid fire 员工	护盾员工
召唤员工	员工巨魔召唤	硬直	搅拌
停止	剑	剑副手	点赞
投掷炸弹	投掷长矛	吐司	卸下副武器
徒手	波次

任务系统

年鉴任务系统允许玩家接取自定义任务，追踪在英灵神殿中各种活动的进度。
任务定义于 .yml 内部文件 任务 文件夹，并在服务器与客户端之间同步。当文件被添加、编辑或删除时，更改会动态重新加载。

任务系统设计为与对话系统配合使用，使用命令： 开始任务, 取消任务, 完成任务 与任务互动。

笔记

• 只有玩家从未开始过该任务时，才能开始此任务
• 任务只能在激活状态下取消
• 任务完成后仍保持激活状态（即保留完成记录），这意味着在使用对话要求时： 任务 或 未完成任务 正在检查任务是否曾被接取过。
• 只有进度达到要求时才能完成任务
• 所有这些行为都体现在对话系统中。如果不满足那些条件，可交互按钮将不会作为选项显示。

核心属性

每个任务文件可以定义：

• 唯一ID：唯一标识符字符串（例如， 001.蒲公英）。
• 名称任务显示名称。
• 类型：任务类型（见下方列表）。
• 预制体名称任务的目标预制体（例如， 野猪, 蒲公英, 焰核）。
• 预制体名称 （可选）用于收集或学习任务的预制体列表。
• 阈值完成任务所需数量。

任务类型

收集	农场	采集	击杀
学习物品	我的

示例任务

唯一ID：001.BoarHunt 名称：猎杀野猪 类型：击杀 预制体名称：野猪 阈值：10

此任务需要玩家猎杀10头野猪。当玩家击杀目标预制体时，进度会自动追踪。

笔记

• 任务可在游戏内动态开始、取消或完成。
• 进度会保存到玩家档案中，并在重新连接时恢复。
• 任务会从服务器同步到客户端。
• 多个任务可同时进行。
• 界面将显示进行中的任务，可使用配置的快捷键隐藏
• 任务历史可在数据标签页查看

提示

• 使用“收集”用于基于物品的任务（例如， 燃烧核心）。
• 采集用于可拾取的任务物品，如蒲公英或蘑菇（例如， 可拾取的蒲公英）。
• 使用农场种植作物（例如， 胡萝卜种子）。
• 使用 LearnItems 创建探索任务，玩家必须从多个物品中学习配方。
• 阈值定义需要多少进度（击杀、物品、采集等）。