All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Simple Shulker Preview

Simple Shulker Preview

by BVengo • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

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.

An inventory filled with shulkers that have an item displayed on them.

For other download pages, please see CurseForge or Modrinth.

Dependencies

This mod requires YetAnotherConfigLib (YACL) v3 to manage configurations, and ModMenu to access the config screen in-game.

Configs

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

The visual config screen

Option Description
Preview Selection Logic Decides which item in the container should be displayed based on position or quantity.
Icon Based on Container Name Provides options to display an icon based on custom-named containers.
Preview Icon Position & Size Adjust the x and y offsets of the icon, as well as scale (general, stacked, or bundle).
Show Capacity Bar Toggle the capacity bar, indicating how full the container is.
Capacity Bar Options Set the position, size, orientation, and shadow of the capacity bar.
Thresholds to Show Preview Icon Set minimum limits for the number of items/slots required to display an icon.
Preview Icons on Bundles / Modded Toggle compatibility modes for Bundles, other container items, etc.
Enable Mod Globally enables or disables all preview icons and capacity bars.

When using custom named shulkers, you need to name it using the same conventions required for spawning in items. For example, naming a shulker minecraft:grass_block (or simply grass_block) will display a grass block. If an invalid name has been given, it will continue to follow the 'Preview Selection Logic' configuration (unless 'Icon Based on Container Name' has been set to 'Hide Icons Unless Named', of course).

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.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3
Fabric
17h ago 1
26.2 26.1.x
Fabric
17h ago 1
1.21.11
Fabric
17h ago 1
1.21.x
Fabric
17h ago 1
1.21.x
Fabric
17h ago 1
1.21.6
Fabric
17h ago 1
1.21.5
Fabric
17h ago 1
1.21.4
Fabric
17h ago 1
1.21.x
Fabric
17h ago 1
1.21.x
Fabric
17h ago 1
1.20.x
Fabric
17h ago 1
1.20.x
Fabric
17h ago 1
1.20.2
Fabric
17h ago 1
1.20.x
Fabric
17h ago 1
1.19.4
Fabric
17h ago 1
1.19.3
Fabric
17h ago 1
1.18.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
1.19.x
Fabric
17h ago 1
Updated for MC 26.3! This update comes with some huge UI changes, thanks to the great work of @mfishma.

## What's Changed

## New Contributors

Updated for Minecraft 26+!

A huge thanks to @MordorsElite and @mnowak32 for putting this update together, and the rigorous testing you put into it.

  • Changes**

There are no user-facing changes - this update is primarily to bring it up to date with the latest minecraft versions. However the mod has been transferred across to use the new minecraft mod bindings.

Minecraft also requires that Java 25 be used for MC26+.
Updated for 1.21.11!

No new changes to be reported.
Updated for 1.21.9 and 1.21.10!!

Thanks to @weihx15 for the new Simplified Chinese translations.
Updated to 1.21.7!

Thanks to [@theendercore](https://github.com/theendercore) for putting together this update.
[2.4.8] 2.4.8 by BVengo on Oct 15, 2026
Download
Updated for 1.21.6!

Due to changes in the rendering engine, I've had to temporarily remove the z offset option. Unfortunately this means that the capacity bar is rendered on top of the item preview (if overlapping).

In the interest of providing this update sooner rather than later, I'll be deferring that fix for a later version (if necessary).
Finally, the 1.21.5 update! Apologies for the delay, my PC blew up on me.

Changes:
  • Potion types are now distinct from each other, so item quantity and position filters will now work with them properly
  • The counting of items is now fixed, which means the capacity bar is working properly for items that stack to less than 64
  • Coloured bundles are now supported

The config UI rewrite is still in the works, but will have to wait for a future update still :) I'll try to backport all bugfixes to older versions of MC when that update becomes available.
Finally, updated for 1.21.4!

Mostly just a versioning update, however a bug was also fixed that caused named shulkers to stop rendering their icons, if the name did not correspond to a valid item ID.

Updated to 1.21!

Sorry for the delay on this one, I was on my honeymoon. There are on feature changes; simply a versioning update.
Updated to 1.20.5!

Since the last release, I've opened up a [Discord server](https://discord.gg/gyTa5v7kKk) so you can discuss my mods and get updates when new releases are made available.

This is primarily just a version update, however the following changes have been made:
  • The Custom Name feature has been added, resolving #28. This allows you to name your container with a minecraft ID (e.g. minecraft:grass_block) and have it display instead of the container contents (if you wish). Thanks to @Boden-C for their initial work on this one.
  • Removed support for recursive shulkers. This was a feature that wasn't requested but I had added in for better compatibility. Since 1.20.5 required a rewrite of all the code and I haven't seen anybody using this feature, it has been removed until requested back.

On the technical side of things, the update to 1.20.5 broke a lot of the underlying code due to their change to the components system.
  • Near-total rewrite of item rendering
  • Complete rewrite of display item selection (leading to the removal of recursive support)
  • Change of internal naming conventions to use 'container' as a more generalised term

I hope you enjoy the changes!
No changes! Updated to 1.20.3 / 1.20.4.
[2.4.1] 1.20.2 by BVengo on Oct 15, 2026
Download
Updated for minecraft 1.20.2!
This is a fairly sizeable update, enough to increment a version!

  • New Features**
  • The config is now a lot cleaner, with dropdown sections for position options
  • There is now a bar indicating the capacity of shulker boxes. This is enabled by default, so the default item displays have also been moved.
  • Added support for displaying icons on bundles
  • Added a minimum stack size filter, calculated as stack size * stack count

  • Changes**
Thanks to @Wyne10 on GitHub, we have now updated to 1.20!

Note that, due to the significant changes made to the internal MC code, I will likely no longer be porting new changes to older MC versions anymore.
[2.3.1] 1.19.4 - v2.3.1 by BVengo on Oct 15, 2026
Download
Only internal changes in this release, for compatibility with Minecraft 1.19.4.

Update notes:
  • ItemRenderer function signatures has changed
[2.2] 1.19.3 - v2.2 by BVengo on Oct 15, 2026
Download
Only internal changes in this release, for compatibility with Minecraft 1.19.3.

Update notes:
  • the ItemRender now uses the float-based translate function instead of the old double function
[2.1] 1.18.x v2.1 by BVengo on Oct 15, 2026
Download
First release for 1.18.x. Let me know if there are any complications with mod dependencies, since it's had a lot less testing than the 1.19 version.
[2.1] 1.19 - 1.19.2 v2.1 by BVengo on Oct 15, 2026
Download
Bug fixes:
  • Shulkers in creative menu crashed, since they contain no nbt data
  • Empty recursive shulkers crashed, due to no nbt data
  • Mixing recursive shulkers with stacked shulkers didn't properly multiply the internal itemStacks
  • Last release name was invalid for modpacks and Windows
[2.0] 1.19.* v2.0 by BVengo on Oct 15, 2026
Download
This new release adds a few configs to work with functionality from other mods:

  • Custom head support
  • Recursive shulker support
  • Stacked shulker support
[1.19.1-v1.0] 1.19.*-v1.0 by BVengo on Oct 15, 2026
Download
Yet another release! I can't think of any more configs or changes to add for now...

  • Merge the 'Unique' config into the Display Item options instead of being standalone
  • Add 'Most' and 'Least' to the Display Item options (feature request #3 )
  • Add scale and offset configs (feature request #4 ) - send me better values if you can find them!
[1.19-v1.3] 1.19-v1.3 by BVengo on Oct 15, 2026
Download
A bigger update this time! This mod is evolving quickly during the early period, but I expect it to slow down soon.

This mod adds configuration options with the Cloth Config API, accessible via Mod Menu.

  • Disable mod
  • Display on shulkers with unique items only
  • Choose to display either the first or last, for compatibility with mods that allow you to build directly out of them.

[1.19-v1.2] 1.19 v1.2 by BVengo on Oct 15, 2026
Download
Updated modid.mixins.json to reflect actual modid, simpleshulkerpreview. This prevents clashes with other mods where the developer also happened to forget this simple little thing.
[1.19-v1.1] 1.19 by BVengo on Oct 15, 2026
Download
First release!
Simple Shulker Preview Icon
Download Simple Shulker Preview
Select game version
Select platform