d882b91555
This snapshot is possibly one of the most impactful for API we have ever had. This PR is an inital port to support 22w06a, stuff will be missing and broken. # Removed modules: - fabric-mining-levels-v0 - Previously deprecated - fabric-object-builders-v0 - Previously deprecated - fabric-tag-extensions-v0 - fabric-tool-attribute-api-v1 # Modules with API breaking changes: - fabric-biome-api-v1 - fabric-content-registries-v0 - fabric-data-generation-api-v1 - fabric-mining-level-api-v1 - fabric-object-builder-api-v1 - fabric-resource-conditions-api-v1 - fabric-structure-api-v1 # Impactful API changes: ### fabric-object-builder-api-v1 - Removed - FabricBlockSettings.breakByHand - Removed - FabricBlockSettings.breakByTool - Previously deprecated # Notable changes - fabric-registry-sync-v0 moves vanilla's new registry freezing to a later point in time, allowing mods to add to the registry during init. # Known issues: - ServerBugfixMixin used to fix https://bugs.mojang.com/browse/MC-195468 has not yet been ported. |
||
|---|---|---|
| .. | ||
| src | ||
| build.gradle | ||
| README.md | ||
Fabric Transfer API (v1)
This module provides common facilities for the transfer of fluids and other game resources.
Transactions
The Transaction system provides a
scope that can be used to simulate any number of transfer operations, and then cancel or validate all of them at once.
One can think of transactions as video game checkpoints. A more detailed explanation can be found in the class javadoc of Transaction.
Every transfer operation requires a Transaction parameter.
SnapshotParticipant
is the reference implementation of a "participant", that is an object participating in a transaction.
Storages
A Storage<T> is any object that can store resources of type T.
Its contents can be read, and resources can be inserted into it or extracted from it.
StorageUtil provides a few helpful functions to work with Storages,
for example to move resources between two Storages.
The storage/base package provides a few helpers to accelerate
implementation of Storage<T>.
Implementors of inventories with a fixed number of "slots" or "tanks" can use
SingleVariantStorage,
and combine them with CombinedStorage.
Fluid transfer
A Storage<FluidVariant> is any object that can store fluids. It is just a Storage<T>, where T is
FluidVariant, the immutable combination of a Fluid and additional NBT data.
Instances can be accessed through the API lookups defined in FluidStorage.
The unit for fluid transfer is 1/81000ths of a bucket, also known as droplets.
FluidConstants contains a few helpful constants
to work with droplets.
Client-side Fluid variant rendering will use regular fluid rendering by default,
ignoring the additional NBT data.
Fluids that wish to render differently depending on the stored NBT data can register a
FluidVariantRenderHandler.
Item transfer
A Storage<ItemVariant> is any object that can store items.
Instances can be accessed through the API lookup defined in ItemStorage.
The lookup already provides compatibility with vanilla inventories, however it may sometimes be interesting to use
InventoryStorage or
PlayerInventoryStorage when interaction with
Inventory-based APIs is required.
ContainerItemContext
ContainerItemContext is a context designed for ItemApiLookup queries
that allows the returned APIs to interact with the containing inventory.
Notably, it is used by the FluidStorage.ITEM lookup for fluid-containing items.