Bukkit

In reply to boulettebill:

 You can log all trades to csv files. But there is no way to view the history in-game.

v2.15.1 for MC 1.18.2, 1.18.1, 1.18, 1.17.1, 1.17, 1.16.5

This version is initially marked as 'beta' because there have been a few larger internal refactors that might have introduced new bugs. If no major issues are reported during a certain period after this version has been published, this version will be promoted to 'release'.
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 

• Fixed: The refactors in version 2.15.0 broke the deletion of shopkeepers of inactive players.

v2.15.0 for MC 1.18.2, 1.18.1, 1.18, 1.17.1, 1.17, 1.16.5

• Added support for MC 1.18.2. Make sure that you are using the very latest build of Spigot 1.18.2, because initial builds of 1.18.2 had some chunk loading related issue that might affect the activation (spawning, ticking, etc.) of shopkeepers.
• Dropped support for all Bukkit versions below 1.16.5 (1.14.4, 1.15.2, 1.16.1-1.16.4).
• Bumped the Towny dependency to version 0.98.1.0 and using the glaremasters repository for it now (Jitpack seems to be having issues with Towny currently).
• Config: The translations repository has been renamed and is now located at https://github.com/Shopkeepers/Language-Files
• Config: Added config option 'placeholder-item' that allows changing the placeholder item (Thanks to oltdaniel, PR #762). It is also possible to disable placeholder items now by setting the item to AIR.
• Config: Changed the default placeholder item type from 'NAME_TAG', which is difficult to obtain in vanilla Minecraft, to 'PAPER'.
• Config: Similar to Mohist servers, we also automatically enable the 'disable-inventory-verification' setting now when we detect that we run on a Magma server.
• Added an editor option to toggle the saddle of horse shopkeepers on and off.
• Data: The shopkeeper data version has changed from '1' to '2'.
• Reduced the range at which shopkeeper mobs look at players from 12 to 6 blocks.
• Command: The "/shopkeeper [shop-type] [object-type]" command no longer suggests completions for disabled shop and object types, or shop and object types for which the executing player does not have the usage permission.
• Improvements related to the deletion of shopkeepers that are owned by inactive players:
  • We now log how many days ago the players were last seen when we delete their shops.
  • Fixed: If the plugin is reloaded, and the still pending asynchronous task that checks for inactive players is somehow taking longer than 10 seconds to complete, and the 'player-shopkeeper-inactive-days' setting is changed to '0' (i.e. disabled) during the reload, there was a chance for shop owners to be incorrectly considered 'inactive' and their shopkeepers deleted.
  • Related to that, this asynchronous task also aborts itself now when it detects that it has been cancelled, which happens when the plugin is disabled.
  • Fixed: When we delete the shops of an inactive player, we now ignore any shops that have already been removed for other reasons in the meantime.
• We log a warning now whenever a shopkeeper mob has been removed due to the world's difficulty being set to peaceful. This warning is only logged once per affected shopkeeper and then skipped until the difficulty has changed.
• It is no longer possible to create mob shopkeepers when they would not be able to spawn due to the difficulty being set to peaceful.
• Improved the feedback messages that are sent when a shopkeeper cannot be created at a specific location: The previously used generic 'shop-create-fail' message was replaced with dedicated messages for the different reasons for why the shopkeeper cannot be created.
• Config: Added setting 'invert-shop-type-and-object-type-selection' (default: 'false'), which allows to invert how the shop type and the shop object type are selected with the shop creation item. This might for example be useful for servers that disable all shop types but one.
• Config: Added setting 'ignore-failed-server-assumption-tests' (default: 'false'), which allows to enable the plugin anyway, even when a server incompatibility has been detected during the initial server assumption tests.
• Fixed: Citizens shopkeepers are able to move, teleport, and change their location while the Shopkeepers plugin is not running, or while the shopkeeper's chunk is not active currently. Previously, we only updated the shopkeeper's location during shopkeeper ticking, i.e. when the shopkeeper's chunk has been activated. However, if the NPC was moved to a different chunk (or even world), and the shopkeeper's previous chunk has never been activated since then, the spawned NPC might no longer have been recognized as a shopkeeper. One noticeable effect of this was that the NPC could no longer be interacted with. This has been fixed by also updating the shopkeeper's location in various other circumstances now.
• Fixed: A related but more minor issue has been that Citizens NPCs can already be spawned while their chunk is still pending to be activated by the Shopkeepers plugin. During this short time period (roughly one second after chunk loads), the Citizens NPCs were not yet recognized as shopkeepers. This has been fixed by separating the registration of ticking (i.e. active) shopkeepers from the registration of spawned shop objects: Citizens shopkeepers now register their NPC entity already before the chunk is activated.
• Fixed: We no longer attempt to save the data of Citizens shopkeeper NPCs when the corresponding NPC has not yet been created (i.e. when no NPC has been attached to the shopkeeper yet).
• Fixed: Updating a shopkeeper's location also updates the shopkeeper's activation state now. Previously, it was possible for a shopkeeper's new chunk to not get activated until the chunk is reloaded.
• Command: Added command "/shopkeeper setCurrency ['low'|'high']", which allows you to change the currency item(s) from in-game.
• Permission: Added permission 'shopkeeper.setcurrency' (default: 'op') which provides access to the new set-currency command.
• Fixed: When setting the zero currency item to AIR, the selling and book shopkeepers were not able to derive the price of a trade from the editor when only the high currency price is specified.
• Added placeholder items for empty trade slots inside the editors of player shops.
  • Config: Added various settings to specify the editor placeholder items for empty slots of partially set up trades (default: barriers, as it has been the case before), as well as for completely empty trade columns (default: gray stained glass panes).
  • When you disable the high currency inside the config (by setting it to AIR), you will now need to manually adjust the corresponding empty placeholder items for the affected high currency slots (for example by setting them to AIR). This is a compromise that allows these slots to be set to arbitrary items, even if the high currency is disabled.
  • Added display names and lore to these placeholder items that explain their purpose and usage inside the editor.
  • Config: The settings for the zero currency items are no longer used (they have been replaced with new settings) and are automatically removed during a config migration.
  • The "checkItem" command no longer compares the held items with the zero currency / editor placeholder items.
• Config: Bumped the config version to 5.
• Command: The "give" and "giveCurrency" commands no longer allow item amounts greater than 1024. Previously, these commands silently truncated any amounts greater than 1024.
• Command: The "giveCurrency" and "setCurrency" commands refer to the low currency as 'base' currency now.
• Command: Different types of command executors (e.g. command blocks and the console) no longer share their pending confirmation state.
• Command: Confirmations account for proxied command senders now: Since the original caller of the command receives the command's feedback messages, we also require confirmation from the original caller.
• Fixed: When removing or translating color codes in text we also account for Bukkit's hex color code now (x).

API changes, internal changes, and changes to the language files: See the complete changelog for details.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to deek0_:

 Players can create 'trading shops'. The configured currency item is only used by the selling and buying shops. See the wiki on how trading shops are created and how their trades are set up.

In reply to Daeronn_:

 Nope, the trading interface only allows 1 stack of output items.
You could however sell a shulker box that contains multiple stacks of cobblestone.
Or you set up a trade for some 'cheaper' input item: E.g. assume that 8 gold ingots are worth 1 emerald on your server, you could set up a trade of 4 gold ingots for 1 stack of cobblestone. However, if you are trying to set up a player shop, you will then have to use a 'trading' player shop, instead of a 'selling' one (see the wiki on how that type of shop is set up).

In reply to Simukani:

 This is on the todo list.

In reply to 2malte2:

 As admin: "/shopkeeper give"
 You can then set up some admin shopkeeper that sells the item to your players.

v2.14.0 for MC 1.18.1, 1.18, 1.17.1, 1.17, 1.16.5, 1.15.2, 1.14.4

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

• Updated for MC 1.18 and MC 1.18.1.
• Updated the 'compatibility mode' implementation, which broke with the Miecraft 1.18 update. However, due to some server internal mapping changes, it is likely that this compatibility mode will break again in future updates.
• Added the option for admins to create and restore snapshots of shopkeepers.
  • Each snapshot captures the shopkeeper's dynamic state (i.e. its trades, shop object configuration, etc.), a timestamp, and is associated with a unique name that is provided when the snapshot is created.
  • The name can currently be at most 64 characters long and not contain any color codes.
  • This feature is currently meant to only be used by admins and third-party plugins. Shop owners are not yet able to create and restore snapshots of their own shops.
  • The shopkeeper data of snapshots is automatically migrated during plugin startup, just like the shopkeeper's normal data.
  • Shopkeeper snapshots are currently expected to be used sparsely. In order to guard against the unnoticed creation of excessive amounts of snapshots, we log a warning whenever a shopkeeper has more than 10 snapshots.
  • When formatting the timestamp of a snapshot for display, we currently use the server's default time zone. There is no option in Shopkeepers yet to use a different timezone. If you want to use a different timezone for formatting the timestamps, you can change your server's default timezone via the JVM command line argument '-Duser.timezone=America/New_York' when you start your server.
  • Command: Added commands '/shopkeeper snapshot [list|create|remove|restore]' to manage shopkeeper snapshots.
  • Permission: Added permission 'shopkeeper.snapshot' (default: 'op') that provides access to the new snapshot commands.
  • Experimental: It is also possible to capture and restore the NPC state of Citizens NPC shopkeepers.
    • Config: Added setting 'snapshots-save-citizen-npc-data' (default: 'true') that controls whether shopkeeper snapshots capture and restore Citizens NPC data.
    • When this setting is disabled, the Shopkeepers plugin automatically deletes all previously saved NPC data again.
    • Capturing the data of a Citizens NPC will not work if the NPC is not available at the time the snapshot is created (e.g. if the Citizens plugin is not running currently).
    • If the Citizens NPC is not available when a snapshot is restored, the shopkeeper remembers the NPC data until the NPC becomes available again and the stored NPC state can be applied. If another snapshot is restored in the meantime that does not store any NPC data, we retain the previously restored but not yet applied NPC state.
• Added editor options to change the puff state of puffer fish, as well as the pattern and colors of tropical fish.
• Added sound effects when a trade succeeds or fails.
  • Config: These sound effects can be changed or disabled (by setting their volume to zero) via the new config settings 'trade-succeeded-sound' and 'trade-failed-sound'.
• Added settings to simulate the trading sounds of vanilla villagers and wandering traders.
  • Config: Added setting 'simulate-villager-trading-sounds' (default: 'true').
  • Config: Added setting 'simulate-villager-ambient-sounds' (default: 'false').
  • Config: Added setting 'simulate-wandering-trader-trading-sounds' (default: 'true').
  • Config: Added setting 'simulate-wandering-trader-ambient-sounds' (default: 'false').
  • Config: Added setting 'simulate-villager-trading-sounds-only-for-the-trading-player' (default: 'true').
  • By default, we now simulate the trading sounds of villagers and wandering traders for the trading player. These sounds are only played if the trading player is in the vicinity of the shopkeeper. Trading remotely will not play these sounds.
  • Debug: Debug output for these simulated villager sounds can be enabled via the existing debug option 'regular-tick-activities'.
• Shopkeepers store the yaw angle now with which they are initially spawned.
  • When placing a shopkeeper on top of a block, the yaw angle is chosen so that the shopkeeper faces towards the player who is creating the shopkeeper. When placing a shopkeeper against the side of a block, the shopkeeper is rotated according to the direction of the targeted block side.
  • Existing shopkeepers will have a yaw of 0, i.e. they face south just like before. In the future, it will be possible to reposition shopkeepers and thereby also adjust the yaw of already existing shopkeepers. But this is not yet available.
  • Data: Sign shopkeepers no longer store their sign facing. Instead, this facing is now derived from the shopkeeper's yaw. Existing sign shops will automatically migrate their currently stored sign facing to the shopkeeper's yaw.
  • Shopkeeper mobs will rotate back to their initial direction now when there is no player to look at. However, this requires a player to still be somewhat nearby, since we only tick shopkeeper mobs when players are nearby.
• Config: Added setting 'set-citizen-npc-owner-of-player-shops' (default: 'false').
  • When enabled, we set the Citizens NPC owner of player-owned NPC shopkeepers. When disabled, we automatically remove any previously set Citizens NPC owners from those player-owned NPC shopkeepers again.
  • By enabling this setting, and configuring the Citizens command permissions for your players accordingly, you can allow shop owners to use the commands of the Citizens plugin to edit the Citizens NPCs of their NPC shopkeepers.
• Fixed: Wandering traders and trader llama shopkeepers despawned roughly every 40 minutes due to Minecraft's despawning timer still being active for these mobs, even when their AI is disabled. However, this issue has been rather minor, because the affected shopkeepers automatically respawned a few seconds afterwards. This issue has now been fixed by setting the 'DespawnDelay' of wandering traders to '0' and marking trader llamas as 'tamed', which disables Minecraft's despawning timer for these mobs.
• Fixed: We were not able to detect item stack deserialization issues, because Bukkit only logs an error in this case instead of throwing an exception. This also resulted in the loss of shopkeeper data when someone tried to revert from one server version to an older one, because the loading of item stacks that were saved on a newer server version is not supported by Bukkit. We are now able to detect these deserialization issues and then shut down the plugin before any data is lost.
• Fixed: Shopkeepers could lose some of their trades during item migrations. When an item was migrated, but the subsequent trades did not require any item migrations, these subsequent trades were lost. However, it was relatively unlikely to encounter this issue in practice. An exception to this is in combination with the following Paper-specific issue that only affects trades with certain enchanted book items.
• Fixed: On Paper servers, the comparisons of enchanted book items with multiple stored enchantments were not working as expected. The issue was caused by the server reordering the stored enchantments in some cases, as well as Paper automatically converting any deserialized Bukkit item stacks to CraftItemStacks, which behave differently when being compared to other CraftItemStacks. One known effect of this was that the above issue of trades potentially being lost due to item migrations would be encountered more likely on Paper servers, because the reordering of these stored enchantments would be detected as an 'item migration' by the Shopkeepers plugin. It also caused an unnecessary save of all shopkeeper data after every plugin reload.
• Fixed: The "/shopkeeper removeAll" command always tried to remove all player shops, instead of only the shops of the executing player.
• Data: Various kinds of invalid shopkeeper data and failed data migrations that have previously been ignored or only triggered a warning are now checked for and will prevent the shopkeeper from loading. Most notably, this includes the data of shopkeeper offers, and the hire cost item of player shops. Previously, this invalid data would be cleared. Now, it is retained for a server admin to investigate the issue.
• Data: It is invalid now to mix legacy and non-legacy book offer data (changed during late MC 1.14.4).
• When shopkeepers of inactive players are removed, we now trigger an immediate save, even if the 'save-instantly' setting is disabled.
• Versioning: Snapshot builds will now include the Git hash in their plugin version.
• Debug: The 'shopkeeper-activation' debug option will now log additional details about every single shopkeeper activation and deactivation, instead of only logging a summary about how many shopkeepers were activated per chunk.
• Various minor changes to error and debug log messages:
  • Some error and debug log messages have slightly changed.
  • Log messages involving a specific shopkeeper are more consistently formatted now.
  • Some groups of error messages are now logged as a single message.
  • In a few remaining cases, stack traces are no longer printed directly to the server log, but through the plugin logger.
• During the initial plugin startup, we now test if the server meets certain basic assumptions about its API implementation. In order to prevent damage due to unexpected server and plugin behavior, the plugin shuts itself down if any of these assumptions turn out to be incorrect. These tests are meant to be lightweight, but may be expanded in the future.
• Debug: Added a debug log message whenever a player tries to set an invalid shop name.
• Debug: Added a debug log message when the creation of a Citizens NPC fails.
• Data: Removed various 3 year old data migrations:
  • We no longer check for and remove entity uuids from the data of living entity shopkeepers.
  • The object data of shopkeepers is expected to be located in its own dedicated 'object' section.
  • The stored object type identifiers of shopkeepers are expected to perfectly match the registered shop object types. They are no longer normalized and fuzzy matched.
• Data: We no longer generate a new unique id if the shopkeeper data is missing the shopkeeper's unique id. Instead, the loading of the shopkeeper fails now in this case.
• Data: All item stacks are now (shallow) copied before they are saved to the shopkeeper data. This prevents SnakeYaml from representing the item stacks using anchors and aliases (a Yaml feature) inside the shopkeepers save file if the same item stack instances would otherwise be saved multiple times in different contexts.
• Command: For consistency among commands, and to avoid certain ambiguous command parsing cases, the "edit", "remote", and "remove" commands no longer merge trailing arguments to derive the target shopkeeper name. It is still possible to target shopkeepers with names that consist of multiple words by using a dash as word separator instead of a space.
• Command: Shopkeeper and entity command arguments now propose the ids of targeted shopkeepers and entities.
• Fixed: The "testSpawn" debug command would respawn the shopkeepers in the executing player's chunk, but would not immediately update their object id registrations. The shop objects will now automatically and immediately inform the shopkeeper registry about those object id changes.
• Fixed: When changing the container location of a player shop via the API, the protection for the previous container was not properly disabled.
• Fixed: Any code that retrieves the container block of a player shopkeeper accounts now for the fact that the block might be null. This was only really an issue when another plugin invokes internal operations that require the container block to be available in a situation in which it might not be available currently.
• Fixed: The order of the enabled living shop object types was not updated on plugin reloads based on their order inside the config.
• Debug: Removed the debug option 'capabilities' again. We already always log whether server version specific features are enabled. This also resolves an internal issue related to whether the config has already been loaded at the time this debug option is checked.
• Fixed: In order to resolve compatibility issues with plugins that modify chat messages at lowest event priority, we now enforce that our chat input event handler always executes first. This should resolve compatibility issues with shopkeeper names not being considered valid, because some other plugin injected color codes into the player's chat message before we were able to process it.
• Fixed: Since Bukkit 1.16.5, the data version was no longer guaranteed to be the first entry of the save file, and the log message for the number of loaded shopkeepers has been off by one if the save file did not contain any data version yet.
• Fixed: We now check if the UI session is still valid before handling an inventory event at the HIGH event priority. Previously, the UI session was simply expected to still be valid. But this assumption can be violated by plugins that (incorrectly per API documentation) close the inventory during the handling of an inventory event.
• Fixed: Sound effects played to players would sometimes appear to be played slightly to the left or the right of the player's head.
• Fixed: When a NPC player shopkeeper moved to a different world, its container location (which is currently expected to always be located in the same world as the shopkeeper) and the protection of the container were not getting updated.
• Data: Under certain circumstances, one of the publicly posted snapshots of this update accidentally saved shopkeeper ids as normal attributes into the save file. The save file data version was bumped from 2 to 3, so that any previously saved shopkeeper ids are automatically removed again.
• Data: Improved the detection of server and plugin downgrades.
  • We now use the data version that is stored inside the Shopkeepers save file to detect Minecraft server and Shopkeepers plugin downgrades. When a downgrade is detected, we log an error and disable the plugin to prevent any potential loss of data.
  • There is one minor issue with this: After server downgrades, Spigot fails to load item stacks that are stored inside the save file. This causes the loading of the save file to fail before we are able to extract the data version. Our own Minecraft server downgrade check will therefore usually not actually be reached. However, the plugin will disable itself in this situation anyway. But the error message will then be different and more verbose. It should, however, also mention that the server downgrade is the issue.
  • In order to be able to more reliably detect downgrades of the Shopkeepers plugin that might affect the saved shopkeeper data, we added a new 'shopkeeper data version' component to the data version that is stored inside the save file. The previous 'shopkeeper storage version' was, and still is, used for changes that require a save of all shopkeepers, such as for example when the storage format has changed. The new shopkeeper data version, however, is meant to be incremented more frequently, namely after every change to the data format of shopkeepers and shop objects. Usually, these changes only affect a subset of the shopkeepers and shop objects, so no full save of all shopkeepers is required when this data version component has changed.
  • These shopkeeper and shop object data format changes also include the addition of new shopkeeper or shop object attributes: Since older plugin versions are not aware of these new attributes, the data for these attributes can get lost when an older plugin version would be allowed to load and later save shopkeepers that previously contained data for these attributes.

API changes, internal changes, and changes to the language files: See the complete changelog for details.

Known potential issues: See here.

Donations

If you like this plugin, consider making a donation.

Thanks!

In reply to Cloude_lecaw:

CurseForge upload approval times are out of my control (and I don't really mind them). In the future, I will probably avoid posting the changelog until the upload has been approved, to avoid any kind of confusion.

In reply to Cloude_lecaw:

 Apparently they don't review file uploads on fridays and saturdays (I did not know that), hence the additional delay.

In reply to synchroniceyt:

 Now (but it may take another day or so for the update to be approved by CurseForge staff and available for download)