特殊能力实用工具（SPU）

特殊能力管理工具可为模组玩家与模组作者提供分类功能，将【特殊物品与能力】选项卡按模组来源划分。您可清晰查看各模组新增的能力，并将其与基础游戏能力分开管理。同时，该工具为模组作者新增了游戏状态查询、标记符及触发动作等接口，助您突破原有能力系统的开发限制。

请注意 特殊能力实用工具并非旨在作为添加更复杂、更高级能力的框架。虽然我很希望能实现这一点，但由于能力系统的运作方式及其与游戏代码的集成需求，要制作更复杂的能力，你很可能仍需自行钻研C#语言。如果将来我能找到办法，让仅使用Content Patcher的模组作者也能更轻松地实现这一目标，我会尽力将其纳入，但这无法保证。本模组旨在为模组玩家提供一个（希望是）更美观的特殊物品与能力选项卡，并让模组作者在制作简单能力时稍微省心一些。

安装

• 安装最新版本的SMAPI.
• 将模组解压至 Stardew Valley/Mods 文件夹。
• 使用 SMAPI 运行游戏。
  

玩家使用说明
安装此模组后，当前的【特殊物品与能力】标签页将替换为支持分类的新版本。若你已安装其他添加特殊物品或能力的模组，其内容将自动归入左侧独立的新类别中，与游戏原版能力区分开。每个添加特殊物品或能力的模组都会拥有专属分类。* 不限制类别数量。若模组未专门支持“特殊能力工具”，则会为其分配一个图标使用。无论其他模组是否支持“特殊能力工具”，解锁能力的方式都不会改变；唯一的变化在于查看能力时的显示方式。

*有可能。见下方配置部分。


内容补丁模组作者使用说明
请点击此处查看文档。

C# 模组作者使用说明
请点击此处查看API文档。

设置
特殊能力工具包提供四项配置选项，详情如下。建议使用通用模组配置菜单在游戏中调整这些数值。

• 启用分类： 自解释性说明。若禁用此选项，你的特殊物品与能力标签页左侧将不会显示任何模组分类，已模组的特殊物品和能力也不会移动位置。所有特殊物品和能力（无论是否经过模组修改）都将归入常规的特殊物品与能力标签页，其显示效果与未安装模组时几乎无异。模组作者可用的后台功能仍将正常运行。
  

• ParseModNames： 解析模组名称 若模组遵循其特殊物品与能力的标准命名规则（即特殊物品和能力ID以模组ID为前缀，例如“Example.PowerMod_Power_One”），但未主动适配特殊能力工具且模组作者未指定分类，则特殊能力工具将尝试从这些ID中解析模组名称，以便将模组追加的特殊物品与能力自动归入正确分类。按照上述示例，若启用此选项，您将在特殊物品与能力页面的左侧看到一个名为“Example.PowerMod”的分类，带有随机分配的图标，其中会显示“Power_One”能力。若禁用此选项，特殊能力工具将不会按上述方式解析模组名称，而是将所有未分类的模组特殊物品或能力统一归入“其他”分类。
  

• 启用杂项分类： 若禁用，特殊能力工具将不会将任何未分类的、模组添加的特殊物品或能力纳入其中。
  杂项类。不过，这些特殊物品和能力将被归入默认的「星露谷物语」类别中——该类别存放原版游戏中的能力，相当于你未安装「特殊能力工具」时的默认状态。如果模组自身指定了分类，模组添加的特殊物品和能力仍会被归入对应类别。启用分类已启用。

• 使用原版菜单 启用后，此模组提供的特殊物品与能力标签将完全不会加载。无法使用的能力将无法与可使用的能力区分开，但除此之外模组功能将正常运行。若你使用的其他模组需要编辑特殊物品与能力标签并导致冲突，建议开启此项。
  

• 无条纹之书 是否移除“读书”动画中书封面与封底上的两条浅色条纹。开启后，动画中的书本将使用纯色且无条纹。
  

模组兼容性
特殊能力工具应与任何添加自定义特殊道具或能力的模组兼容，但该模组会完全替换菜单中的“特殊道具与能力”选项卡（即便禁用了分类功能），因此如果有其他模组也替换了同一菜单，则两者无法兼容。如有需要，您可以启用“使用默认菜单”选项，切回标准菜单界面。部分功能可能不会显示，但仍会保持可用状态。

翻译
如果您愿意帮忙翻译这个模组，请注意该模组内的翻译文件（以及 唯一 翻译文件（而非整个模组本身）依据以下条款进行许可： MIT 许可证. 将译文提交给我以纳入模组，即表示您理解您的译文将同样遵循上述许可条款进行授权。请点击链接了解该许可授予他人的权利与权限。若您不同意译文按此条款授权，欢迎您自行在Nexus上传译文模组，从而保留对译文的所有权利。

如何提交翻译： 理想情况下，你可以在下方源代码链接中找到我的Github并提交拉取请求。但如果你不熟悉Github的操作，或不想按这种方式处理，请在模组页面的论坛板块发布一个包含你翻译内容的帖子。如果模组中已存在对应语言的.json文件，所有需要翻译的文本前都会标记"/* TODO */"。若没有现有文件，则需要你自行创建该文件。

源代码