Shulker Archives

Using NBT



Using NBT Data: A Guide

Introduction

So, you've found the Archives, maybe even downloaded an NBT File or two, and are wondering how to use them.

Or maybe you know how to use them, but are curious about editing and creating your own files.

Hopefully this page will show you everything you need to know about everything NBT :)


Prerequisites

To get started with anything NBT related, you'll need a few basic mods:

  • NBT Editor ≥1.10.0 by mega12345mega
  • Pick Block Pro by Sjouwer
  • Adaptive Tooltips ≥1.1.1 by isXander
  • These three mods are absolutely essential for working with NBT, and all users of the Archives should have them.


    Using .nbt Files

    The core of the Archives: .nbt files. But how do you use them?

    If you followed the prior section, you should have the NBT Editor mod installed in your Minecraft instance.

    To use a .nbt file, open your inventory, and then drag-and-drop the .nbt file(s) on to your Minecraft screen.

    NBT Editor should automatically add the Kit or Item contained in the .nbt file into your Inventory, using the first available slot(s).


    Creating your own Kits & Items

    You've got other peoples Kits and Items, and now you want to make your own... but how can you do that?

    Well, while we can't tell you what to create, we can give you some pointers and tools to use.

    IBE Editor

    Mentioned above under 'Using SNBT', IBE Editor is one of the best mods currently available for editing Items; Whether you want to quickly adjust the Name and Lore, fiddle around with Enchantments and Attributes, or do a deep dive into the NBT Tags, IBE Editor is the mod to do it with.


    FZMM

    FZMM is a curious little mod, offering a handful of fairly niche but incredibly useful utilities.

    The most useful of its utilities for Item-making however, is the Text Format module, which offers an amazingly intricate and detailed menu to create text, while also being quite intuitive. The cherry on top? It can export your created text as Lore, Item Name, or just copy it to your clipboard!


    Your Imagination

    Many things are important in Item Making... but above all else, use your imagination. Look at other peoples kits as inspiration, not goals.

    Don't be discouraged if you don't understand all the aspects of NBT Editing, or are confused when someone mentions things like NaN Attribute Amounts or Damage Frames; It takes time to learn about the intricacies of NBT Editing.

    Remember, if you ever have questions, feel free to ask on The Shulker Archives Discord server; Even if someone here doesn't know the answer, we'd be more than happy to help find the answer.

    Be sure to check out our Resources page, as it contains many Mods, Sites and External Tools useful for NBT Editing.


    Storing Kits & Items

    You now have obtained Kits and Items from the Archives, and hopefully created your own... but now how can you save them?

    NBT Editor's Client Chest

    The best way to store items at the time of writing, is via NBT Editor's Client Chest feature.

    To access it, either run the command /clientchest or click on the new Chest icon in the lower left of your inventory screen.

    Add or Remove whatever items you wish, and close it by pressing Esc or clicking on the Chest Icon again.

    That's it! The items in the chest are now accessible whenever you access it, and the best part is the chest is available everywhere; You can add items in single-player and bring them to a server, or vice versa!


    Exporting Kits & Items

    There are two main ways to export your Kits and Items, each specific to what format you're exporting to.

    Exporting as .nbt files

    The best way to export it (and the core method of these Archives) is as a .nbt file.

    To do so, you will need NBT Editor installed.

    While holding the Kit or Item you wish to export, open chat and type /nbt export file.

    Voila! It is now exported as a .nbt file, located in .minecraft/nbteditor/exported/


    Important Information

    (Click anywhere to close this overlay)



    Info:

    ⭐'s indicate kits recommended by Archivists.

    Kits in the 'Unnamed Kits' page have no official name. As such, we have given them Archivist Assigned Names (AANs). Similarly, the files are suffixed with _[AAN] to help distinguish them from Named Kits. Should we ever find a named copy of a kit there (or the Author of the kit properly name it) we will move it to the main Kits page.

    In the Item category, if an entry has "pre-X.Y.Z!" in its description, it is an item that only works in Minecraft versions prior to that. Some items have entries for pre- and post-versions, depending on how popular the item is/how complicated upgrading it is.




    Notices:

    Minecraft 1.20.0 broke Signs, and 1.20.2 will break Potions. If a Sign/Potion from a Kit does not work, please check the NBT as it likely uses the old format. We will NOT be upgrading kits to fix these issues, nor will we be marking kits that contain them. Thank you for your understanding.




    Disclaimers:

    Kadalyst is in no way responsible for how any entries were obtained, who downloads them, and how they are used. YOU are responsible for protecting the privacy of your items and the security of your server. Any and all complaints made pertaining to the privacy or use-case of an entry will be ignored. Basically: fuck you, you disingenuous dense shoe-fucker :D




    Credits:

  • Kadalyst - Archives Creator, Main Dev, Owner
  • Parsa__ - Encouraged Archives Creation, hunted new kits
  • _Win9x_ - Provided >50% of all entries, hunted down more
  • AbdulFmMicrosoft - Designed early iterations of Archives Map
  • iceyou - Alerted Archives to issues with SNBT, major help with Archives Map



  • Hotkeys:

    There are a number of hotkeys set up to make navigating the site easier.

    K Jumps to the 'Kits' table
    I Jumps to the 'Items' table
    B Jumps to the 'Books' table
    U Jumps to the 'Unnamed Kits' table
    Moves one page back in the table
    Moves one page forward in the table
    D Jumps to the newest entries in a table
    SHIFT + D Resets table to default sorting/arrangement (does not reset Tags)
    Z Opens this overlay