What is ModernTabs?

It is a library mod that adds creative mode tab banners which are purely for decorative purposes. This idea comes from the Create Aeronautics/Simulated mod and therefore includes portions of its code.

Example Creative Tab

This example creative tab is disabled by default and can currently only be enabled by another mod.

For Developers

You can use it in your mod by using cursemaven:

repositories {
  maven {
    name = "Cursemaven"
    url "https://cursemaven.com"
  }
}

dependency {
  // for Fabric (ModernTabs Version 1.1.2):
  modImplementation("curse.maven:moderntabs-1606742:8482853")

  // for NeoForge (ModernTabs Version 1.1.2):
  modImplementation("curse.maven:moderntabs-1606742:8482849")
}

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

// Required: Once, e.g. right after you build your tab:
ModernTabs.enableSections(MyMod.MAIN_TAB);

// Required: For every item that should be grouped:
SectionedItems.addItem(MyItems.EXAMPLE_ITEM, ResourceLocation.fromNamespaceAndPath("mymod", "example_section"));

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

// Optional: if you want to enable the example tab:
ModernTabs.setExampleTabEnabled(true);

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.mymod.basics" },
    "color": "#FFFFFF",
    "background": "#AA000000"
  },
  "sprite": "mymod:basics_banner",
  "only_animate_on_hover": false
}

Field	Type	Default	Notes
`priority`	positive int	`0`	Lower values are drawn first (higher up in the tab).
`title.text`	component	required	Any normal text/translatable component.
`title.color`	`"#RRGGBB"` / `"#AARRGGBB"`	`#FFFFFFFF`	Primary text fill color.
`title.secondary_color`	`"#RRGGBB"` / `"#AARRGGBB"`	20% darker than `title.color`	Outline/"aura" color.
`title.background`	`"#RRGGBB"` / `"#AARRGGBB"`	`#AA000000`	Background color of the pill behind the text.
`sprite`	GUI sprite ID	`moderntabs:default_banner`	A texture under `textures/gui/sprites/`, 162×18 px per animation frame.
`only_animate_on_hover`	boolean	`false`	If the sprite is animated, it will pause until the mouse hovers over the banner.

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.