v2.19.0 for MC 1.20.4, 1.20.2, 1.20.1, 1.19.4, 1.19.3, 1.19.2, 1.19, 1.18.2, 1.17.1, 1.16.5

I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md 

• Add support for MC 1.20.4. MC 1.20.3, which is mostly the same, is not officially supported. No new features or mobs. Experimental MC 1.21 mobs are not yet supported.
• Add setting `citizen-npc-fluid-pushable` (default: `false`) to make all shopkeeper Citizens NPCs pushable by fluids (`true`), unpushable by fluids (`false`), or not modify their current behavior (`"undefined"`).
  • When set to `"undefined"`, the Citizens NPCs are not modified but retain their default or previously set fluid pushable behavior.
  • Unfortunately, the Citizens plugin has no in-game command yet to toggle the fluid pushable state of individual NPCs. But this is likely to be added in the future.
• Shulker shopkeepers peek at nearby players now.
  • This behavior can be disabled with the setting `shulker-peek-if-player-nearby` (default: `true`).
  • The setting `shulker-peek-height` (default `0.3`) defines how much the shulker opens when it peeks.
• Add: Support for setting up items that execute a command when being traded (either sold or bought).
  • Add: Command `/shopkeeper setTradedCommand <command>` (permission `shopkeeper.settradedcommand`, default `op`): Sets the command to execute when the held item is traded.
  • The command to execute is stored inside the item's data under the Bukkit key `shopkeepers:traded_command`.
  • When an item that has a traded command assigned is traded, the item is destroyed and the assigned command is executed as often as there are items in the item stack.
  • This feature is not meant to replace the requirement for custom third-party plugins or scripts in order to implement complex or custom behaviors. In order to reduce implementation and maintenance effort, only a single command can be assigned to an item and only a very limited set of placeholders is supported: `{player_name}`, `{player_uuid}`, `{player_displayname}`, `{shop_uuid}`.
    • Simple command sequences can also be defined via command aliases in Bukkit's "commands.yml" (see https://bukkit.fandom.com/wiki/Commands.yml).
    • If additional context information is required, e.g. about the shopkeeper's location or shop owner, a custom plugin that listens for the `ShopkeeperTradeEvent` might be better suited to implement the intended behavior.
• Add: Utility command "/shopkeeper replaceAllWithVanillaVillagers".
  • This command deletes all shopkeepers and replaces them with corresponding vanilla villagers without AI that are configured very similar to villager shopkeepers.
  • This might for example be useful when migrating a world to vanilla Minecraft, e.g. when a server closes a world but wants to provide it as download to its players with all the shopkeepers included.
  • This command requires all of the following permissions: `shopkeeper.debug`, `shopkeeper.remove-all.player`, `shopkeeper.remove-all.admin`.
• Add: "No shops were found" message to the "removeAll" command.
• Fix: Moving shopkeepers did not update their location in the AI system, breaking gravity and AI activations when being moved out of their original chunk.
• Fix: Verify that the Citizens API is still available before we try to use it. This guards against cases in which the Citizens plugin reports as "enabled", but the Citizens API is not in a properly initialized state. Reloading the Citizens plugin via PlugMan also seems to leave the Citizens API in an unusable state.
• Fix: The check whether the cursor can hold the traded item was off by one, unnecessarily preventing trades in some cases.
• Fix: Shopkeepers could no longer be moved after a recent change in the Paper server (PR 9937) to now also call the EntityTeleportEvent for plugin invoked teleports: All plugins that previously cancelled or modified entity teleports in certain cases (including the Shopkeepers plugin itself) can now accidentally cancel or modify plugin invoked entity teleports that were not supposed to be cancelled or modified previously. For now, we restore the previous behavior for all of our plugin triggered shopkeeper entity teleports by forcing these teleports, bypassing any cancellation and modification attempts of plugins.
• API (breaking): Changes to the `ShopkeeperTradeEvent`.
  • The result item received by the trading player and the items received by the shopkeeper can now be altered via the `ShopkeeperTradeEvent` (`#get/setReceivedItem1/2`, `#get/setResultItem`).
    • Breaking: Plugins that use this event can no longer assume that the received items equal those of the trading recipe.
    • It is also possible to clear the received items. This might for example be useful when implementing items that apply alternative effects when traded (e.g. command items, or Vault integration).
    • Trade logging and trade notifications still log the original items of the trading recipe.
    • Some shopkeepers ignore changes to the received items in certain cases. For example, when removing items from a shop container or when adding or removing currency items to or from shop containers, the default shopkeepers will ignore any changes to the received items.
  • Since the received items can now be modified by plugins during the trade event, the event is called earlier now, prior to certain inventory related checks.
    • Breaking: Plugins can no longer assume that the trade will actually take place even if the trade event remains uncancelled.
  • Add a non-cancellable `ShopkeeperTradeCompletedEvent` that is called if the trade actually took place, after all trade effects have been applied.
  • Add `ShopkeeperTradeEvent#getTradeEffects` that allows custom `TradeEffect` instances to be added that are invoked when the trade is either aborted or completed.
    • This can be useful when implementing custom trade effects that are meant to only be executed once the trade is actually applied.
    • This might also be used for some of the built-in default trade effects in the future.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.18.0 for MC 1.20.2, 1.20.1, 1.19.4, 1.19.3, 1.19.2, 1.19, 1.18.2, 1.17.1, 1.16.5

I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md 

• Add compatibility for MC 1.20.2.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to TeamDucks:

 Maybe there is some issue related to saving the shopkeeper trades to disk. Check your server log for errors.
Also, the latest plugin version resolved an issue related to Paper. So if you are using Paper, try out Shopkeepers v2.17.2.

In reply to curiousemo:

 Update to Shopkeepers version 2.17.1.

In reply to ankl115:

 You can create a player shop instead of an admin shop. The stock inside the attached shop chest then limits how often the trades can be used.

In reply to aidaniscoool:

 You can enable the use of color codes inside the config via "name-regex" setting: Set it to name-regex: "[A-Za-z0-9&§# ]{3,256}"

In reply to kubixgames___:

 See https://github.com/Shopkeepers/Shopkeepers-Wiki/wiki/Citizens-Shopkeepers

Once spawned, you can use the normal Citizens npc commands to change the mob type to 'player', set the skin, etc.

v2.17.1 for MC 1.20.1, 1.19.4, 1.19.3, 1.19.2, 1.19, 1.18.2, 1.17.1, 1.16.5

I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md 

• Change the icons of the sign type editor button of hanging sign shop objects from sign to hanging sign items.
• Fix: Plugin not loading on server versions without MC 1.20 hanging sign materials: "The default value for property 'signType' is invalid: Unsupported hanging sign type: 'OAK'."
• On those server versions, there is no valid default hanging sign type.
• Disable the sign type validation on those server versions and adapt all code that previously expected the sign type to always provide valid hanging sign materials.
• The hanging sign object type is now always disabled on server versions without MC 1.20 features.
• Fix: Error "Invalid sign block face: DOWN" when trying to move a hanging sign shop object to the bottom of a block.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.17.0 for MC 1.20.1, 1.19.4, 1.19.3, 1.19.2, 1.19, 1.18.2, 1.17.1, 1.16.5

I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md 

• Add support for 1.20.1. MC 1.20 is not supported!
• Add camel and sniffer to the by default enabled mob types.
• Add bamboo and cherry sign types.
• Add hanging sign shops:
• This is a new shop object type similar to sign shops.
• Required permission: `shopkeeper.hanging-sign` (default: `true`).
• Config option: `enable-hanging-sign-shops` (default: `true`).
• Limitation: Ceiling hanging signs always use the 'attached' state for now, instead of choosing this state dynamically based on the shape of the block above.
• The sign text is now applied to both sides of shop signs, including sign posts, wall signs, hanging signs, and wall hanging signs.
• Drop support for MC 1.18.1 and 1.19.1. These versions are only used by a few servers. Removing their support speeds up build times. MC 1.18.2 and 1.19.4 are still supported and can be updated to without issues.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to skors_saad:

  Consider asking on Discord since this probably requires a bit of back and forth asking questions to figure out. Also, maybe one of the users there already knows this kind of issue.

All I can suggest right is to check the server log for any errors/warnings and to check if the Citizens plugin is correctly saving the NPC.

v2.16.5 for MC 1.19.4, 1.19.3, 1.19.2, 1.19.1, 1.19, 1.18.2, 1.18.1, 1.17.1, 1.16.5

I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md 

• Update for MC 1.19.4.
• Fix: When using `bypass-spawn-blocking`, we now compare spawn locations fuzzily.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.16.4 for MC 1.19.3, 1.19.2, 1.19.1, 1.19, 1.18.2, 1.18.1, 1.17.1, 1.16.5

This update contains a critical fix. It is highly recommended that you update as soon as possible!
I only list the primary changes here. For information on API changes, internal changes, and changes to the language files, you can find the complete changelog on Github: https://github.com/Shopkeepers/Shopkeepers/blob/master/CHANGELOG.md

• Fix: Immediately end the UI session if the GUI is not successfully opened (e.g. if another plugin cancels the corresponding InventoryOpenEvent).
• Fix: Item duplication related to shopkeeper GUIs being opened while another GUI is already open.
• Fix: Update for the latest breaking changes in the Citizens API related to metadata strings. This version of Shopkeepers is only compatible with the latest development version of Citizens!
• Fix: The villager editor did not correctly translate hex color codes of the form "&#555555Test".

API:

• Fix: "Shopkeeper#setName" did not correctly translate hex color codes of the form "&#555555Test". The result used the alternative "&" color code instead of Minecraft's "§" code.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!