Citizens Shopkeepers - Shopkeepers/Shopkeepers-Wiki GitHub Wiki

There is experimental support for shopkeepers using Citizens NPCs as object type. This feature requires the plugin Citizens and can be enabled and disabled inside the Configuration.

When the Citizens plugin is installed and running and this feature is enabled, you can use shop entities that the Shopkeepers plugin doesn't support by itself. Examples are player NPCs and various other unsupported mob types. Supporting these entity types in the Shopkeepers plugin itself would drastically increase the work for maintaining the plugin. Also, Citizens NPCs come with additional features like custom configurable behavior: You can configure them to talk, walk around, etc.

The permission needed to create citizens shops is shopkeeper.citizen.

You can create an admin Citizens shopkeeper with the command /shopkeeper npc.
Alternatively, there is a 'shopkeeper' trait which you can assign to already existing Citizens NPCs. But creating the NPC with the above command is the recommended way of doing it.

Citizens shopkeepers default to a player NPC. For player shops, these NPCs use the name (and thereby skin) of their shop owner. There is a configuration setting that determines whether players are allowed to rename their NPC player shops (default: false).

Note on offline mode servers

On recent versions of Citizens, player NPCs with names that match the names of other online players are not supported on offline mode servers. If you run an offline mode server, you will have to change the default NPC type to something else inside the config with the setting default-citizen-npc-type.

Any other setup of the Citizens shopkeeper NPC, such as changing its type to another mob or changing the NPC player skin, needs to be done via the commands of the Citizens plugin. Note that some operations, such as renaming the NPC or copying it, may not work well for shopkeeper NPCs, because the Shopkeepers plugin takes over some aspects of the NPC setup.