/simple-shulker-preview

A minecraft fabric mod that displays a configurable icon indicating the contents of a shulker box, as well as a capacity bar.

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

This is a fork of BVengo/simple-shulker-preview
The reason for this fork is to implement the feature in issue #28

Simple Shulker Preview

GitHub license GitHub release GitHub issues

Simple Shulker Preview is a small fabric mod that displays an icon indicating the contents of a shulker. This icon appears on top of the shulker icon in inventory slots.

Example image

For other download pages, please see CurseForge or Modrinth.

Dependencies

This mod requires ModMenu to adjust the configs. The Cloth Config API mod is embedded - you don't need to download it yourself.

Configs

I won't go through all the configs, since they've increased over time. A brief overview is as follows:

Option Description
Display Item Decides which item in the shulker should be displayed based on position or quantity.
Icon Positions Modify the x and y offsets of the icon, as well as scale.
Capacity Bar Display a capacity bar, indicating how full the shulker box is
Bar Position Set the position, size, and direction the capacity bar is drawn.
Stack Limits Set minimum limits for the number of items required to display an icon
Enable ... Option to enable additional features, such as bundles or recursive shulker support
Disable Mod Disables the mod so that overlay icons are not displayed.

Mod Compatibility

The following features have been tested for compatibility and work with this mod. Mods with these functionalities should also work, however I can't promise anything.

  • Bundles (can show the icon on bundles too)
  • Custom heads (treats them as individual items rather than a single player head)
  • Recursive shulkers (shulkers stored in shulkers)
  • Stacked shulkers (full / empty shulkers that are stacked together)
  • Variable shulkers sizes

The following mods were used in testing:

Mod Feature
Carpet Essential Addons Stacked shulkers
Reinforced Shulker Boxes Mod Variable sized shulkers
MicroCutting Custom Heads
HeadIndex Custom Heads
JustMobHeads Custom Heads
MoreMobHeads Custom Heads
Player Head Drops Custom Heads
All Mob Heads Custom Heads
Forgotten... Need a new mod. Recursive shulkers

Contributing

Contributions and suggestions are always welcome! Please limit all issues to only one feature at a time - feel free to open multiple at once if you have many ideas. Similarly, please limit pull requests to a single feature at a time and try to follow the existing code style.

To further discuss or get notifications of new updates, check out my Discord. If you like what I do, consider supporting me on Ko-Fi! ko-fi