StockMarket [BETA]

StockMarket is a plugin which allows your players to buy/sell stocks across various stock exchanges in the world using in-game currency. This provides players a way to make/loose money based on the performance of the stocks they buy while providing a risk-free way for your players to learn about the stock market.

If you have PlaceholderAPI installed, you will get access to a few placeholders which are:

%sm_portfolio-value% - Display's the player's portfolio value

Stock Placeholders:
%sm_sd-<symbol>-<point>% - Display various pieces of information on a stock. You may get N/A the first time you attempt to use one of these placeholders on start-up, this happens until the data is loaded in.

Available Points:
name - Example: %sm_sd-ba-name% - Return the full company name.
volume - Example: %sm_sd-ba-vol% - Return the stock's volume.
cap - Example: %sm_sd-ba-cap% - Return the stock's market cap.
server price - Example: %sm_sd-ba-sp% - Return the stock's server price.

In the above examples, BA is used as the stock symbol, BA is the symbol for The Boeing Company.

stockmarket.use - This permission is required for any players who you would like to use any stock market command.
stockmarket.commandbypass - This permission is required for any player that you want to be able to bypass command restrictions when they are enabled that force players to use brokers.

/stockmarket OR /stockmarket help - Displays a configurable help message
/stockmarket list - stockmarket.list - Displays GUI with popular stocks
/stockmarket tutorial - stockmarket.tutorial - Displays tutorial GUI
/stockmarket lookup {symbol} - stockmarket.lookup - Lookup a specific stock
/stockmarket compare {comma separated list of symbols} - stockmarket.compare - Compare a list of stocks
/stockmarket portfolio - stockmarket.portfolio - View your portfolio
/stockmarket portfolio {player} - stockmarket.portfolio.other - View another player's portfolio
/stockmarket transactions - stockmarket.transactions - View your transaction history
/stockmarket transactions {player} - stockmarket.transactions.other - View another player's transaction history
/stockmarket history - stockmarket.history - View the server's 100 most recent transactions
/stockmarket history {symbol} - stockmarket.history - View the transaction history of a specific stock
/stockmarket buy {symbol} {amount, optional, 1 if not included} - Buy a certain amount of stock
/stockmarket sell {symbol} {amount, optional, 1 if not included} - Sell a certain amount of stock

/stockmarket spawnsimplebroker - stockmarket.spawnbroker - Spawn a simple broker (opens list inventory) at the executor's location

Command Aliases: /sm, /stock, /stocks


If you need to update your configuration file, the latest version can be found here: https://github.com/maldahleh/mc-stockmarket/blob/master/src/main/resources/config.yml

The configuration file should be self-explanatory, though feel free to post/PM me any questions and I will get back to you.

This plugin is currently in beta, and thus there is the potential for bugs, please private message me or post any questions/issues in the discussion section and I will try to get back to you within 12-24 hours.

I am open to all feature requests, so please send me your suggestions.

There are two events you can listen to:
StockPurchaseEvent - Called when a player buys stocks
StockSaleEvent - Called when a player sells stocks

There are three API methods you can use:
getPortfolioValue(UUID uuid) - Get the portfolio value of the specified player
getProfitMargin(UUID uuid) - Get the profit margin of the specified player
getPlayerStocks(UUID uuid) - Get the specified player's stocks

Special Thanks to:

Java Profiler