Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Fields
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
net.fabricmc.fabric.api.blockrenderlayer.v1.BlockRenderLayerMap.putItem(Item, RenderLayer)	For blocks, calling BlockRenderLayerMap.putBlock(Block, RenderLayer) is enough. Other items always use a translucent render layer.
net.fabricmc.fabric.api.blockrenderlayer.v1.BlockRenderLayerMap.putItems(RenderLayer, Item...)	For blocks, calling BlockRenderLayerMap.putBlocks(RenderLayer, Block...) is enough. Other items always use a translucent render layer.
net.fabricmc.fabric.api.lookup.v1.custom.ApiLookupMap.create(ApiLookupMap.LookupFactory<L>)	ApiLookupMap.LookupConstructor should be used instead of lookup factory, to expose the identifier.
net.fabricmc.fabric.api.lookup.v1.custom.ApiLookupMap.LookupFactory	ApiLookupMap.LookupConstructor should be used instead as it also passes the identifier.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.EMPTY_BUCKET	Replaced with ConventionalItemTags.EMPTY_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.LAVA_BUCKET	Replaced with ConventionalItemTags.LAVA_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.MILK_BUCKET	Replaced with ConventionalItemTags.MILK_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.WATER_BUCKET	Replaced with ConventionalItemTags.WATER_BUCKETS.
net.fabricmc.fabric.api.transfer.v1.context.ContainerItemContext.withInitial(ItemVariant, long)	Use ContainerItemContext.withConstant(ItemVariant, long) instead.
net.fabricmc.fabric.api.transfer.v1.context.ContainerItemContext.withInitial(ItemStack)	Use ContainerItemContext.withConstant(ItemStack) instead.
net.fabricmc.fabric.api.transfer.v1.storage.base.FilteringStorage.exactView(TransactionContext, T)
net.fabricmc.fabric.api.transfer.v1.storage.Storage.exactView(TransactionContext, T)	Use and implement the overload without the transaction parameter.

Deprecated Interfaces

Interface	Description
net.fabricmc.fabric.api.block.BlockAttackInteractionAware	Use AttackBlockCallback instead and check for the block. This gives more control over the different cancellation outcomes.
net.fabricmc.fabric.api.client.keybinding.KeyBindingRegistry	Please migrate to v1. Please use KeyBindingHelper instead.
net.fabricmc.fabric.api.client.model.ModelAppender	use ExtraModelProvider, which supports loading of plain Identifiers
net.fabricmc.fabric.api.client.render.ColorProviderRegistry	Replaced by ColorProviderRegistry
net.fabricmc.fabric.api.client.render.InvalidateRenderStateCallback	Replaced by InvalidateRenderStateCallback
net.fabricmc.fabric.api.client.rendereregistry.v1.BlockEntityRendererRegistry	This module has been moved into fabric-rendering-v1. Use BlockEntityRendererRegistry instead
net.fabricmc.fabric.api.client.rendereregistry.v1.EntityModelLayerRegistry.TexturedModelDataProvider
net.fabricmc.fabric.api.client.rendereregistry.v1.EntityRendererRegistry	This module has been moved into fabric-rendering-v1. Use EntityRendererRegistry instead
net.fabricmc.fabric.api.client.rendereregistry.v1.LivingEntityFeatureRendererRegistrationCallback	This module has been moved into fabric-rendering-v1. Use LivingEntityFeatureRendererRegistrationCallback instead
net.fabricmc.fabric.api.client.rendereregistry.v1.LivingEntityFeatureRendererRegistrationCallback.RegistrationHelper	This module has been moved into fabric-rendering-v1. Use LivingEntityFeatureRendererRegistrationCallback.RegistrationHelper instead
net.fabricmc.fabric.api.client.rendering.v1.BuiltinItemRenderer	Please use BuiltinItemRendererRegistry.DynamicItemRenderer instead.
net.fabricmc.fabric.api.client.screen.ContainerScreenFactory	Use ScreenRegistry.Factory instead.
net.fabricmc.fabric.api.client.screen.ScreenProviderRegistry	Use ScreenRegistry instead.
net.fabricmc.fabric.api.command.v1.CommandRegistrationCallback	Please migrate to v2. Please use CommandRegistrationCallback instead.
net.fabricmc.fabric.api.container.ContainerFactory	Use ScreenHandlerRegistry.ExtendedClientHandlerFactory instead.
net.fabricmc.fabric.api.container.ContainerProviderRegistry	Use ScreenHandlerRegistry instead.
net.fabricmc.fabric.api.entity.event.v1.ServerPlayerEvents.AllowDeath	Use the more general ServerLivingEntityEvents.ALLOW_DEATH event instead and check for instanceof ServerPlayerEntity.
net.fabricmc.fabric.api.event.client.ClientTickCallback
net.fabricmc.fabric.api.event.client.ItemTooltipCallback	Please use ItemTooltipCallback
net.fabricmc.fabric.api.event.client.player.ClientPickBlockCallback	0.3.0
net.fabricmc.fabric.api.event.network.C2SPacketTypeCallback	Please migrate to S2CPlayChannelEvents since this was incorrectly named.
net.fabricmc.fabric.api.event.network.S2CPacketTypeCallback	Please migrate to C2SPlayChannelEvents since this was incorrectly named.
net.fabricmc.fabric.api.event.server.ServerStartCallback
net.fabricmc.fabric.api.event.server.ServerStopCallback
net.fabricmc.fabric.api.event.server.ServerTickCallback
net.fabricmc.fabric.api.event.world.WorldTickCallback
net.fabricmc.fabric.api.lookup.v1.custom.ApiLookupMap.LookupFactory	ApiLookupMap.LookupConstructor should be used instead as it also passes the identifier.
net.fabricmc.fabric.api.loot.v1.event.LootTableLoadingCallback	Replaced with LootTableEvents.
net.fabricmc.fabric.api.loot.v1.event.LootTableLoadingCallback.LootTableSetter
net.fabricmc.fabric.api.loot.v1.FabricLootPool	Replaced with transitive access wideners in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.loot.v1.FabricLootSupplier	Replaced with transitive access wideners in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.loot.v1.LootEntryTypeRegistry	Use Registry.LOOT_POOL_ENTRY_TYPE from vanilla instead.
net.fabricmc.fabric.api.network.ClientSidePacketRegistry	Please migrate to ClientPlayNetworking.
net.fabricmc.fabric.api.network.PacketConsumer	See the corresponding play packet handler in ClientPlayNetworking or ServerPlayNetworking
net.fabricmc.fabric.api.network.PacketContext
net.fabricmc.fabric.api.network.PacketRegistry
net.fabricmc.fabric.api.network.ServerSidePacketRegistry	Please migrate to ServerPlayNetworking.
net.fabricmc.fabric.api.registry.LootEntryTypeRegistry	Use LootEntryTypeRegistry
net.fabricmc.fabric.api.screenhandler.v1.ScreenHandlerRegistry.ExtendedClientHandlerFactory	Replaced with ExtendedScreenHandlerType.ExtendedFactory.
net.fabricmc.fabric.api.screenhandler.v1.ScreenHandlerRegistry.SimpleClientHandlerFactory	Replaced by access widener for invalid @link ScreenHandlerType.Factory in Fabric Transitive Access Wideners (v1).

Deprecated Classes

Class	Description
net.fabricmc.fabric.api.client.keybinding.FabricKeyBinding	Please migrate to v1. Please use KeyBindingHelper.registerKeyBinding(KeyBinding) instead.
net.fabricmc.fabric.api.client.keybinding.FabricKeyBinding.Builder
net.fabricmc.fabric.api.client.rendereregistry.v1.EntityModelLayerRegistry	This module has been moved into fabric-rendering-v1. Use EntityModelLayerRegistry instead.
net.fabricmc.fabric.api.client.rendering.v1.BlockEntityRendererRegistry	Replaced with transitive access wideners in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.client.screenhandler.v1.ScreenRegistry	Replaced by access wideners for HandledScreens.register(ScreenHandlerType, HandledScreens.Provider) and invalid @link HandledScreens.Provider in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.event.client.player.ClientPickBlockCallback.Container
net.fabricmc.fabric.api.loot.v1.FabricLootPoolBuilder	Replaced with FabricLootPoolBuilder.
net.fabricmc.fabric.api.loot.v1.FabricLootSupplierBuilder	Replaced with FabricLootTableBuilder.
net.fabricmc.fabric.api.loot.v1.LootJsonParser	Use LootGsons.getTableGsonBuilder() from vanilla instead.
net.fabricmc.fabric.api.object.builder.v1.advancement.CriterionRegistry	Replaced by access widener for Criteria.register(Criterion) in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.object.builder.v1.client.model.FabricModelPredicateProviderRegistry	Replaced by access wideners for ModelPredicateProviderRegistry registration methods in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.object.builder.v1.villager.VillagerProfessionBuilder	Replaced by access widener for VillagerProfession(java.lang.String, java.util.function.Predicate<net.minecraft.util.registry.RegistryEntry<net.minecraft.world.poi.PointOfInterestType>>, java.util.function.Predicate<net.minecraft.util.registry.RegistryEntry<net.minecraft.world.poi.PointOfInterestType>>, com.google.common.collect.ImmutableSet<net.minecraft.item.Item>, com.google.common.collect.ImmutableSet<net.minecraft.block.Block>, net.minecraft.sound.SoundEvent) in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.object.builder.v1.villager.VillagerTypeHelper	Replaced by access wideners for VillagerType.create(java.lang.String) and VillagerType.BIOME_TO_TYPE in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.registry.CommandRegistry	Please migrate to v2. Please use CommandRegistrationCallback instead.
net.fabricmc.fabric.api.screenhandler.v1.ScreenHandlerRegistry	Replaced by Creating simple screen handler types directly with ScreenHandlerType using an access widener in Fabric Transitive Access Wideners (v1) Creating extended screen handler types with ExtendedScreenHandlerType Registering using Registry.SCREEN_HANDLER directly
net.fabricmc.fabric.api.server.PlayerStream	Please use PlayerLookup instead.
net.fabricmc.fabric.api.util.NbtType	Use the constants in NbtElement instead.

Deprecated Fields

Field	Description
net.fabricmc.fabric.api.entity.event.v1.ServerPlayerEvents.ALLOW_DEATH	Use the more general ServerLivingEntityEvents.ALLOW_DEATH event instead and check for instanceof ServerPlayerEntity.
net.fabricmc.fabric.api.event.client.ClientSpriteRegistryCallback.EVENT	Use the ClientSpriteRegistryCallback.event(Identifier) registration method. Since 1.14 started making use of multiple sprite atlases, it is unwise to register sprites to *all* of them.
net.fabricmc.fabric.api.event.client.ClientTickCallback.EVENT	Please use ClientTickEvents.END_CLIENT_TICK.
net.fabricmc.fabric.api.event.client.ItemTooltipCallback.EVENT
net.fabricmc.fabric.api.event.client.player.ClientPickBlockCallback.EVENT
net.fabricmc.fabric.api.event.network.C2SPacketTypeCallback.REGISTERED	Please migrate to C2SPlayChannelEvents.REGISTER.
net.fabricmc.fabric.api.event.network.C2SPacketTypeCallback.UNREGISTERED	Please migrate to C2SPlayChannelEvents.UNREGISTER.
net.fabricmc.fabric.api.event.network.S2CPacketTypeCallback.REGISTERED	Please migrate to S2CPlayChannelEvents.REGISTER.
net.fabricmc.fabric.api.event.network.S2CPacketTypeCallback.UNREGISTERED	Please migrate to S2CPlayChannelEvents.UNREGISTER.
net.fabricmc.fabric.api.event.server.ServerStartCallback.EVENT	Please use ServerLifecycleEvents.SERVER_STARTED
net.fabricmc.fabric.api.event.server.ServerStopCallback.EVENT	Please use ServerLifecycleEvents.SERVER_STOPPING
net.fabricmc.fabric.api.event.server.ServerTickCallback.EVENT	Please use ServerTickEvents.END_SERVER_TICK
net.fabricmc.fabric.api.event.world.WorldTickCallback.EVENT	The new WorldTickCallback has been split into a client and server callback. Please use the server or client callbacks.
net.fabricmc.fabric.api.registry.LootEntryTypeRegistry.INSTANCE
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.EMPTY_BUCKET	Replaced with ConventionalItemTags.EMPTY_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.LAVA_BUCKET	Replaced with ConventionalItemTags.LAVA_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.MILK_BUCKET	Replaced with ConventionalItemTags.MILK_BUCKETS.
net.fabricmc.fabric.api.tag.convention.v1.ConventionalItemTags.WATER_BUCKET	Replaced with ConventionalItemTags.WATER_BUCKETS.

Deprecated Methods

Method	Description
net.fabricmc.fabric.api.blockrenderlayer.v1.BlockRenderLayerMap.putItem(Item, RenderLayer)	For blocks, calling BlockRenderLayerMap.putBlock(Block, RenderLayer) is enough. Other items always use a translucent render layer.
net.fabricmc.fabric.api.blockrenderlayer.v1.BlockRenderLayerMap.putItems(RenderLayer, Item...)	For blocks, calling BlockRenderLayerMap.putBlocks(RenderLayer, Block...) is enough. Other items always use a translucent render layer.
net.fabricmc.fabric.api.client.itemgroup.FabricItemGroupBuilder.stacksForDisplay(Consumer<List<ItemStack>>)	use FabricItemGroupBuilder.appendItems(Consumer)
net.fabricmc.fabric.api.client.keybinding.FabricKeyBinding.getBoundKey()
net.fabricmc.fabric.api.client.model.ModelAppender.appendAll(ResourceManager, Consumer<ModelIdentifier>)
net.fabricmc.fabric.api.client.model.ModelLoadingRegistry.registerAppender(ModelAppender)	Use ModelLoadingRegistry.registerModelProvider(ExtraModelProvider) instead, which supports loading of plain Identifiers
net.fabricmc.fabric.api.client.rendering.v1.BuiltinItemRendererRegistry.register(ItemConvertible, BuiltinItemRenderer)	Please use BuiltinItemRendererRegistry.register(ItemConvertible, DynamicItemRenderer) instead.
net.fabricmc.fabric.api.client.rendering.v1.BuiltinItemRendererRegistry.register(Item, BuiltinItemRenderer)	Please use BuiltinItemRendererRegistry.register(ItemConvertible, DynamicItemRenderer) instead.
net.fabricmc.fabric.api.client.rendering.v1.WorldRenderContext.BlockOutlineContext.vertexConsumer()	Use WorldRenderContext.consumers() directly.
net.fabricmc.fabric.api.event.client.ClientSpriteRegistryCallback.registerBlockAtlas(ClientSpriteRegistryCallback)	Use the ClientSpriteRegistryCallback.event(Identifier) registration method.
net.fabricmc.fabric.api.lookup.v1.custom.ApiLookupMap.create(ApiLookupMap.LookupFactory<L>)	ApiLookupMap.LookupConstructor should be used instead of lookup factory, to expose the identifier.
net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSettings.lightLevel(int)	Please use FabricBlockSettings.luminance(int).
net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSettings.lightLevel(ToIntFunction<BlockState>)	Please use FabricBlockSettings.luminance(ToIntFunction).
net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSettings.materialColor(MapColor)	Please migrate to FabricBlockSettings.mapColor(MapColor)
net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSettings.materialColor(DyeColor)	Please migrate to FabricBlockSettings.mapColor(DyeColor)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.Living.trackable(int, int)	use FabricEntityTypeBuilder.Living.trackRangeBlocks(int), FabricEntityTypeBuilder.Living.trackedUpdateRate(int) and FabricEntityTypeBuilder.Living.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.Living.trackable(int, int, boolean)	use FabricEntityTypeBuilder.Living.trackRangeBlocks(int), FabricEntityTypeBuilder.Living.trackedUpdateRate(int) and FabricEntityTypeBuilder.Living.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.Mob.trackable(int, int)	use FabricEntityTypeBuilder.Mob.trackRangeBlocks(int), FabricEntityTypeBuilder.Mob.trackedUpdateRate(int) and FabricEntityTypeBuilder.Mob.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.Mob.trackable(int, int, boolean)	use FabricEntityTypeBuilder.Mob.trackRangeBlocks(int), FabricEntityTypeBuilder.Mob.trackedUpdateRate(int) and FabricEntityTypeBuilder.Mob.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.trackable(int, int)	use FabricEntityTypeBuilder.trackRangeBlocks(int), FabricEntityTypeBuilder.trackedUpdateRate(int) and FabricEntityTypeBuilder.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.entity.FabricEntityTypeBuilder.trackable(int, int, boolean)	use FabricEntityTypeBuilder.trackRangeBlocks(int), FabricEntityTypeBuilder.trackedUpdateRate(int) and FabricEntityTypeBuilder.forceTrackedVelocityUpdates(boolean)
net.fabricmc.fabric.api.object.builder.v1.trade.TradeOfferHelper.refreshOffers()	This never did anything useful.
net.fabricmc.fabric.api.registry.LootEntryTypeRegistry.register(LootPoolEntry.Serializer<?>)
net.fabricmc.fabric.api.renderer.v1.material.MaterialFinder.blendMode(int, RenderLayer)	Use BlendMode version instead.
net.fabricmc.fabric.api.renderer.v1.mesh.MutableQuadView.fromVanilla(int[], int, boolean)	Use MutableQuadView.fromVanilla(BakedQuad, RenderMaterial, Direction) which has better encapsulation and removed outdated item flag
net.fabricmc.fabric.api.renderer.v1.render.RenderContext.fallbackConsumer()	Prefer using the more flexible RenderContext.bakedModelConsumer().
net.fabricmc.fabric.api.resource.conditions.v1.DefaultResourceConditions.blockTagsPopulated(TagKey<Block>...)	Use DefaultResourceConditions.tagsPopulated(net.minecraft.tag.TagKey<T>...) instead.
net.fabricmc.fabric.api.resource.conditions.v1.DefaultResourceConditions.fluidTagsPopulated(TagKey<Fluid>...)	Use DefaultResourceConditions.tagsPopulated(net.minecraft.tag.TagKey<T>...) instead.
net.fabricmc.fabric.api.resource.conditions.v1.DefaultResourceConditions.itemTagsPopulated(TagKey<Item>...)	Use DefaultResourceConditions.tagsPopulated(net.minecraft.tag.TagKey<T>...) instead.
net.fabricmc.fabric.api.resource.ResourceManagerHelper.addReloadListener(IdentifiableResourceReloadListener)	Use ResourceManagerHelper.registerReloadListener(IdentifiableResourceReloadListener)
net.fabricmc.fabric.api.resource.ResourceManagerHelper.registerBuiltinResourcePack(Identifier, String, ModContainer, boolean)	Please use ResourceManagerHelper.registerBuiltinResourcePack(Identifier, ModContainer, ResourcePackActivationType) instead, the sub path should be removed in a future release in favor of the identifier path.
net.fabricmc.fabric.api.screenhandler.v1.ExtendedScreenHandlerType.create(int, PlayerInventory)	Use ExtendedScreenHandlerType.create(int, PlayerInventory, PacketByteBuf) instead.
net.fabricmc.fabric.api.screenhandler.v1.ScreenHandlerRegistry.registerExtended(Identifier, ScreenHandlerRegistry.ExtendedClientHandlerFactory<T>)	Replaced with creating an ExtendedScreenHandlerType manually and registering it in the vanilla registry.
net.fabricmc.fabric.api.screenhandler.v1.ScreenHandlerRegistry.registerSimple(Identifier, ScreenHandlerRegistry.SimpleClientHandlerFactory<T>)	Replaced by access widener for ScreenHandlerType(ScreenHandlerType.Factory) in Fabric Transitive Access Wideners (v1).
net.fabricmc.fabric.api.transfer.v1.context.ContainerItemContext.withInitial(ItemVariant, long)	Use ContainerItemContext.withConstant(ItemVariant, long) instead.
net.fabricmc.fabric.api.transfer.v1.context.ContainerItemContext.withInitial(ItemStack)	Use ContainerItemContext.withConstant(ItemStack) instead.
net.fabricmc.fabric.api.transfer.v1.storage.base.FilteringStorage.exactView(TransactionContext, T)
net.fabricmc.fabric.api.transfer.v1.storage.Storage.exactView(TransactionContext, T)	Use and implement the overload without the transaction parameter.
net.fabricmc.fabric.api.transfer.v1.transaction.Transaction.getCurrentUnsafe()	Only use if you absolutely need it, there is almost always a better way.

Deprecated Constructors

Constructor	Description
net.fabricmc.fabric.api.gamerule.v1.rule.DoubleRule(GameRules.Type<DoubleRule>, double, double, double)	You should not be calling this constructor!
net.fabricmc.fabric.api.gamerule.v1.rule.EnumRule(GameRules.Type<EnumRule<E>>, E, E[])	You should not be calling this constructor!
net.fabricmc.fabric.api.gamerule.v1.rule.EnumRule(GameRules.Type<EnumRule<E>>, E, Collection<E>)