Description
# 🛒 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.
