HyperMerchant: Difference between revisions

Revision as of 05:53, 26 August 2013

HyperMerchant

HyperMerchant is a merchant npc for use with HyperConomy shops.

Features include:

An easy to use Inventory based GUI for your players to buy and sell from your HyperConomy shops.

Should work nicely with HyperConomy shop permissions.

Toggleable Merchant off-duty mode. Close any store temporarily with a simple command.

Simple commands to change NPC Greeting, Farewell, Off-Duty, and Deny Service/No Permission messages.

Where to get latest version

HyperMerchant 0.3B is still pending release on bukkit, but the latest dev build is available with the project's source code on github.

HyperMerchant requires the latest dev build of HyperConomy.

How to install

Just copy the HyperMerchant.jar into your plugin folder

How to use

Have a HyperConomy shop already set up.
Create an npc: /create npc my_shopkeeper
Assign npc the hypermerchant trait: /trait hypermerchant
Assign npc to the shop: /hmerchant setshop shop-name

That is it. You can now open that store's menu by interacting with my_shopkeeper.

Other npc commands

/hmerchant offduty - toggle npc off-duty mode.
/hmerchant greeting Hi, welcome to my shop. --- assign what npc will say when clicked upon.
/hmerchant farewell Thanks for the money, dude! --- assign what npc will say when store menu is closed.
/hmerchant closed Sorry, im on my lunch break. --- assign what npc will say when set to off-duty mode.
/hmerchant deny You are not permitted to shop here. --- assign what npc will say if player doesn't have proper permissions.
/hmerchant setshop shop_name_here --- assign what shop's inventory is displayed when npc is clicked on.

HyperMerchant also includes the following conveniance commands:

/remotemenu [shopname] - open a shop's menu from anywhere.
/shopmenu - open the menu of the shop you are standing in.
/rslist - list the names of all stores that can be accessed with /remotemenu command.

permissions:

  hypermerchant.*:
     description: Gives access to all HyperMerchant commands
     children:
        hypermerchant.menu: true
        hypermerchant.remote: true
        hypermerchant.npc: true
        hypermerchant.manage: true
  hypermerchant.menu:
     description: Allow use of the /shopmenu command.
     default: true
  hypermerchant.npc:
     description: Allow interaction with hypermerchant npc.
     default: true
  hypermerchant.remote:
     description: Allow use of the /remotemenu command.
     default: op
  hypermerchant.manage:
     description: Allow use of the /hmerchant command.
     default: op

@@ Line 37: / Line 37: @@
 ==== Other npc commands ====
-* /'''offduty'''    - toggle npc off-duty mode.
+* /'''hmerchant''' ''offduty''    - toggle npc off-duty mode.
 * /'''hmerchant''' ''greeting'' Hi, welcome to my shop.   --- assign what npc will say when clicked upon.
 * /'''hmerchant''' ''farewell'' Thanks for the money, dude!   --- assign what npc will say when store menu is closed.
 * /'''hmerchant''' ''closed'' Sorry, im on my lunch break.    --- assign what npc will say when set to off-duty mode.
 * /'''hmerchant''' ''deny'' You are not permitted to shop here.    --- assign what npc will say if player doesn't have proper permissions.
+* /'''hmerchant''' ''setshop'' shop_name_here   --- assign what shop's inventory is displayed when npc is clicked on.