Skip to main content

Display Item

QuickShop 提供了一个很酷的功能，让玩家识别商店物品。

工作模式​

Display Item has one work mode:

  • Virtual DisplayItem

Real DisplayItem​

This work mode has been removed. If you were using it before, QuickShop will be disabled display item globally.

Virtual DisplayItem​

此工作模式将向玩家的客户端发送一个数据包，以欺骗客户端在商店容器上方生成一个悬浮物品。
玩家** 可以看到该物品，但它实际上不存在于服务器上，它不会影响服务器性能和更高的安全性。
Player can see the item BUT it actually not exists on the server, it won't affect the server performance and more security.

要使用此功能，您需要安装 ProtocolLib 并设置 display-type 到 2。

If you want to use PacketEvents as a Virtual DisplayItem, you need set display-protocol to packetevents.

Configuration​

  #The display type you want use.
  #Old mode, ArmorStand (display-type=1) is Outdated and could not be used
  #0=Normal Dropped Item
  #2=Virtual Item (Requires ProtocolLib, fallback to type 0 if ProtocolLib is not installed)
  display-type: 2

Globally disable display item​

For some reason you don't want the shops on your server spawn the display items, you can disable this feature in config.yml

  #Should we place display items on the chests?
  #This may cause duped items, especially for modded servers!
  #Virtual DisplayItem is safe for dupe
  display-items: false

Per shop disable display item​

Too many items in same region may hurt client fps, especially when you are in a shopping center.
You can disable or enable display item for single shop by looking a quickshop and execute:

/quickshop toggledisplay

Note: If display item already globally disabled, it won't force spawn display items.

DisplayItem Guard​

When QuickShop working under Real DisplayItem mode, DisplayItem Guard will enabled to protect DisplayItem dupe with Hopper, Water etc.
Server administrators will receive alert when player trying to dupe display items.

You can disable the alert by tweak the settings:

#Allow QuickShop to send alerts when someone tries to make a displayItem exploit.
send-display-item-protection-alert: false

QuickShop also will check all display items to make sure they are still at the position they should be, and reset, respawn them when need. You can tweak the options below the change this:

  #QuickShop will check if the display item is in a valid position every specified amount of ticks.
  #Set to 0 to disable it.
  display-items-check-ticks: 6000
  #The interval (in ticks) at which QS checks the shops range to despawn/spawn displays.
  display-check-time: 40

This function is completely a compromise of client render performance, which will greatly increase the pressure on the server, and it is not recommended to use it.

This feature allow you despawn both Real DisplayItem and Virtual DisplayItem when player too far with shops.

  #Allow QuickShop to automatically despawn displays when no players are in range of the shop.
  display-auto-despawn: false

  #The range at which displays will despawn.
  display-despawn-range: 20