简易访问按钮

简易访问按钮

来自不同模组的背包按钮都想占据背包旁边的同一个位置,结果互相遮挡。Easy Access Buttons 将它们排成一列,包括社区中心按钮和整理按钮。可以从齿轮菜单中重新排序或隐藏其中任意一个。模组通过 API 添加按钮时,它会占用下一个单元格,而不是自己独占一个位置。

[heading]每个物品栏按钮都有一列专属位置[/heading]

添加物品栏按钮的模组都瞄准了背包旁边的同一位置,因此按钮会相互遮挡。Easy Access Buttons 为它们在物品栏页面右侧边缘提供了共享的一列。

该列已包含社区中心按钮和整理。额外的按钮会依次向下填充该列,然后是第二列,接着是第三列。当按钮过多无法容纳时,列下方的箭头可滚动浏览它们。列下方的 [b]...[/b] 按钮会打开一个菜单,你可以在其中重新排序或隐藏任意按钮。垃圾桶仍保留在第一列下方。

此模组可独立运行。未安装其他模组时,该列包含社区中心按钮、整理和齿轮。

[list]
[]Stardew Valley 1.6.14 或更高版本[/]
[]SMAPI 4.1.0 或更高版本[/]
[/list]
[heading]自行加入该列的模组[/heading]

这些模组会调用 API。安装 Easy Access Buttons 后,它们的按钮会与其他按钮对齐。如果不安装 Easy Access Buttons,每个模组会保留其原有的按钮。

[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/53287]Perfection Shortcut[/url][/b][/size]
作者:Yadm

在齐先生的核桃房解锁后,物品栏按钮会打开游戏的完美度追踪器。安装 Easy Access Buttons 后,它会加入此列。
[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/53092]Guild Kill List[/url][/b][/size]
作者:Yadm

在你到达矿井第 100 层后,马龙会写信给你。访问公会,怪物消灭列表便会添加到你的物品栏中。安装 Easy Access Buttons 后,该按钮会加入此列。
[line]

[heading]通过本页可选文件移动的模组[/heading]

这些模组不调用 API。每个模组仍会绘制自己的按钮,而本页的可选文件会将那个按钮移入该列。只需为你使用的模组下载对应的补丁。Easy Access Buttons 主文件不需要其中任何一个,且这些补丁之间也互不依赖。

[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/10384]Convenient Inventory[/url][/b][/size]
作者:gaussfire

快速堆叠至附近箱子会移入该列。请安装可选文件 [b]Easy Access Buttons for Convenient Inventory[/b]。当按钮被隐藏或滚动离开时,快捷键仍可快速堆叠。箱子菜单会保持 Convenient Inventory 放置的位置。
[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/17265]Unlockable Bundles[/url][/b][/size]
作者:DeLiXx

收集包总览按钮会移入该列。请安装可选文件 [b]Easy Access Buttons for Unlockable Bundles[/b]。Unlockable Bundles 仍会绘制图标、处理点击并显示其悬停提示。
[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/43127]UI Info Suite 2 Alternative[/url][/b][/size]
作者:DazUki

日历、告示板、特别订单和齐先生特别订单图标会移入该列,每个图标都使用与其他按钮相同的按钮背景。请安装可选文件 [b]Easy Access Buttons for UI Info Suite 2 Alternative[/b]。此文件适用于 DazUki 的 Alternative 版本。Annosz 的原始 UI Info Suite 2 是另一个模组,此文件不会更改它。当图标被隐藏或滚动离开时,快捷键仍会打开那些面板。书商和罗宾的图标会保留在 HUD 上。
[line]
[size=4][b][url=https://www.nexusmods.com/stardewvalley/mods/51900]Qi's Perfection and Completion Tracker[/url][/b][/size]
作者:peterbot0

齐钻按钮会移入该列。请安装可选文件 [b]Easy Access Buttons for Qi's Perfection Tracker[/b]。当按钮被隐藏或滚动离开时,快捷键仍会打开追踪器。追踪器菜单会保持 Qi's Perfection and Completion Tracker 放置的位置。
[heading]

供模组作者参考[/heading]
你的模组无需引用 Easy Access Buttons.dll。将下面的接口复制到你自己的项目中。该接口必须是 public,且不能嵌套在其他类中。在 [b]GameLaunched[/b] 时,向 SMAPI 请求它:

[code]
var api = this.Helper.ModRegistry.GetApi<IEasyAccessButtonsApi>("Yadm.EasyAccessButtons");
if (api is null)
return;[/code]
Null 表示此模组未安装。有两种方式列出依赖项。

当你的按钮只在列中才有意义时,使用 [b]IsRequired true[/b]。没有 Easy Access Buttons,SMAPI 将不会加载你的模组。

[code]
"Dependencies": [
{ "UniqueID": "Yadm.EasyAccessButtons", "IsRequired": true }
][/code]
当你的模组应仍能独立加载时,使用 [b]IsRequired false[/b]。当 [b]GetApi[/b] 返回 null 时,保留你原有的按钮。

[code]
"Dependencies": [
{ "UniqueID": "Yadm.EasyAccessButtons", "IsRequired": false }
][/code]
[heading]添加一个由本模组绘制的按钮[/heading]

[b]AddButton[/b] 注册一个按钮。Easy Access Buttons 会绘制它、显示工具提示、播放选择音效并运行你的点击操作。相同的 id 会替换之前的注册。空 id 会被忽略。

[code]
public interface IEasyAccessButtonsApi
{
void AddButton(string id, int order, Texture2D texture, Rectangle sourceRect, int iconSize, Func<bool> isVisible, Func<string> tooltip, Action onClick);
void RemoveButton(string id);
void Reserve(string id, int order, Func<bool> isVisible);
void Reserve(string id, int order, Func<bool> isVisible, Func<string> name, Texture2D? icon, Rectangle sourceRect);
Rectangle GetBounds(string id);
}[/code]
[code]
api.AddButton(
id: "tracker",
order: 0,
texture: Game1.mouseCursors,
sourceRect: new Rectangle(346, 400, 8, 8),
iconSize: 32,
isVisible: () => this.Config.Enabled,
tooltip: () => this.Helper.Translation.Get("button.tooltip"),
onClick: this.OpenTracker);[/code]
[list]
[][b]id[/b] 在你的模组内唯一。它存储为你的 UniqueID、一个斜杠和该 id。[/]
[][b]order[/b]:数字越小,位置越靠前,直到玩家重新排列列表。相同数字按 id 排序。社区中心按钮和整理使用比普通模组按钮更小的数字,因此你的按钮从它们下方开始。[/]
[][b]iconSize[/b] 是 64 像素单元格内图标的像素大小。[/]
[][b]isVisible[/b] 在每次布局时检查。False 会从列中移除按钮并合拢空隙。该行仍会保留在齿轮菜单中,呈灰色,并注明你的模组正在隐藏它。[/]
[][b]tooltip[/b] 是悬停文本。空值则不绘制工具提示。[/]
[][b]onClick[/b] 在选择音效之后运行,此时物品栏菜单仍处于打开状态。不要再次播放该音效。光标上有物品时的点击会留给游戏处理。[/]
[]要打开另一个菜单,请关闭物品栏菜单,并在下一个 tick 打开下一个菜单。[/]
[]玩家的保存顺序会被保留。本模组之前未见过的按钮会添加到该列表末尾,直到玩家移动它。齿轮菜单中的重置会清除保存的列表。[/]
[][b]RemoveButton[/b] 移除你添加或预留的按钮。[/]
[/list]
[heading]移动一个你的模组仍会绘制的按钮[/heading]

当你的模组已有物品栏按钮,并且应继续自行绘制、点击和显示工具提示时,请使用此方式。[b]Reserve[/b] 占用一个单元格。Easy Access Buttons 不会绘制该图标。较长的 [b]Reserve[/b] 还会提供齿轮菜单名称和图标。空的源矩形表示使用整个纹理。

物品栏页面完成布局后,[b]GetBounds[/b] 会返回该单元格。当按钮被隐藏、滚动离开或页面尚未布局时,它会返回空矩形。将该矩形写入你自己的控件。使用与传给 [b]Reserve[/b] 相同的 id。当矩形为空时,将控件停放到页面之外,以免它留在旧位置。不要再次绘制图标。

[code]
api.Reserve(
id: "overview",
order: 30,
isVisible: () => true,
name: () => "Bundle Overview",
icon: this.Icon,
sourceRect: new Rectangle(0, 0, 61, 56));

Rectangle cell = api.GetBounds("overview");[/code]