UserManual (enUS)

Sharemarket - UserManual


Usage

You can use this plugin to expand your economy plugin or just for fun or for every other reason. It will add shares that players can buy or sell to earn money. These shares are only virtual, you don´t get any item if you buy them. It works nearly like a real stock-exchange. The price of a share changes dynamicly. It depends on the blocks breaked by players and it depends on some other factors like buying or selling shares. Also every share owner gets a dividend for his share(s).

Install

This only works with Vault and an economyplugin

  1. Download sharemarket.jar (view info below the link at the main page for compatible bukkit version)
  2. Make sure your version is compatible with your bukkitbuild
  3. Make sure you installed Vault and an economyplugin first
  4. Drag and drop the jar to your plugins folder at your server
  5. Reload/ restart your server
  6. Sharemarket should work

If you have questions pm me or eitorf or leave a comment on the main page

Commands

Every command that requires an id also works with the official block name (f.e. "coal_ore") !

If you are not sure how to use a command correctly type ingame /<command> ?

Signs

Sign support was added in version 0.5. Now it´s possible to build [sharemarket] signs where you can buy/sell shares or view information about specific shares. Interact via right-click with a sign. Signs are self-updating, but you can stilll update them with /smsignupdate

To have a quick manual type /sm sign <site number> ingame. Every signs is explained.

Config

Default config should look like this:

# Header
# Choose your language her (German/English)
language: English
# This is the list of shares currently available on your server
# To add a share type "-[1 space]'[id]_[default price]'"
# if your not sure copy one line and just change the numbers or use /smaddshare <id/name> <default price> ingame
#
#To delete shares simply delete the line or use /smremoveshare <id/name> ingame
shares:
- '16_5'
- '17_1'
- '21_40'
- '56_70'
- '59_0.5'
- '129_90'
# This is the tax you have to pay for buying a share in percent
# Only use positive numbers like (1;5;6;22;75)
tax_per_share: 10
# Increase this factor to increase the dividend. Decrease also works
# Only use positive floating point numbers like (1.2; 0.56; 3.0)
dividend_factor: 1.0
# This is the intervall in minutes the dividend is disbursed to all players
# Only use positive numbers like (1;5;6;22;75)
dividend_intervall: 15
# true if you want a message when sharemarket has an update, otherwise false
update_message: true
# true if you want that new players see the introduction command, otherwise false
introduction_command: true
# This is the intervall in minutes all data will be saved
# Only use positive numbers like (1;5;6;22;75)
data_save_intervall: 30
# This is the currency symbol which will be used if vault doesn't detect a smybol
currency_symbol: $
# This is the list of worlds where your signs are
# add new worlds with this syntax: "-[1 space][worldname]"
worlds:
- world
# This is the SQL section, you should know what to write their if you want to us it
SQL:
  host: localhost
  port: '3306'
  user: user
  password: password
  database: mysql

Permissions

/<command> ? shows the permission to use this command.

Also here is a list of all permissions and what there for:

PermissionUsage
sm.*grant you all permissions
sm.user.*all user commands
sm.user.buysmbuy <amount> <name/id>
sm.user.sellsmsell <amount> <name/id>
sm.user.mysharessmmyshares
sm.user.sharessmshares
sm.user.help/sm (sign) or /sharemarket (sign) all /<command> ? with user commands
sm.user.taxsmtax
sm.user.ratessmrates <name/id>
sm.user.introductionsmintroduction
sm.admin.*all admin + user + sign commands
sm.admin.givesmgive <playername> <amount> <name/id>
sm.admin.takesmtake <playername> <amount> <name/id>
sm.admin.reloadsmreload
sm.admin.savesmsave
sm.admin.whoissmwhois <playername>
sm.admin.dividendsmdividend
sm.admin.sharepricesmshareprice <name/id> <new price>
sm.admin.addsharesmaddshare <name/id> <price>
sm.admin.removesharesmremoveshare <name/id>
sm.admin.helpuse all /<command> ? with user + admin + sign commands
sm.sign.*use all signs + build them + destroy them + use all sign commands
sm.sign.buildbuild signs
sm.sign.destroysmsigndestroy <x> <y> <z> + destroy signs
sm.sign.updatesmsignupdate
sm.sign.editsmsignedit <kind of sign> <name/id> <amount> <x> <y> <z>
sm.sign.helpuse /<command> ? with every sign command
sm.sign.use.*right-click all signs
sm.sign.use.buyright-click buy signs
sm.sign.use.sellright-click sell signs
sm.sign.use.viewright-clickview signs
sm.sign.use.totalshareright-click totalshare signs

Verci2