RoyalShops

Description
RoyalShops is an NPC Shops plugin which uses Citizens 2.0.16 API and Vault 1.5.6. RoyalShops offers the feature to create NPC shops which are entirely customizable: you can set the title of the shop, the price of each item, custom sounds (including ones in server resource packs), which players can trade with each NPC, and whether or not you can open the shop by right-clicking the NPC. It does not require any configuration files.

Tutorial

1. Make sure you have these dependencies: Vault 1.5.6, Citizens 2.0.16
   
2. Create a shop with the command /npc create <NPC NAME> --trait shop. If you already have a shop created, you can select the NPC by looking at the NPC and typing /npc select
   
3. Once you have created the shop, you can add items to the npc by using /trader additem <buy price> <sell price>
4. If you need to remove an item, remove it using the command /trader remitem <slot id> -- The slot id represents the item in the inventory slot (0-53).
5. If you would like to customize the shop some more, look at the commands below.

Commands

• /trader help
  • Displays these commands in-game.
• /trader remitem <slot id>
  • Removes the item from the slot id given. Slot id starts at 0, and ends at 53.
• /trader additem <buy price> <sell price>
  • Adds the item in hand to the NPC shop for the specified buy and sell price. It will remove the item from the hand when successfully added.
• /trader title <name>
  • Sets the title of the shop name. For example: &4Mooshe's &fBoodylicious &9Shop
• /trader click
  • Toggles whether or not players will be allowed to trade player by right-clicking.
• /trader trade
  • The command which allows players to trade if right-clicking is disabled. The NPC shop must be selected.
• /trader sound <sound> <open|use> <pitch>
  • Sets the specified sound for opening or using the shop at the specified pitch. Pitch is either between 0.0-1.0, or could be set to ? to give a random pitch each time. On what to put for the <sound> variable, use the enumeration names given here, or the server resource pack sound names found in sounds.json.

Permissions

• citizens.shop.npc - Allows players to shop at any NPC, despite if the NPC requires permissions to be set.
• citizens.shop.npc<id> - Allows players to shop at a specific NPC based on its ID. This will be ignored if permissions isn't toggled on that NPC.
• citizens.shop.npc<id>.modify - Allows the player to add/remove items, set shop title, toggle features, and set sounds for a specific NPC.
• citizens.shop.admin - Allows complete control over all of the NPC shops.

Screenshots



---

Any feedback is appreciated. Thank you for using this plugin.