Shelf Numbers

Displays the quantity of items on shelves

437 Downloads

fabricneoforgeutility

Rent Server with this Mod

Screenshots

Item counts shown on a variety of shelves

About this Mod

Shelf Numbers

This mod allows you to easily see the quantity of items placed in shelves. It is only for the client-side and will work on any single-player world or server (provided they send the correct packets for shelves). Additionally, it will also work for any modded shelf that correctly registers itself as a ShelfBlockEntity.

Image showing the item counts on a shelf

Config

Using the config, you can change several aspects of how the mod renders the text. The config can be accessed by using Mod Menu and Cloth Config API or by editing the JSON file at config/shelf_numbers.json

Bugs?

You can submit bugs here: https://github.com/Illusioner2520/Shelf-Numbers/issues

Available Versions

Shelf Numbers 0.0.5beta

MC 26.2neoforge

June 19, 2026

Shelf Numbers 0.0.5beta

MC 26.2fabric

June 19, 2026

Shelf Numbers 0.0.4beta

MC 26.1, 26.1.1, 26.1.2neoforge

March 26, 2026

Shelf Numbers 0.0.4beta

MC 26.1, 26.1.1, 26.1.2fabric

March 26, 2026

Shelf Numbers 0.0.3beta

MC 1.21.10, 1.21.11neoforge

February 2, 2026

How to Install Shelf Numbers on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).

Install Mod

Open the mod browser in the dashboard and search for "Shelf Numbers". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricneoforge

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+4 more)

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Shelf Numbers server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.

Is Shelf Numbers compatible with fabric and neoforge?

Shelf Numbers officially supports fabric, neoforge for Minecraft 26.2, 26.1.2, 26.1.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Shelf Numbers – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Shelf Numbers consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.