EndyDev Read the docs

Installation

One server

  1. Install Vault (or VaultUnlocked) and an economy plugin, if you don’t have them yet.
  2. Put zNetSell.jar in plugins/ and restart the server.
  3. Give items a price: /netsell editor in game, /netsell setprice diamond 25, or import the prices you already have (below).

That’s it. Players can now use /sell, /sell hand, /sell all and /worth.

On its first start zNetSell creates plugins/zNetSell/ with config.yml, the message files in lang/ and the database netsell.db (SQLite). The server also downloads the libraries zNetSell uses (database drivers, Redis client) into libraries/, once. If your host blocks downloads from Maven Central, start the server once with -Dorg.bukkit.plugin.java.LibraryLoader.centralURL=<a Maven mirror>.

Import your prices

zNetSell reads the prices of three plugins. Their files only need to be in plugins/; the plugins themselves don’t have to be installed or running.

FromReads
EssentialsXplugins/Essentials/worth.yml
ShopGUI+every file in plugins/ShopGUIPlus/shops/ (sell prices)
EconomyShopGUIplugins/EconomyShopGUI/shops/ or shops.yml (also the Premium folder)
  1. /netsell import essentials shows what it found and what it would do. Nothing changes yet.
  2. /netsell import essentials confirm adds the items that have no price in zNetSell. Prices you already set stay.
  3. Or /netsell import essentials replace to overwrite those too.

Use shopguiplus or economyshopgui in place of essentials for the other two. Special entries (enchanted books, potions, command items) are skipped and counted in the preview. Essentials’ default worth.yml still has some item names from before 1.13 (log, wool…); Essentials can’t sell those either, so the preview lists them and moves on.

Folia

zNetSell runs on Folia with the same jar. A few things to check:

  • Use VaultUnlocked instead of Vault: the original Vault doesn’t load on Folia. VaultUnlocked works with plugins written for Vault, zNetSell included.
  • Your economy plugin must support Folia too. EssentialsX doesn’t.
  • /reload doesn’t exist on Folia; restart the server, or use /netsell reload for zNetSell’s own files.

On Folia, zNetSell takes items from a player’s inventory or menu on that player’s region thread, and from a chest on the chest’s region thread. If a player crosses into another region while a sale waits for its daily limit, that sale is called off and nothing is taken.

Update

Replace the jar and restart. Your config.yml and lang/ files are kept. Options and messages added by a new version work at once with their default values, even though your files don’t list them. To see the new options with their comments, open the config.yml inside the jar, or rename yours and restart once to get a fresh copy.

Remove

Delete the jar. Your prices and sales history stay in plugins/zNetSell/netsell.db (or in your network database) in case you come back.