ModernTabs

Minecraft 版本： 1.21.1

平台： fabric

It is a library mod that adds a cross-platform solution for customzing any creative tab even further than what is currently possible on both NeoForge and Fabric.
ModernTabs makes it possible to add individual sections with an assigned banner, change the scrollbar sprite, modify the tab icon background sprite and adds an option for using any sprite as a tab icon.
The idea for the creative tab banners comes from the Create Aeronautics/Simulated mod and therefore includes portions of its code.

Example Creative Tab

This example creative tab is only enabled in the development enviroment. That means it will not show up in a regular modpack.

For Developers

How to use ModernTabs in your own mod (Setup):

You have to define this in your build.gradle file:

repositories {
    maven {
        name = "Jitpack"
        url 'https://jitpack.io'
    }
}

dependencies {
  // Required: contains the common module used on both platoforms and therefore most of this mod's code
  modImplementation("com.github.Roboter007.ModernTabs:ModernTabs-common:${rootProject.moderntabs_version}")

  // Optional: contains the Fabric specific module
  modImplementation("com.github.Roboter007.ModernTabs:ModernTabs-fabric:${rootProject.moderntabs_version}")

  // Optional: contains the NeoForge specific module
  modImplementation("com.github.Roboter007.ModernTabs:ModernTabs-neoforge:${rootProject.moderntabs_version}")
} 

Then you can define this in your gradle.properties file:

// for the latest version:
moderntabs_version=v1.2.0

What you need to do in order to implement the creative tab banners correctly in your mod:

// The TabIconBackground class combines any possible state of the tab icon background 
// It uses the default vanilla sprite if it doesn't find a sprite in the given location
// the sprites for the icon background has to be located under textures/gui/sprites/creative_inventory/
// the sprite file for the icon background depends on: tab_tabIdentifer_row_column_selectionState.png
// example file name: tab_example_top_left_selected.png
TabIconBackground exampleTabBackgrounds = new TabIconBackground(ExampleMod.MOD_ID, "example"); // example is the tabIdentifier

ModernTabs.builder(EXAMPLE_TAB)
        // makes it possible for the defined creative tab to use custom sections
        .withEnabledSections(true)
        // changes the tab icon background sprite in any given state
        .withCustomTabIconBackground(exampleTabBackgrounds)
        // displays a sprite instance of an regular Minecraft item.
        // the sprite for the custom icon has to be located under textures/gui/sprites/
        .withCustomTabIcon(ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, "example_icon"))
        // changes the sprite for the scrollbar
        // the scrollbar for the custom icon has to be located under textures/gui/sprites/
        .withCustomScroller(ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, "example_scroller"));

// this defines which items are included in which section
// for creating a section you need to define a json file in your assets folder (scroll down a little, if you want to know how create a section)
SectionedItems.addItem(ExampleItems.EXAMPLE_ITEM, ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, "example_section"));

// hide a debug item from the grid but keep it searchable
TabItemTransforms.setVisibility(MyItems.DEBUG_STICK, TabItemTransforms.VisibilityType.SEARCH_ONLY);

In order for the creative tab sections to work properly, you need to create one JSON file for each creative tab section you want to have.
These json files have to be in the location: assets/mymod/moderntabs/sections/example_section.json and the defined section in your code has to match one json file in this location.

Example JSON file:

{
  "priority": 0,
  "title": {
    "text": { "translate": "itemGroup.example_mod.basics" },
    "color": "#FFFFFF",
    "background": "#AA000000"
  },
  "sprite": "example_mod:basics_banner",
  "only_animate_on_hover": false
}

FAQ

Why another such mod that adds creative tab banners?

➔ I created this library so I can use it for some upcoming mods by me and therefore, I need both a supported NeoForge and Fabric version. Additionly, I plan on adding some more features in the future.

Will the Minecraft version x be supported?

➔ I will not backport it. If anyone plans on doing it, feel free to do it and if you want, you can create a pull request on GitHub. I might update it to newer versions in the future (but I will not guarantee it).

Bugs & Feature Requests

Please report any bugs you encounter or feature requests on the linked GitHub.

Credits

• Thank you to the Create Aeronautics/Simulated mod team and contributors for creating such a great mod.