{"id":83048,"date":"2026-06-04T21:13:40","date_gmt":"2026-06-04T18:13:40","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/"},"modified":"2026-06-04T21:13:40","modified_gmt":"2026-06-04T18:13:40","slug":"hyphashop","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/","title":{"rendered":"HyphaShop"},"content":{"rendered":"<p>**Note:** Until this plugin&#8217;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.<\/p>\n<p>Official Document: https:\/\/ykdz.github.io\/HyphaDocs\/<\/p>\n<p># HyphaShop<\/p>\n<p>A highly dynamic, script-assisted, high-performance shop plugin.<\/p>\n<p><iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube-nocookie.com\/embed\/MAIPv8mlwzc\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe><\/p>\n<p>## Features<\/p>\n<p>* Progressive \u2014 advanced features are optional<br \/>\n* Random product pricing<br \/>\n* Random product quantity<br \/>\n* Conditional product listing<br \/>\n* Product stock<br \/>\n* Reusable product configurations (no need to repeat setups)<br \/>\n* Product rarity<br \/>\n* Bundle products<br \/>\n* Basic attribute support (Skull, Flag, Trim, Potion Effect, Custom Model Data)<br \/>\n* Automatic translation of Vanilla item names<br \/>\n* Merchant mode for shops<br \/>\n* Trade logging<br \/>\n* Unified cart-based transactions<br \/>\n* Fully translatable content<br \/>\n* Comprehensive GUI system<br \/>\n* JavaScript-like scripting system<\/p>\n<p>## Progressive<\/p>\n<p>If you only need a simple shop plugin to sell vanilla items, you can follow the configuration example in `product\/wools.yml`.<\/p>\n<p>All advanced features are completely optional and won\u2019t consume extra cpu if unused.<\/p>\n<p>## Random Product Pricing<\/p>\n<p>Add the following configuration to enable random pricing like shown in the image:<\/p>\n<p>&#8220;`yml<br \/>\ndefault-configs:<br \/>\n  buy-price:<br \/>\n    mean: 80<br \/>\n    dev: 10<br \/>\n    round: true<br \/>\n  sell-price:<br \/>\n    mean: 5<br \/>\n    dev: 2<br \/>\n&#8220;`<\/p>\n<p>![Random Price](https:\/\/cdn.modrinth.com\/data\/cached_images\/732a730fcae61e5e2a8cda3cf2c4bbfd72e8409b.png)<\/p>\n<p>## Random Product Quantity<\/p>\n<p>Product quantity can accept a script string as a value. It can also adjust pricing based on quantity automatically.<\/p>\n<p>&#8220;`yml<br \/>\ndefault-configs:<br \/>\n  item:<br \/>\n    amount: 8 + nextUniform(8, 16)<br \/>\n  buy-price:<br \/>\n    formula: base * (1 + (Math.random() * 2 &#8211; 1) * buy_range) * product_amount<br \/>\n  sell-price:<br \/>\n    formula: base * (1 + (Math.random() * 2 &#8211; 1) * sell_range) * product_amount<\/p>\n<p>products:<br \/>\n  GOLD_ORE:<br \/>\n    item:<br \/>\n      base: gold_ore<br \/>\n    buy-price:<br \/>\n      context: const base = 200<br \/>\n    sell-price:<br \/>\n      context: const base = 70<br \/>\n&#8220;`<\/p>\n<p>![Random Amount](https:\/\/cdn.modrinth.com\/data\/cached_images\/0f37e6439082f68fdd1638a852b5fe708553e6dc.png)<\/p>\n<p>## Conditional Product Listing<\/p>\n<p>Scripts can participate in plugin logic at various hooks, including controlling whether a product is listed.<\/p>\n<p>&#8220;`yml<br \/>\ndefault-configs:<br \/>\n  actions:<br \/>\n    on-before-list:<br \/>\n      &#8211; |<br \/>\n        const timeStr = papi(&#8220;%world_time_world%&#8221;).split(&#8220;:&#8221;);<br \/>\n        const hours = timeStr[0];<br \/>\n        number(hours) >= 20 || number(hours) < 6;\n      - total_history_bought_amount <= 64\n```\n\n## Product Stock\n\nProducts can have their own inventory. Once stock is depleted, they can no longer be purchased.\n\n```yml\ndefault-configs:\n  stock:\n    global:\n      size: 1024\n      replenish: true\n      overflow: true\n      inherit: true\n```\n\n![Stock](https:\/\/cdn.modrinth.com\/data\/cached_images\/ff2eb5d52af7689ec5dfe8554abcdf7e7cbe7d19.png)\n\n## Reusable Product Configurations\n\nFor similar products (e.g., all colors of wool), you can reuse default configurations. This greatly reduces setup complexity.\n\n```yml\ndefault-configs:\n  item:\n    amount: 16\n  buy-price:\n    mean: 80\n    dev: 10\n    round: true\n  sell-price:\n    mean: 5\n    dev: 2\n  rarity: uncommon\n  cacheable: true\n\nproducts:\n  LIGHT_BLUE_WOOL:\n    item:\n      base: light_blue_wool\n\n  YELLOW_WOOL:\n    item:\n      base: yellow_wool\n\n  LIME_WOOL:\n    item:\n      base: lime_wool\n```\n\n![Default Configs](https:\/\/cdn.modrinth.com\/data\/cached_images\/60255f8977414207da7c861bc128300653c635a6.png)\n\n## Product Rarity\n\nYou can assign a rarity level to each product. This affects the probability of random listing and can also serve as decoration.\n\n```yml\nrarities:\n  common:\n    name: \"<gray>Common&#8221;<br \/>\n    weight: 100<br \/>\n  uncommon:<br \/>\n    name: &#8220;<white>Uncommon&#8221;<br \/>\n    weight: 80<br \/>\n  rare:<br \/>\n    name: &#8220;<dark_purple>Rare&#8221;<br \/>\n    weight: 60<br \/>\n&#8220;`<\/p>\n<p>## Bundle Products<\/p>\n<p>Products can be bundles that contain multiple other products.<\/p>\n<p>When calculating a bundle\u2019s price, the total price of its contents is available as a context variable.<\/p>\n<p>&#8220;`yml<br \/>\nproducts:<br \/>\n  WARM_COLOR_WOOL_BUNDLE:<br \/>\n    icon:<br \/>\n      base: barrel<br \/>\n      amount: 1<br \/>\n      name: &#8220;<white>Warm toned wool bundle&#8221;<br \/>\n      lore:<br \/>\n        &#8211; &#8220;<gray>A bundle that contains all&#8221;<br \/>\n        &#8211; &#8220;<gold>warm toned<gray>wool.&#8221;<br \/>\n    buy-price:<br \/>\n      formula: bundle_total_new * 0.8<br \/>\n    sell-price:<br \/>\n      disable: true<br \/>\n    bundle-contents:<br \/>\n      &#8211; YELLOW_WOOL<br \/>\n      &#8211; BROWN_WOOL<br \/>\n      &#8211; MAGIC_ORANGE_WOOL<br \/>\n      &#8211; RED_WOOL:3<br \/>\n    rarity: rare<br \/>\n&#8220;`<\/p>\n<p>![Bundle](https:\/\/cdn.modrinth.com\/data\/cached_images\/c904c6257eac6e3a70b5cfce589f17bb6b097532.png)<\/p>\n<p>## Basic Attribute Support<\/p>\n<p>Thanks to high-version `Data Component` features, the plugin supports basic attributes for items.<\/p>\n<p>![Armor Trim](https:\/\/cdn.modrinth.com\/data\/cached_images\/5e5456d201da439134212070b3caf3cfcf744243.png)<br \/>\n![Potion Effect](https:\/\/cdn.modrinth.com\/data\/cached_images\/1d0787d24994932ba9bea6711fefdc7aa8c42fd3.png)<\/p>\n<p>## Automatic Translation of Vanilla Item Names<\/p>\n<p>Using the `Adventure API`&#8217;s `Translatable Component` mechanism, vanilla item names are automatically translated with no need of manual configuration or downloading language files.<\/p>\n<p>&#8220;`yml<br \/>\nproducts:<br \/>\n  LIME_WOOL:<br \/>\n    item:<br \/>\n      base: lime_wool<br \/>\n&#8220;`<\/p>\n<p>![Vanilla Name Translation](https:\/\/cdn.modrinth.com\/data\/cached_images\/2534f4ad506f7ef52f80f0dd2ad5b8b5dc07a22d.png)<\/p>\n<p>## Merchant Mode<\/p>\n<p>Shops can have their own virtual balance. Once depleted, they can no longer buy products from players.<\/p>\n<p>&#8220;`yml<br \/>\nsettings:<br \/>\n  merchant:<br \/>\n    balance: 1000<br \/>\n    replenish: true<br \/>\n    overflow: true<br \/>\n    inherit: true<br \/>\n&#8220;`<\/p>\n<p>![Merchant](https:\/\/cdn.modrinth.com\/data\/cached_images\/7fcf928a0c5589fe97410aee1051c23539e478c0.png)<\/p>\n<p>## Trade Logging<\/p>\n<p>Each player\u2019s transactions are recorded in a database for review by themselves or server administrators.<\/p>\n<p>![Log](https:\/\/cdn.modrinth.com\/data\/cached_images\/5f2fa0113c42947036123073e0e5312f242b1000.png)<\/p>\n<p>## Cart-Based Transactions<\/p>\n<p>In addition to traditional direct purchases, players can add multiple products to a cart and purchase them all at once.<\/p>\n<p>![Cart](https:\/\/cdn.modrinth.com\/data\/cached_images\/968e6cd7c3b959b2403a77ed415325ea7b222de1.png)<\/p>\n<p>## Comprehensive GUI System<\/p>\n<p>Beyond the shop menu, you can use the same GUI configuration logic to create custom GUIs.<\/p>\n<p>## JavaScript-Like Scripting System<\/p>\n<p>This plugin includes a built-in scripting system with syntax similar to JavaScript (simplified for function calls), offering high configurability.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>An ultra-customizable and high-performance shop plugin featuring a powerful custom scripting system.<\/p>\n","protected":false},"featured_media":83049,"template":"","meta":{"_minecraft_slug":"hyphashop","_minecraft_project_id":"SeLGgTIu","_minecraft_author":"YK_DZ","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":262,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hyphashop.zip","_minecraft_size_bytes":6647205,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-16T12:11:06.374205Z","_minecraft_date_created":"2025-07-20T22:53:17.709150Z","_minecraft_date_modified":"2026-01-24T04:23:49.490866Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hyphashop","_minecraft_icon_attachment_id":83049,"_minecraft_imported_at":"2026-06-04T18:13:41+00:00","_minecraft_import_hash":"921b4a9d29d80cd77282ca9f13483d30","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,89,126,127,128],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-83048","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>HyphaShop - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"HyphaShop - Minecraft\" \/>\n<meta property=\"og:description\" content=\"An ultra-customizable and high-performance shop plugin featuring a powerful custom scripting system.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/\",\"name\":\"HyphaShop - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp\",\"datePublished\":\"2026-06-04T18:13:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/hyphashop\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"HyphaShop\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"HyphaShop - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/","og_locale":"en_US","og_type":"article","og_title":"HyphaShop - Minecraft","og_description":"An ultra-customizable and high-performance shop plugin featuring a powerful custom scripting system.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/","name":"HyphaShop - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp","datePublished":"2026-06-04T18:13:40+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/hyphashop-icon-7bb1046c9b43d5cd0b6f9430df12fc808200ceec_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/hyphashop\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"HyphaShop"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/83048","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/83049"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=83048"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=83048"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=83048"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=83048"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}