Overview
Simple Shops Fix is a lightweight utility mod designed to resolve a specific functional error within the Simple Shops plugin. And it operates exclusively on the server side, meaning players don't need to install it on their clients to benefit from the correction. The mod targets Minecraft version 1.20.1 and requires the Forge mod loader to function. It's licensed under the GNU Lesser General Public License v3.0 only.
The Problem
The original Simple Shops mod contains a bug where shop blocks fail to enforce the configured maximum stack size when the shop owner retrieves items. And this oversight can lead to inconsistent inventory behavior, as the system ignores the standard limits applied to other players or contexts. The maintainers of the original mod haven't addressed this issue, and because the original project is under an All Rights Reserved license, direct code contributions or pull requests aren't an option for external developers.
How It Works
To address this limitation, Simple Shops Fix employs a mixin-based approach. This technique allows the mod to inject a small patch into the existing code of Simple Shops without modifying the original files directly. The specific patch targets the logic used during item retrieval by the owner, ensuring that the maximum stack size is correctly applied. And this method was chosen specifically because the original mod's licensing prevents standard collaborative fixes. The fix is narrow in scope; it doesn't alter shop pricing, currency mechanics, or any other features of Simple Shops. It solely corrects the stack-size check during the retrieval process.
Compatibility and Requirements
This mod is strictly compatible with Minecraft 1.20.1 and the Forge mod loader. But it is marked as server-side required, while client-side installation is unsupported and unnecessary. If you are not running Simple Shops, this mod will have no effect on your server. It doesn't support other Minecraft versions or alternative mod loaders such as Fabric. Look, users should ensure their server environment matches these exact specifications to avoid compatibility issues.
Scope and Limitations
Simple Shops Fix doesn't introduce new blocks, items, or configuration options. And it is a pure bug fix with no performance enhancements or additional features. The mod is intended for server operators who have identified the stack size bug in their Simple Shops setup. If the original Simple Shops mod is updated to fix this issue upstream, or if the mod is no longer maintained, this fix may become redundant. However, until such an update occurs, this mod provides a reliable workaround for the described behavior.
