LapisCore — NBT Crafting Library for Minecraft

LapisCore is a datapack library for Minecraft that adds an NBT-aware crafting table, preserving item data in recipes. Learn installation and usage.

Download LapisCore for Minecraft 1.14.1

Original name: LapisCore

Minecraft: 1.14.1

FileVersionLoaderSize
LapisCore v0.1.zip1.14.1—28 КБDownload
LapisCore v0.2.zip1.14.1—28 КБDownload
LapisCore.zip1.14.1—31 КБDownload

LapisCore: NBT-Preserving Crafting for Minecraft

Vanilla Minecraft crafting has a hard limitation: when you combine items, all their hidden data—enchantments, durability, stored contents, custom names—gets wiped clean. For players building complex contraptions or modpack authors designing intricate progression systems, this is a constant frustration. LapisCore: NBT-Preserving Crafting for Minecraft steps in as a specialized datapack library that fundamentally changes how item data flows through the crafting process. Rather than being a standalone content mod, it operates as a backend engine, providing the structural foundation that other datapacks rely on to implement recipes that respect NBT tags.

Understanding the Core Purpose

LapisCore is best described as a central hub or a development framework for custom Minecraft datapacks. It does not add new biomes, mobs, or dimensions. Instead, it delivers a universal platform for creating items with unique, data-rich properties through a dedicated crafting interface. Many community-made datapacks depend on this core to function correctly because it handles the complex logic of NBT-aware crafting behind the scenes. Without this engine, those add-ons would either fail to load or produce incorrect results.

NBT tags are the invisible backbone of item persistence in Minecraft. They store everything from enchantment levels and tool durability to the inventory of a shulker box or the lore text on a weapon. The standard crafting table discards all of this information during the crafting operation. LapisCore addresses this shortcoming directly, allowing creators to design systems where the properties of ingredients carry over into the final product.

The NBT-Preserving Workbench

The heart of this datapack is a modified crafting interface called the Workbench. This special block functions similarly to a standard crafting table but with one critical difference: it preserves NBT tags from the ingredients and transfers them to the output item. Imagine combining a highly enchanted sword with a rare material to upgrade its base stats. In vanilla, that process would strip away all your carefully applied enchantments. With the LapisCore Workbench, those enchantments survive the transition intact, making the upgrade process meaningful and rewarding.

For datapack developers, this opens up a vast design space. The archive includes a folder named data/lockbox, which serves as a practical integration example. By studying its contents, any author can learn how to hook their own datapack into the LapisCore system and create recipes that demand specific NBT characteristics from their ingredients. This means you can require an item to have a particular enchantment level, a specific custom name, or a certain damage value before it can be used in a recipe.

Version Compatibility and Loader Requirements

Before integrating this tool into your setup, it is essential to check version compatibility. LapisCore: NBT-Preserving Crafting for Minecraft does not currently support Minecraft version 1.15.x. The developer has explicitly stated this limitation and has indicated that a patch for that version is in the works. If you are running a server or a single-player world on 1.15, it is advisable to hold off on installation until the update arrives. For other versions, both older and newer, the datapack generally functions without issues.

As a datapack, LapisCore does not require a mod loader like Forge or Fabric. It runs natively on the vanilla game engine, which makes it lightweight and highly compatible. However, you should still verify that it does not conflict with any other datapacks or mods you have installed, especially those that modify crafting mechanics. The architecture is designed to minimize conflicts, but a quick compatibility check before deployment is always a prudent step.

Installation and Initial Setup

Installing LapisCore is a straightforward process that mirrors the standard procedure for any datapack. To get started, you will need to download LapisCore: NBT-Preserving Crafting for Minecraft from the project page. Once you have the archive file, navigate to the datapacks folder inside your world directory. Place the downloaded archive there, then either reload the world or execute the /reload command. The game will automatically detect the new datapack and activate its functions.

For those who prefer a more streamlined approach, you can also install this datapack through the foxygame.net launcher. This modern Minecraft launcher allows you to download mods and datapacks directly from its interface, eliminating the need for manual file management. This is particularly useful when you want to quickly test multiple add-ons without navigating your file system repeatedly.

In addition to the datapack itself, you will need to install a companion resource pack called Lapis Resources. This pack is available on the same project page and is required for the Workbench block and its interface elements to render correctly. Without it, you may encounter missing textures or visual glitches. The resource pack is installed through the standard game settings menu, just like any other texture pack.

Creating the NBT-Preserving Workbench

Once the datapack and resource pack are active, you need to craft the special Workbench. The recipe is specific and requires the following arrangement:

  • Top row: Lapis Lazuli, Redstone Dust, Lapis Lazuli (L-R-L)
  • Middle row: Iron Bars, Smithing Table, Iron Bars (I-S-I)
  • Bottom row: Empty

In this layout, L represents Lapis Lazuli, R is Redstone Dust, I stands for Iron Bars, and S is the Smithing Table. When you place these items in the correct pattern, you will obtain the functional Workbench block. This block then serves as the gateway to all NBT-preserving crafting operations within your world.

Building on the LapisCore Framework

The true potential of this tool is realized when it is paired with other datapacks created by the same developer or by community members who have adopted the framework. Any add-on that declares LapisCore as a dependency automatically gains access to the NBT-aware crafting system. The developer only needs to define a recipe in the appropriate format and specify the required tags; LapisCore handles all the underlying logic.

For those interested in creating their own datapacks on top of this core, comprehensive documentation is included within the archive. The data/lockbox directory contains example code that demonstrates recipe structures, methods for specifying NBT conditions, and the format for output items. Even a novice developer can grasp the fundamentals within a couple of evenings of study. The examples are well-commented and provide a clear starting point for experimentation.

Community Support and Testing

The developer maintains an active presence in the community and offers support through a dedicated Discord server. This is the primary channel for reporting bugs, requesting integration assistance, or engaging in discussions with other users. If you encounter an issue, you can also test the datapack on a public server hosted by the author at mc.relapis.uk. This allows you to experience the mechanics firsthand before committing to an installation on your personal world.

When submitting a bug report, it is helpful to provide as much detail as possible. Clearly describe the steps that led to the problem and confirm that the issue is indeed related to LapisCore rather than a conflict with another modification. Thorough reports enable the developer to diagnose and fix problems more efficiently, benefiting the entire user base.

Why LapisCore Matters

LapisCore: NBT-Preserving Crafting for Minecraft fills a significant gap in the vanilla game. The ability to preserve item data through crafting is a feature that players have requested for years, and this datapack delivers it with minimal resource overhead. It does not clutter the game with unnecessary entities or mechanics; instead, it provides a clean, efficient foundation that other add-ons can build upon.

If you are assembling a custom modpack or developing your own datapacks, this tool deserves serious consideration. It acts as the connective tissue that binds together disparate crafting systems, enabling a level of depth and customization that vanilla Minecraft simply cannot offer. Whether you are a server administrator looking to enrich the player experience or a solo player who enjoys tinkering with game mechanics, understanding how to install and use LapisCore will expand your creative possibilities significantly.

The path to advanced crafting in Minecraft is paved with tools that respect the data behind every item. LapisCore is one such tool, and it stands ready to become the backbone of your next ambitious project.