Section
开发者
共 9 个一级导航项教程：Repo API
此页面将指引开发者借助 Repo API 实现多平台存储接口。
1. 建立资源仓库 Repo
这一步将确定你要存储什么资源、怎么访问你要存的资源。
1.1 原版存储仓库 ContainerRepo<ItemSpec>
你可以借助原版的存储系统 Container 来快速开发。以下为温室方块实体的部分实现示例：
public class GreenhouseBlockEntity extends BlockEntity implements Container {
private final NonNullList<ItemStack> inventory; // Vanilla container
private final ContainerRepo repo = new ContainerRepo<>(this); // Create a repo
// example of implementing BlockEntity
@Override
protected void loadAdditional(@NonNull ValueInput input) {
super.loadAdditional(input);
ContainerHelper.loadAllItems(input, this.inventory);
}
@Override
protected void saveAdditional(@NonNull ValueOutput output) {
ContainerHelper.saveAllItems(output, this.inventory);
super.saveAdditional(output);
}
// example of implementing Container
@Override
public int getContainerSize() {
return this.inventory.size();
}
@Override
public boolean isEmpty() {
return this.inventory.stream().allMatch(ItemStack::isEmpty);
}
// ...
}1.2 自定义存储仓库 Repo<T>
你可以自行实现 Repo 接口来创建你需要的功能。
基础存储交互：
int size: 存储单元的数量boolean isEmpty: 判断仓库或指定存储单元是否为空TypeToken<T> getType: 判断存储的资源类型，详见 Resource APIT resourceFor: 获取某一个存储单元的资源种类long simConsume: 模拟抽取资源，会返回模拟实际抽取的资源数量long consume: 抽取资源，返回实际抽取的资源数量long simAccept: 模拟填入资源，会返回模拟实际填入的资源数量long accept: 填入资源，返回实际填入的资源数量long capacityFor: 查询某个资源或存储单元的最大容量long amountFor: 查询某个资源或存储单元已存储的资源数量
限制器（以下方法执行后不会影响原仓库）：
AcceptOnlyRepo<T> asAcceptOnly返回一个只可存不可取的仓库包装ConsumeOnlyRepo<T> asConsumeOnly返回一个只可取不可存的仓库包装LockedRepo<T> asLocked返回一个锁定某些存储单元的仓库包装
2. 注册仓库代理
为了让我们建立的存储仓库能够被其他存储系统安全地交互，我们需要新建一个 RepoProxy 代理包装。
public class GreenhouseBlockEntity extends BlockEntity implements Container {
private final RepoProxy<ItemSpec> proxy = RepoProxy.item(this.repo);
public RepoProxy<ItemSpec> visitItem() {
return this.proxy;
}
// ...
}注：代理类 RepoProxy 由 Croparia IF 在不同模组平台自动实例化，手动实例化 new RepoProxy<>(...) 无法正常在具体的模组平台下工作。
之后，我们将代理注册进 ProxyProvider，让存储仓库能被其他存储系统发现：
public class Greenhouse extends BaseEntityBlock {
public Greenhouse(Properties settings) {
super(settings);
ProxyProvider.registerItem(
// Query Function
(world, pos, state, be, direction) -> {
if (be instanceof GreenhouseBlockEntity gbe) {
return gbe.visitItem();
} else {
return null;
}
},
// Blocks
this
);
}
// ...
}注册后，模组平台将基于方块种类进行查询，然后执行你注册的查询函数来获取到 RepoProxy。
3. 查询其他存储仓库
你可以通过 ProxyProvider 来查找任意存储系统，并得到一个实现了 RepoProxy 接口的包装仓库。
Optional<PlatformItemProxy> itemProxy = ProxyProvider.findItem(world, pos, direction);
Optional<PlatformFluidProxy> fluidProxy = ProxyProvider.findFluid(world, pos, direction);
itemProxy.ifPresent(proxy -> {
// use proxy as a Repo<ItemSpec>
});注：由于平台差异，部分 Repo 接口方法在不同平台下存在能力差异，请查阅 PlatformItemProxy 与 PlatformFluidProxy 的接口 javadoc。
In This Page