Recipe Book Access API

Recipe Book Access 是一个简单的 API，旨在直观地为任何合成界面添加对外部物品栏访问的支持。\
它会重定向配方书功能，使其从可自定义的物品栏列表中检查和填充，而不仅仅是玩家的物品栏。

这意味着什么？

自己看看吧！
\
这是一个模组合成台通过此 API 使用自定义物品栏列表的示例，在这个特定情况下，它使用了附近箱子的所有物品栏。

这个模组_单独_无法实现上面展示的效果——如果你在寻找一个为合成台实现此功能的模组，你大概需要 Nearby Crafting 模组。

快速入门指南

如需更详细的使用指南，包括如何在你的项目环境中设置此 API，请查看此项目在 Github 上的 readme 此处。

此 API 提供了一个名为 RecipeBookInventoryProvider 的简单接口，位于 com.jomlom.recipebookaccess.api。

此接口必须由你的界面处理器类实现，只需重写一个方法（getInventoriesForAutofill()）即可实现 API 的功能。另外还有两个方法可用于更多控制。

你必须实现 getInventoriesForAutofill()，返回一个你希望配方书访问并从中合成的容器列表，默认情况下这不包括玩家的物品栏。

_代码示例：_

import com.jomlom.recipebookaccess.api.RecipeBookInventoryProvider

public class YourCraftingMenu extends AbstractCraftingMenu implements RecipeBookInventoryProvider {
    // your existing code...

    @Override
    public List<Container> getInventoriesForAutofill() {
        return yourContainersList;
    }
}

此 API 做出的假设：

• 你的界面处理器类继承自 ‘AbstractCraftingMenu’ 或其任何子类
• 你的对应界面继承自配方书界面，以便利用 Minecraft 的配方书

(_我尚未在这些假设之外进行测试_)

常见问题

• 问：我想我发现了一个问题…… \ 答：欢迎在 Github 上创建 issue，或直接通过电子邮件 “[email protected]“ 联系我。

• 问：你会发布对 _x_ 的支持吗？ \ 答：只要我有时间并且愿意，我就会确保这个模组支持最新版本，但有时我会很忙！同样，欢迎提出支持某些版本或其他模组的请求。

• 问：我的 getInventoriesForAutofill() 实现需要在客户端工作吗？ \ 答：不需要！getInventoriesForAutofill() 仅在服务端界面处理器中使用，API 会自动为你保持客户端与结果同步！