Skip to content

Resource Page

Jeremiah Osborne edited this page Jul 4, 2024 · 2 revisions

https://i.imgur.com/apOUD6x.jpg

Display Shops introduces a straightforward, immersive, and interactive approach to player shops. The plugin aims to elevate player shops to a modern level, featuring a unique design coupled with engaging mechanics such as GUI interactions and animations. With just two simple steps, players can effortlessly create new shops without the need for complex signs or configurations.

https://i.imgur.com/owbF776.jpg

  • Customizable GUI Menus - Tailor the GUI menus to your preferences

  • Multi-Currency - Shops select Vault, custom API, or physical items with configurable blacklist/whitelist

  • Smart Configs - Automatic updates ensure all configuration files stay current

  • Adaptable Restrictions - Pricing, limits, and similar restrictions are configurable or permissible

  • Shop Customization - Customize appearance, description, and ruleset for each shop

  • Efficient Shop Storage - Easily manage virtual stock and balance, with global rulesets for limits like max stock

  • Client-Side Displays - Shop displays are handled through asynchronous packet transmission

  • Shop Advertisement - Players can broadcast engaging, interactive methods to showcase their shops

  • Shop Visiting - Utilize a customizable GUI with filtered shops for teleportation without safety risks

  • Dynamic Pricing and Taxes - Flexible pricing and tax systems for dynamic adjustments based on shop usage

  • Market Regions (Experimental) - Custom adaptable regions for rentable shop areas, pre-filled with shops

  • Shop Logging (Early-Stages) - Record and track shop activities

  • Developer API - Accessible tools for developers to integrate and extend functionality

  • SQL Storage - Utilize SQLite or MySQL for efficient data storage

  • No Dependencies - Can operate without the need of any other plugins

https://i.imgur.com/icN2W2W.jpg https://i.imgur.com/Hi6cH1F.gif https://i.imgur.com/KYE4s9Y.gif https://i.imgur.com/VrKOePN.gif https://i.imgur.com/FXp9I8x.gif https://i.imgur.com/WzFVK2p.gif https://i.imgur.com/DKShFk0.gif

https://i.imgur.com/Ieo9JR0.png

(**NOTE: **Buying and selling can be disabled by setting the buy price or sell price to -1)

All information about how shops work, how to create them, etc. can be found on the wiki here.

https://i.imgur.com/1X2lb28.png https://i.imgur.com/azguCWo.png

https://i.imgur.com/IScevK1.png

  • (Q) Why does the creation item not drop when I destroy a shop?

    • (A) The 'creation-item-drop' under the 'shop-options' section in the 'config.yml' must be set to 'true'.

  • (Q) I'm getting errors on startup with default configuration files...

    • (A) This should never occur; however, double-check the configuration files as the auto-configuration updater more than likely was unable to adjust materials based on your Minecraft version.

  • **(Q) **Why are some materials Spanish that is supposed to be English by default?

    • **(A) **Inside the "lang.yml", remove the materials that are in the wrong language from the "translated-material-names" section.

  • (Q) How do I get the physical item or item-for-item trading to work?

    • (A) Vault must be disabled, once complete the players will need to use a set item in the configuration file as the base-line currency where they can then set up trade items for their shop! Keep in mind, that a seller's shop will hold obtained physical trades or currency until the owner comes to claim them through the stock management item in the shop's edit menu.

    • (A-2) Keep in mind that a physical item plugin that uses Vault will typically function better if needing to use everything to its full potential for a single currency item.

https://i.imgur.com/Nee4ZUj.png

Installation is quite simple when it comes to Display Shops. Simply follow the steps below:

  • (Step 1) Purchase and download the plugin

  • (Step 2) Place the downloaded jar files into your plugins folder

  • (Step 3) Start the server

  • (Step 4) Modify the configuration file to your liking

  • (Step 5) Reload the plugin using the command or simply restart the server

The plugin REQUIRES Spigot's API as a minimum. It is recommended to use forks of PaperSpigot like PurPur.

For the best experience, it is recommended to install Vault 1.7.3 or a recompiled Vault alongside an economy plugin.

https://i.imgur.com/tpKSRqn.jpg

https://i.imgur.com/0ZgTFzh.jpg The NEW 1.5 API can be found here! Each API build can be downloaded from the releases page.

As a quick note, downloading the API jar or using the actual plugin in your addon's dependencies grants immediate access to the DisplayShops.getPluginInstance() instance. Calling that will grant access to all available libraries and methods. Aside from that, the available events can be found in the xzot1k.plugins.ds.api.events package.

Below is the PRE-1.5 API:

To access the plugin from another plugin, add DisplayShops as a dependency and then you can use either DisplayShops.getPluginInstance(), or even get the plugin by name from the plugin manager. Below are some of the API classes and a description:

  • ShopCreationEvent - called when a shop is created from the creation item.
  • ShopDeletionEvent - called when a shop is deleted through the owner edit menu.
  • EconomyCallEvent - called when a transaction has been created.
  • EconomyCallType - enum containing the economy types used inside the EconomyCallEvent.
  • Shop - the shop class is an object that contains information about a single shop.
  • LocationClone - this is a clone of a Bukkit location that is usually used inside the Shop class.
  • Manager - here is where all methods can be accessed.
  • MarketRegion - this is an object similar to Shop that deals with the market regions.
  • Region - this is a sub-object for the MarketRegion.
  • ChatInteractionType - this contains all chat interaction types alongside their interaction IDs.
  • ChatInteractionEvent - this event is fired before a chat interaction is fully initiated.

https://i.imgur.com/jq2Nxqf.png Please follow the terms and conditions below:

  • Refunds are **NOT **permitted, exceptions can be made from the developer, but please read the page carefully and ask questions before purchasing.
  • Plugin redistribution, please just don't do this if you need some assistance or want to try out the plugin please contact the developer.
  • Be logical and don't use the review section as a place to report issues, bugs, or advertise. This behavior will simply result in a report of your account and your support alongside other privileges to be revoked.
  • Communicate, use the discussion, and/or contact the developer for anything related to the plugin. Don't bash the plugin, produce hate, or lash out because you're frustrated about something. Contact the developer for assistance to reach a resolution!

These terms and conditions are further extended by the TOS found on the ZotWare official website

https://www.zotware.dev/tos

Wiki

General Help

Configuration

Advanced Help

DisplayShops 2.0

I Need Help!

Clone this wiki locally