Yet Another Shop

YetAnotherShop

YetAnotherShop is a powerful native Hytale shop system for servers. It provides admin-managed server shops, player-owned shops, physical shop blocks, item and currency payments, player buy orders, quest-based products, stock and restock systems, quantity selection, per-player purchase limits, progression requirements, categories, shop linking, map markers, owner notifications, player shop activity history, multilingual support, and an extensive in-game admin interface.

The plugin is designed for server owners who want more than a simple buy/sell menu. You can create classic NPC traders, spawn shops, player marketplaces, quest shops, progression-locked vendors, reward shops, item-for-item exchanges, player buy-order boards, and fully physical shop stalls placed directly in the world.

Link to Userdocs: Click here

Main Features

• Native Hytale UI using in-game custom UI pages instead of web or HTML menus.
• Server Shops fully controlled by admins.
• Player Shops where players can create and manage their own shops.
• PlayerShop Buy Orders allowing shop owners to buy wanted items from other players.
• Physical Shop Blocks for both server shops and player shops.
• Multiple ShopBlock variants, including color, fantasy, luxury, and questboard styles depending on the installed version.
• Shop linking to blocks, containers, HyCitizens NPCs, and optional supported entity targets.
• Link-only shops, so specific shops can only be opened through their linked world object.
• World Map markers for visible shop locations using supported Hytale map marker icons.
• Quantity Chooser for buying or selling multiple items at once.
• Per-player purchase limits with max per purchase, daily, weekly, lifetime, and cooldown limits.
• PlayerShop owner notifications for purchases and out-of-stock events.
• PlayerShop activity history for tracking recent sales and stock events.
• In-game admin panel for creating, editing, duplicating, linking, and configuring shops.
• Player shop editor for managing personal shops directly in-game.
• English and German localization included.

Player Shops

• Players can create their own shops and manage them through a dedicated in-game editor.
• Player shop products are backed by real stored inventory stock.
• Players can choose products from their inventory and configure prices.
• Supports item payments and digital currency payments depending on available economy providers.
• Supports player buy orders where shop owners can search for items and pay other players for delivering them.
• Buy orders use deposited shop budget, wanted item amounts, and settlement storage for collected items.
• Supports categories, product descriptions, preview settings, stock display, payment options, and offer limits.
• Includes configurable limits for shops per player, offers per shop, buy orders per shop, products per offer, payment options, categories, and activity history.
• Products per offer and payment options per offer are capped to the supported UI maximum of 3 each.
• Player shops can be linked to physical shop blocks or containers.
• Linked player shops can be restricted so they only open from the linked world object.
• Shop owners can receive live notifications when another player buys from their shop.
• Shop owners can receive live notifications when an offer becomes out of stock after a purchase.
• Owner notifications can be toggled per PlayerShop.
• PlayerShop activity history stores sales and out-of-stock events, even when the owner is offline.
• The PlayerShop editor includes tabs for general settings, products, payments, limits, preview, linking, and activity.
• The offer list clearly marks sell offers and buy orders using compact mode badges.

PlayerShop Buy Orders

• Player shop owners can create buy orders for wanted items.
• Buy orders allow visitors to sell items to the shop owner instead of buying items from the shop.
• Buy orders are limited to PlayerShops and can be enabled or disabled globally.
• Each buy order uses one wanted item and one currency payout option.
• Shop owners must deposit a buy budget before players can sell items to the buy order.
• The deposited budget limits how many items can be bought from visitors.
• When a visitor sells an item to a buy order, the item is removed from the visitor, the visitor receives the payout, and the collected item is stored for the shop owner.
• Unused buy budget is returned when a buy order is removed or changed where applicable.
• Buy orders support the same per-player offer limits as normal sales, including max per transaction, daily, weekly, lifetime, and cooldown limits.
• Buy orders are shown with clear stock/wanted amount information such as how many items are still wanted.

PlayerShop Notifications & Activity

• Live Hytale notifications when a player buys from your PlayerShop.
• Live Hytale notifications when one of your offers becomes out of stock.
• Separate toggles for purchase notifications and out-of-stock notifications.
• Offline shop owners do not receive queued live notifications, but activity entries are still saved.
• Persistent activity history for sales and stock-empty events.
• Activity tab in the PlayerShop editor.
• Activity management actions such as mark as read and clear history.
• Configurable maximum activity history size per shop using maxHistoryEntriesPerShop.
• Designed with capped history storage to avoid unbounded data growth on long-running servers.

Shop Blocks & Linking

• Dedicated Server ShopBlocks and Player ShopBlocks.
• Multiple visual variants for different shop styles.
• Link shops to physical blocks in the world.
• Link shops to containers for chest-style shop setups.
• Link shops to HyCitizens NPCs where supported.
• Optional generic entity/NPC linking can be enabled through server config if needed.
• Generic entity/NPC linking is disabled by default for safer compatibility with other interaction-heavy mods.
• Safe unlink and cleanup behavior for linked shop blocks.
• ShopBlocks are protected from normal tool breaking and should be managed through the shop UI.

Stock, Restock, Quantity & Limits

• Unlimited or limited stock per offer.
• Configurable current stock and maximum stock.
• Restock amount and restock interval support.
• Separate stock display and restock display settings.
• Quantity chooser for normal shop purchases.
• Quantity chooser for PlayerShop purchases and PlayerShop buy orders.
• Quick quantity actions such as x1, x10, and all available.
• The all-available option is limited by stock, budget, inventory space, affordability, and active purchase limits.
• Maximum amount per purchase.
• Daily, weekly, lifetime, and cooldown-based purchase limits.
• Purchase limits are counted per player and per offer.
• Limits work for ServerShops, PlayerShop sales, and PlayerShop buy orders.
• Limit history is cleaned up when offers or entire shops are deleted.
• Server-side validation for stock, payment, inventory space, purchase limits, buy order budget, and requirements.
• Player shops always validate current stock and escrow before final purchase.
• PlayerShop owners can be notified when a limited-stock offer becomes empty after a purchase.

Admin Interface

• Create, edit, duplicate, and delete server shops.
• Create, edit, duplicate, move, and delete offers.
• Configure products, outputs, payment options, stock, restock, categories, rules, quest settings, purchase limits, and links.
• Manage shop settings, visibility, access, map markers, and integration behavior.
• Configure PlayerShop limits, buy order limits, product/payment limits, and activity history limits.
• Configure whether PlayerShop buy orders are enabled.
• Configure whether PlayerShop sales of Books & Papers items with metadata are allowed.
• Preview products directly in the admin UI.
• Clear limit-related data automatically when shops or offers are deleted.
• Display clear limit messages when product, output, payment option, or cost limits are reached.
• Manage optional integrations and provider-specific behavior.
• Seed demo content for testing or setup.

Server Shops

• Create unlimited admin-managed shops.
• Configure shop names, descriptions, icons, categories, sorting, visibility, and access behavior.
• Create and manage offers with multiple products and payment options.
• Use finite stock, unlimited stock, restock timers, and purchase limits.
• Show or hide stock and restock information independently.
• Restrict shops through rules, progression requirements, quests, custom providers, regions, or reputation systems.
• Open shops by command, link them to blocks/NPCs, or restrict them to physical access only.
• ServerShop admin pages show clear feedback when configured product/output or payment option limits are reached.

Products & Offers

• Standard item products.
• Currency products.
• Quest products.
• Multiple output products per offer.
• Multiple payment options per offer.
• Item-for-item trades.
• Currency-based purchases.
• PlayerShop buy orders for item-to-currency selling.
• Mixed shop layouts with categories, titles, subtitles, descriptions, tags, icons, and sorting.
• Offer activation toggles, visibility controls, requirement checks, and per-offer purchase limits.

Books & Papers Protection

• PlayerShop sales of Books & Papers items with metadata can be allowed or blocked through configuration.
• This helps protect server economies from copyable or metadata-heavy written items where external mods may allow duplication-like workflows.
• If disabled, affected PlayerShop items are blocked during listing and during purchase validation.
• The item picker shows a clear message when a Books & Papers item cannot be added because the feature is disabled.
• ServerShop templates remain available for admin-managed rewards and are not affected by this PlayerShop safety setting.

Quest Products

• Create quest-based shop products directly from the admin UI.
• Select available quest providers such as QuestLines or MMOSkillTree where installed.
• Provider-specific quest selection is supported, so choosing a quest provider can show the available quests for that provider.
• Supports quest actions such as accepting, starting, opening, tracking, completing, rewarding, and custom quest action flows.
• Quest products can display different states such as available, active, completed, locked, on cooldown, reward-ready, or already claimed.
• Useful for quest boards, daily contracts, progression shops, and reward vendors.
• Quest offers use quest flow behavior instead of normal product/payment/limit configuration where appropriate.

Rules & Requirements

• Shop visibility rules.
• Shop access and purchase requirements.
• Offer visibility rules.
• Offer purchase requirements.
• Requirement operators such as equals, not equals, greater than, greater or equal, less than, less or equal, and contains.
• Quest state requirements.
• Quest progress requirements.
• Quest tag and quest variable checks.
• MMOSkillTree skill and progress checks.
• RPGLeveling progression checks.
• Region and reputation provider support where available.
• Custom provider rule support for advanced server integrations.

Payments & Economy

• Item-based payments.
• Digital currency payments.
• Multiple payment options per offer.
• Optional VaultUnlocked integration.
• Optional Ecotale integration.
• Automatic or manual economy provider configuration.
• Provider-specific currency labels.
• Fallback support for item-only shops when no economy provider is installed.
• PlayerShop buy orders require a supported currency provider and deposited buy budget.
• Server-side validation prevents stale, empty, unaffordable, or invalid payment options from being used.

Categories & UI

• Shop-local category system.
• Custom category names, colors, icons, sorting, and visibility.
• Category tabs in the shop UI.
• Multi-row category layout for shops with many categories.
• Long category names are shortened to keep the UI readable.
• Products can belong to one or more categories.
• The shop UI can display product output, payment cost, stock, wanted amount, restock status, quest state, and access state.
• PlayerShop admin lists use compact badges to distinguish sales from buy orders without hiding the product name.

Commands

• /yetanothershop or /yas opens the default shop page.
• /yetanothershop <shop> or /yas <shop> opens a specific shop by slug, unless that shop is link-only.
• /yas myshop opens the player shop editor.
• /yetanothershopadmin, /yasadmin, or /yasa opens the admin interface for users with permission.

Optional Integrations

• VaultUnlocked - economy and currency support.
• Ecotale - economy and currency support.
• QuestLines - quest products, quest board behavior, quest actions, and quest state checks.
• MMOSkillTree - skill, progression, and quest-related rules.
• RPGLeveling - level and progression requirements.
• HyCitizens - optional legacy NPC shop linking support.

Public API

• Read server shops and player shops from other plugins.
• Query offers, categories, links, owners, stock states, and player shop limits.
• Find shops by slug, owner, block reference, container reference, or linked target.
• Open shops for players through the API.
• Useful for server networks, custom systems, quest plugins, economy plugins, and external integrations.

Use Cases

• Spawn shops.
• NPC traders.
• Quest boards.
• Reward vendors.
• Player marketplaces.
• Player buy-order boards.
• Physical market stalls.
• Progression-locked shops.
• Skill-based shops.
• Daily or weekly limited shops.
• Item-for-item exchange systems.
• Currency-based server economies.
• Player-run trading districts with owner activity tracking.

Why YetAnotherShop?

YetAnotherShop is built to be flexible, immersive, and server-friendly. It combines classic admin shops with real player-owned shops, physical world interaction, buy orders, quest integration, progression requirements, economy support, quantity selection, per-player limits, owner notifications, and persistent PlayerShop activity tracking. Whether you want a simple spawn vendor, a player-run marketplace, a buy-order board, or a complex quest-locked trading system, YetAnotherShop gives you the tools to build it directly in-game.