StockMarket [BETA] 1.3.0

Allow players to buy/sell stocks in game

  1. maldahleh
    Native Minecraft Version:
    Legacy (< 1.13)
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    Source Code:
    https://github.com/maldahleh/stock-market
    [​IMG]
    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.

    Dependencies
    Vault and a Vault compatible economy plugin
    - Used for economy integration.
    Citizens - Optional - Used for stock brokers
    PlaceholderAPI - Optional - Used for providing placeholders.

    PlaceholderAPI Placeholders
    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.

    [​IMG]
    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


    [​IMG]
    If you need to update your configuration file, the latest version can be found here: https://github.com/maldahleh/stock-market/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.

    [​IMG]
    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.

    Developers
    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:
    [​IMG]
    Java Profiler
    galacticwarrior likes this.

Recent Reviews

  1. ithinkthere4iam
    ithinkthere4iam
    5/5,
    Version: 1.3.0
    This plugin is amazing! I just don't understand the " allowed-currencies:
    - "USD"
    - "CAD"" in the config.
  2. LegendDoubleB
    LegendDoubleB
    5/5,
    Version: 1.3.0
    I am so glad to have this plugin back! Just like it was before, but even better. If you want stocks in minecraft, this plugin beats them all!
  3. galacticwarrior
    galacticwarrior
    5/5,
    Version: 1.2.7
    Like last time, I had a feature request and the author promptly updated the plugin within hours. Excellent support and incredible plugin.
  4. Richardjmanning
    Richardjmanning
    5/5,
    Version: 1.2.4
    GREAT plugin, I have had a small issue with selling amazon stocks, messaged the dev who replied within hours, then sat with me on discord and has helped check and is now patching.

    GREAT support and a fun addition to any economy server :)
    1. maldahleh
      Author's Response
      Thanks for the review :) Glad you like the plugin.
  5. galacticwarrior
    galacticwarrior
    5/5,
    Version: 1.0.0
    It has been a long time since a free stock market plugin has been released - and even longer since an actively maintained one was released. Excellent work and I hope you continue to support this project for the foreseeable future.
    1. maldahleh
      Author's Response
      Thanks for the review :) I definitely have plans to actively maintain and support this project.