**Note:** Until this plugin's version number exits the Beta stage, it is not recommended for production use. Additionally, an English Wiki will not be provided prior to that point. Please treat it as a trial. If you encounter any issues while testing the plugin, feel free to report them on Discord or GitHub Issues. https://youtu.be/MAIPv8mlwzc # HyphaShop A highly dynamic, script-assisted, high-performance shop plugin. ## Features * Progressive — advanced features are optional * Random product pricing * Random product quantity * Conditional product listing * Product stock * Reusable product configurations (no need to repeat setups) * Product rarity * Bundle products * Basic attribute support (Skull, Flag, Trim, Potion Effect, Custom Model Data) * Automatic translation of Vanilla item names * Merchant mode for shops * Trade logging * Unified cart-based transactions * Fully translatable content * Comprehensive GUI system * JavaScript-like scripting system ## Progressive If you only need a simple shop plugin to sell vanilla items, you can follow the configuration example in `product/wools.yml`. All advanced features are completely optional and won’t consume extra cpu if unused. ## Random Product Pricing Add the following configuration to enable random pricing like shown in the image: ```yml default-configs: buy-price: mean: 80 dev: 10 round: true sell-price: mean: 5 dev: 2 ``` ![Random Price](https://cdn.modrinth.com/data/cached_images/732a730fcae61e5e2a8cda3cf2c4bbfd72e8409b.png) ## Random Product Quantity Product quantity can accept a script string as a value. It can also adjust pricing based on quantity automatically. ```yml default-configs: item: amount: 8 + nextUniform(8, 16) buy-price: formula: base * (1 + (Math.random() * 2 - 1) * buy_range) * product_amount sell-price: formula: base * (1 + (Math.random() * 2 - 1) * sell_range) * product_amount products: GOLD_ORE: item: base: gold_ore buy-price: context: const base = 200 sell-price: context: const base = 70 ``` ![Random Amount](https://cdn.modrinth.com/data/cached_images/0f37e6439082f68fdd1638a852b5fe708553e6dc.png) ## Conditional Product Listing Scripts can participate in plugin logic at various hooks, including controlling whether a product is listed. ```yml default-configs: actions: on-before-list: - | const timeStr = papi("%world_time_world%").split(":"); const hours = timeStr[0]; number(hours) >= 20 || number(hours) < 6; - total_history_bought_amount <= 64 ``` ## Product Stock Products can have their own inventory. Once stock is depleted, they can no longer be purchased. ```yml default-configs: stock: global: size: 1024 replenish: true overflow: true inherit: true ``` ![Stock](https://cdn.modrinth.com/data/cached_images/ff2eb5d52af7689ec5dfe8554abcdf7e7cbe7d19.png) ## Reusable Product Configurations For similar products (e.g., all colors of wool), you can reuse default configurations. This greatly reduces setup complexity. ```yml default-configs: item: amount: 16 buy-price: mean: 80 dev: 10 round: true sell-price: mean: 5 dev: 2 rarity: uncommon cacheable: true products: LIGHT_BLUE_WOOL: item: base: light_blue_wool YELLOW_WOOL: item: base: yellow_wool LIME_WOOL: item: base: lime_wool ``` ![Default Configs](https://cdn.modrinth.com/data/cached_images/60255f8977414207da7c861bc128300653c635a6.png) ## Product Rarity You can assign a rarity level to each product. This affects the probability of random listing and can also serve as decoration. ```yml rarities: common: name: "Common" weight: 100 uncommon: name: "Uncommon" weight: 80 rare: name: "Rare" weight: 60 ``` ## Bundle Products Products can be bundles that contain multiple other products. When calculating a bundle’s price, the total price of its contents is available as a context variable. ```yml products: WARM_COLOR_WOOL_BUNDLE: icon: base: barrel amount: 1 name: "Warm toned wool bundle" lore: - "A bundle that contains all" - "warm tonedwool." buy-price: formula: bundle_total_new * 0.8 sell-price: disable: true bundle-contents: - YELLOW_WOOL - BROWN_WOOL - MAGIC_ORANGE_WOOL - RED_WOOL:3 rarity: rare ``` ![Bundle](https://cdn.modrinth.com/data/cached_images/c904c6257eac6e3a70b5cfce589f17bb6b097532.png) ## Basic Attribute Support Thanks to high-version `Data Component` features, the plugin supports basic attributes for items. ![Armor Trim](https://cdn.modrinth.com/data/cached_images/5e5456d201da439134212070b3caf3cfcf744243.png) ![Potion Effect](https://cdn.modrinth.com/data/cached_images/1d0787d24994932ba9bea6711fefdc7aa8c42fd3.png) ## Automatic Translation of Vanilla Item Names Using the `Adventure API`'s `Translatable Component` mechanism, vanilla item names are automatically translated with no need of manual configuration or downloading language files. ```yml products: LIME_WOOL: item: base: lime_wool ``` ![Vanilla Name Translation](https://cdn.modrinth.com/data/cached_images/2534f4ad506f7ef52f80f0dd2ad5b8b5dc07a22d.png) ## Merchant Mode Shops can have their own virtual balance. Once depleted, they can no longer buy products from players. ```yml settings: merchant: balance: 1000 replenish: true overflow: true inherit: true ``` ![Merchant](https://cdn.modrinth.com/data/cached_images/7fcf928a0c5589fe97410aee1051c23539e478c0.png) ## Trade Logging Each player’s transactions are recorded in a database for review by themselves or server administrators. ![Log](https://cdn.modrinth.com/data/cached_images/5f2fa0113c42947036123073e0e5312f242b1000.png) ## Cart-Based Transactions In addition to traditional direct purchases, players can add multiple products to a cart and purchase them all at once. ![Cart](https://cdn.modrinth.com/data/cached_images/968e6cd7c3b959b2403a77ed415325ea7b222de1.png) ## Comprehensive GUI System Beyond the shop menu, you can use the same GUI configuration logic to create custom GUIs. ## JavaScript-Like Scripting System This plugin includes a built-in scripting system with syntax similar to JavaScript (simplified for function calls), offering high configurability.

YKDZ

YKDZ's Plugins

HyphaShop by YKDZ

YKDZ's Organizations

Stars

Watching

HyphaShop by