Simple Shulker Preview
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.

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:

| 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 |
|---|---|---|---|---|---|
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
|
R
2.4.8
|
17h ago | 1 | |||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
|
R
1.20.2
|
17h ago | 1 | |||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
| 17h ago | 1 | ||||
|
R
1.19
|
17h ago | 1 |
## What's Changed
- Implement YACL and a live preview by @mfishma in https://github.com/BVengo/simple-shulker-preview/pull/53
- Final UI bugfixes by @EvModder in https://github.com/BVengo/simple-shulker-preview/pull/54
## New Contributors
- @mfishma made their first contribution in https://github.com/BVengo/simple-shulker-preview/pull/53
- @EvModder made their first contribution in https://github.com/BVengo/simple-shulker-preview/pull/54
- Full Changelog**: https://github.com/BVengo/simple-shulker-preview/compare/v2.5.0...v2.6.0
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+.
No new changes to be reported.
Thanks to @weihx15 for the new Simplified Chinese translations.
Thanks to [@theendercore](https://github.com/theendercore) for putting together this update.
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).
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.
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 capacity colours to match bundles
- Resolved [Issue #33]([https://github.com/BVengo/simple-shulker-preview/issues/33](https://github.com/BVengo/simple-shulker-preview/issues/33)) (oversized shulker support) by adding shulker size options in the compatibility section.
- Better capacity calculations should handle non-64 stack sizes better
- Capacities are capped at 1, so filled large shulkers from other mods won't have a super long bar
Sorry for the delay on this one, I was on my honeymoon. There are on feature changes; simply a versioning update.
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 Namefeature 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!
- 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**
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.
Update notes:
- ItemRenderer function signatures has changed
Update notes:
- the ItemRender now uses the float-based translate function instead of the old double function
- 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
- Custom head support
- Recursive shulker support
- Stacked shulker support
- 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!
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.