
ViScriptShop
An advanced shop mod featuring a built-in visual editor and a modern shopping cart experience.
Screenshots


About this Mod
🛒 ViScriptShop - Redefine Your Trading Experience
ViScriptShop is an advanced shop mod designed specifically for Minecraft 1.21.1 NeoForge. It abandons tedious configuration files in favor of a built-in visual editor and a modern shopping cart UI. It aims to provide players with a smooth shopping experience while offering modpack creators extremely flexible customization capabilities.
✨ Core Features
🖥️ WYSIWYG Visual Editor
Say goodbye to boring code configurations! ViScriptShop features a built-in visual editor similar to game engines.
Project Management: Uses a logic that separates "Project Files (.shopproj)" from "Result Files (.shop)" to ensure development and release do not interfere with each other.
Real-time Preview: Adjust item categories, sorting, and pricing directly within the editor. Supports drag-and-drop sorting and undo history.
State Persistence: The editor supports minimization. Re-opening it does not require reloading the project, significantly boosting configuration efficiency.
🛍️ Modern Shopping Experience
Shopping Cart System: Add multiple items to the cart and checkout in one go. Clearly displays the total currency required and previews the items to be obtained.
Flexible Pricing: Supports not only traditional economy currency but also full Item Barter support.
Stage Control: Features a built-in progression Stage system, allowing you to unlock or hide specific items based on a player's game progress.
🔗 Powerful Mod Integration
ViScriptShop is not an island; it deeply integrates with mainstream mods to ensure the best compatibility:
⚡ KubeJS Scripting Support: Provides rich client/server event hooks (such as opening, buyPre, buySuccess, etc.) and Util APIs, allowing developers to implement extremely complex trading logic via scripts.
🎒 Backpack Mod Compatibility: Directly reads items from Sophisticated Backpacks and Beyond Dimension for payment. Players do not need to hold currency in their main hand.
🔍 JEI Integration: Check item recipes using JEI shortcuts directly within the shop interface without needing to close the window.
🛠️ Management Commands
The mod provides convenient commands for server management and debugging:
/viscript_shop editor: Open the visual editor.
/viscript_shop reload: Hot-reload shop data (clears cache), allowing you to test new shops without restarting the game.
/viscript_shop setStage & /viscript_shop money: Quickly manage player stages and economic data.
Available Versions
How to Install ViScriptShop on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "ViScriptShop". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
ViScriptShop server crashes on startup – what to do?
Most common cause: wrong neoforge 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 (1.21.1). You can switch loaders with one click in the panel.
Is ViScriptShop compatible with neoforge?
ViScriptShop officially supports neoforge for Minecraft 1.21.1, 1.21. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with ViScriptShop – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ViScriptShop 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.
Similar Mods
Rent Modded Server
Install ViScriptShop with just one click on your server.