Bukkit

v2.26.1 for MC 26.1.2, 1.21.11, 1.21.10, 1.21.8, 1.21.7, 1.21.6, 1.21.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 26.1.2.
  • MC 26.1 and 26.1.1 might work but are not officially supported.
• Config: Add setting enable-closing-of-player-shops (default: true) that controls whether shop owners can close their shops.
• Config: Add setting force-open-player-shops (default: true) that controls whether player shops are automatically reopened if enable-closing-of-player-shops is disabled.
  • This setting has no effect if enable-closing-of-player-shops is enabled.
  • Note: Since we do not track whether a shop was closed by the shop owner or the API, this also effectively disables the closing of player shops via the API or when restoring shop snapshots. If you want shops to still be closable via the API or when restoring snapshots, you can temporarily enable this setting after after having disabled enable-closing-of-player-shops, restart the server to update all player shops, and then disable this setting again. However, be aware that the open state in any previously captured shop snapshots is not automatically updated: This setting is only taken into account at the time a snapshot is restored.
  • Debug: When the debug mode is enabled, we log whenever a player shop is forcefully re-opened.
• Fix: Since the last update, mob equipment and default potion effects were no longer applied on spawn.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.25.0 for MC 1.21.11 1.21.10, 1.21.8, 1.21.7, 1.21.6, 1.21.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 Minecraft 1.21.11.
  • Add support for new mob types:
    • Camel husk: Similar editor options as camel.
    • Nautilus: Supports baby variant, saddle and armor.
    • Zombie nautilus: Supports saddle, coral variant and armor.
    • Parched: Similar editor options as other skeleton types.
  • Horse shopkeepers: Add support for netherite horse armor.
• Drop support for Minecraft versions below 1.21.5. This has the following benefits:
  • Modernize the plugin by building against a more modern Bukkit version.
  • Reduce the plugin size by bundling fewer compatibility modules.
  • Simplify updating the plugin for new Paper versions: For versions before 1.21.5, the Spigot and Paper versions shared the same compatibility code, which required building all Paper modules against the Spigot mappings. But since Paper usually releases their Spigot mapping support after some delay, updating the plugin to support the latest Minecraft version on Paper was also delayed.
• Command: Add command /shopkeeper history [player|'all'|'self'] [shop=...|owner=...|'own'|'player'|'admin'|'all'] [page].
  • Permission: shopkeeper.history.own (default: true): Allows viewing the own trading history.
  • Permission: shopkeeper.history.admin (default: op): Allows viewing the trading history of others and admin shops.
  • Example: /shopkeeper blablubbabc shop=Test shows the trading history of player "blablubbabc" with the shopkeeper named "Test" (assuming there is only a single shopkeeper with this name). You can also target a specific shopkeeper via their id, unique id, or by looking at them in-game.
  • The player and owner argument also support the look-up of offline players, taking into account the currently existing shop owners, and existing online mode players. However, the plugin does not check the trading history to find offline players by name.
  • Only the currently existing shopkeepers can be specified by name or id. To look up the trading history of a no longer existing shop, use their unique id.
  • If the owner of a shop has changed, a player without the shopkeeper.history.admin permission can only view the trading history of the shopkeeper from when they still owned the shop.
  • Config: This command is currently only supported when using trade-log-storage: 'SQLITE'.
  • Config: Item metadata (e.g. item display names) can only be retrieved when the trade was logged while using log-item-metadata: true.
  • Debug: If we fail to load the stored item metadata (can for example be the case when there have been backwards incompatible changes across server updates), we log the error in debug mode but otherwise silently ignore it and display the item without the metadata in the history.
  • Trade log: Depending on the trade log merging configuration and the hard-coded IO buffering delay, it can take a few seconds for trades to show up in the trading history. In order for trades to show up in the trading history more quickly, the IO buffering delay (the delay before logs are persisted to the database) is reduced from 30 seconds to 10 seconds. With this change and the default trade log merging configuration, it now takes 10-25 seconds for trades to show up in the trading history, versus the 30-45 seconds from before.
  • In the command output, players have their uuid as hover text and shops have their shopkeeper uuid as hover text.
• Command: The /shopkeeper teleport command shows the shopkeeper uuid as hover text in the success message now.
• Fix: Consider copper chests valid shop containers.
• Fix: Automatically create missing parent directories for the SQLite trade log.
• Fix: Repeat the setup of the SQLite trade log database if an error occurred during a previous save attempt.
• Fix: Baby zombies would occasionally spawn or mount nearby chickens. Disable spawn data randomization.
  • We also cancel any entity mounting events for shopkeeper mobs now, in case there are ever any cases in the future in which mobs might try to mount other mobs, outside of spawning.
• Fix: UnsupportedOperationException during config loading when the missing default value for shop-creation-item is inserted.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.24.0 for MC 1.21.10, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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 Minecraft 1.21.10.
  • Note: 1.21.9 is not supported and has been superseded by 1.21.10.
  • Update the fallback compatibility module.
  • Add copper golem to the by default enabled mob types.
    • It supports the hand, offhand, head and saddle equipment slots.
    • Its oxidation level is fixed and can be changed via the editor.
  • Add mannequin to the by default enabled mob types.
    • It does not rotate towards nearby players.
    • Equipment is supported but only works with the latest Spigot versions (see SPIGOT-8087).
    • The main hand and pose can be toggled via the editor. Note: Some of the poses have a very small hitbox.
    • We hide the default "NPC" description from the nametag. There is no editor option to customize the description yet.
    • The skin can be specified via the editor by entering the name or uuid of an existing player in chat.
      • On Spigot, the profile lookup by name uses a blocking player id lookup as a workaround for some issue currently (see SPIGOT-8088).
      • There are no editor options yet to customize the profile in other ways or hide individual skin layers.
• Add armor stand to the by default enabled mob types.
  • The editor supports toggling the base plate, arms, and size, as well as equipping items.
• Config: Changes to the item data format inside the config.
  • The new format aligns more closely with how Minecraft represents item data and how we represent item data inside the save file.
  • We now use Minecraft's item type ids instead of Bukkit's material names.
  • Additional item data components are represented in SNBT.
  • Example:
    Old:

    shop-creation-item:
      type: VILLAGER_SPAWN_EGG
      display-name: '{"text":"Shopkeeper","italic":false,"color":"green"}'

    New (1.20.5+):

    shop-creation-item:
      id: 'minecraft:villager_spawn_egg'
      components:
        minecraft:custom_name: '''{"color":"green","italic":false,"text":"Shopkeeper"}'''

    New (1.21.5+): SNBT instead of JSON for text data.

    shop-creation-item:
      id: 'minecraft:villager_spawn_egg'
      components:
        minecraft:custom_name: '{color:"green",italic:0b,text:"Shopkeeper"}'

  • Your existing config is automatically migrated to the new format.
  • Add new setting data-version: This setting is automatically updated whenever you migrate to a new server version and used to automatically migrate your item data inside the config.
  • We no longer convert between legacy and alternative color codes. For recent Minecraft versions, the use of Minecraft's JSON / SNBT text representation is recommended.
• Config: Changes to how we compare the data of config items such as the shop creation item.
  • Previously, we tried to emulate Minecraft's NBT data matching based on Bukkit's item serialization output. This approach was not ideal: Bukkit's item serialization comes with overhead and its output does not perfectly match Minecraft's item NBT structure. And on recent versions of the Paper server, the Bukkit item serialization has been deprecated and might no longer receive updates.
  • The item matching implementation was updated to directly use Minecraft's underlying NBT comparison logic.
  • However, this also means that this logic is now part of the plugin's Minecraft version specific code that must be updated for every new version of Minecraft. A reflection based fallback implementation is available for Spigot servers, but is likely to break across server updates as well.
  • To more closely align with Minecraft's NBT matching logic used in commands and by the custom_data predicate, we also match partial lists now. Previously, we would not match partial lists to more closely align with how items are compared in villager trades. But in newer versions, the item comparison in villager trades has become more strict. And for the matching of config items, we prefer a more lenient partial matching of item data.
• Data: Remove the item conversion feature.
  • This feature was used as a workaround in the past to help server owners deal with changes to the internal item data representation across server versions. Since then, there have been changes in Spigot to better preserve text data during serialization. And with the introduction of item data components in MC 1.20.5 and the changes to how Minecraft itself normalizes and compares item data now, this feature should no longer be required. Also, especially on Paper servers, this feature might break items since it relies on Bukkit's serialization and deserialization of ItemMeta, which is deprecated on Paper servers.
  • Command: Remove command convertItems and related permissions shopkeeper.convertitems.own and shopkeeper.convertitems.others.
  • Debug: Remove debug option item-conversions.
  • Config: Remove settings convert-player-items, convert-all-player-items and convert-player-items-exceptions.
• Data: Use default salmon variant if missing.
• Fix: Shopkeeper mobs no longer equip items from dispensers.
  • These equipment items are not persisted and permanently lost once the shopkeeper is respawned. Instead, use the shopkeeper editor to add equipment to shopkeeper mobs.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to shadowsoul3838:

 No, this plugin only support item trades. It does not work with virtual currencies and it does not use any of Minecraft's scoreboard features.

v2.23.10 for MC 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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.21.8 (Paper support).

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to powerofx6557_31599:

 You need to use an older plugin version for that. Try 2.22.3: https://dev.bukkit.org/projects/shopkeepers/files/5569421

v2.23.9 for MC 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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.21.7.
• Data: Minor internal changes to item serialization and handling of deserialization issues.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.23.7 for MC 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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.21.6.
  • Add happy ghast to the by default enabled mob types.
    • It supports a baby variant and a colored harness can be equipped to its body slot.
    • It does not seem to look at players currently when turned to its baby variant or back.
  • Update the fallback implementation.
• Config: Avoid inserting default settings if the loaded config data is completely empty.
  • The config data can also be empty if the config file failed to load. Inserting the default settings in this case would overwrite the user's current config.
  • To reset the config to its default values, it is now required to fully delete the config file. Only clearing the config file is not longer sufficient.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

v2.23.6 for MC 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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

• Data: Change the serialization of item stacks from Bukkit's built-in serialization to a custom serialization that saves item components as SNBT. Be sure to backup your current save.yml file before updating to this version!
  • This has the following expected benefits:
    • Better debugging of serialized item data: The data is serialized in a format that Minecraft users are familiar with and can find information about in the official Minecraft wiki.
    • Better compatibility across Minecraft server versions: We pass the deserialized data through Minecraft's own data migration system, which should hopefully reduce the need for manual data migrations after server upgrades.
    • Better compatibility across server variants: Spigot and Paper servers have diverged in how they serialize item stacks. Paper already saves item stacks in a format similar to the one used by the Shopkeepers plugin now. But by not relying on the specific server's built-in serialization, saved item data is expected to more easily be transferable across server variants.
  • The shopkeeper storage version is bumped to 4 to automatically write all item data in the new format.
  • The new serialization relies on server version specific code. A reflection-based implementation for Spigot mappings is provided for the "fallback mode" when running on a non-supported server version, but this is prone to break during server updates.
  • Since all item data is migrated via Minecraft's data migration now, before the item stack is constructed, our previous item data migration logic can eventually be removed, together with the item-migrations debug option, once all servers are expected to have updated to the new serialization format.
• Fix #959: The changes to the shopkeeper trade event in v2.19.0 introduced a bug that caused shift trading to continue trading even if the the active trade switches to a different result item. Additionally, we now also abort the trading if the cost items of the active trading recipe have changed, so that players don't accidentally continue trading the same result item but for different costs.
• Localization: Use the default message when the specified language file is missing an entry.
• Debug: Log the full exception stack trace when we fail to load the data of a shopkeeper.
• Debug: The fallback mode can now be tested by adding a file with name .force-fallback to the plugin folder.
• Internal: Various refactors related to UIs.
• API: Revert nonpe version back to 1.3.5 for now until 1.3.6 has been released to Maven central. This resolves an issue with API clients being required to also add the nonpe snapshot repository to their projects.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to Creeperboy402:

 I don't know. If they allow you to upload plugin jars manually, you can download it here and upload it to the server. If they don't support that, you have to check their repository and ask their support.

v2.23.5 for MC 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6

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

• If available, use the item's custom display name in trade notification messages.
• Performance: Further optimize the handling of the BlockPhysicsEvent for sign shopkeepers: Instead of checking during each block physics event whether the event shall be cancelled because the block or one of its neighbors would be affected by the event (7 checks), we pre-calculate the set of affected block locations and then only perform a single map lookup during the event (1 check).
• Performance: Optimize shulker peek AI: Only update the peek state if actually necessary to avoid redundant game events and other side effects.
• Performance: Remove the PlayerMap "optimization" again: It does not provide a clear benefit, but adds additional complexity and potential for bugs and memory leaks.
• Fix: It was still possible to spawn or move shopkeepers into protected GriefPrevention regions. When using the check-spawn-location-interaction-result, we now temporarily spawn a dummy chest block at the checked location to ensure that region protection plugins like GriefPrevention actually react to our dummy interaction test event.
• Fix: Mark shopkeepers as dirty when a property value is found missing and the default value is being used.
  • As before, we log a warning and then fall back to the default value for missing property values. This is for example often the case when new properties are added.
  • However, previously, we would not mark the shopkeeper as dirty in this case since the default value also equals the initial property value. One consequence of this was that the warning about missing property values would be repeated over and over during subsequent plugin reloads.
• Fix: Add a Paper-specific 1.21.5 module to resolve issues related to trade notifications and pig, cow and chicken variants.
• Paper: Omit redundant 'id' and 'count' properties when logging the metadata of items involved in trades.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to adixon3877:

 Try https://dev.bukkit.org/projects/shopkeepers/files/5569421