**# StockMart - Minecraft Cryptocurrency Trading Plugin

StockMart is a comprehensive cryptocurrency market simulation plugin for Minecraft servers. This plugin allows players to buy and sell virtual cryptocurrencies using their in-game economy balance (via Vault/EssentialsX).**

## Features

• 50+ Cryptocurrencies - Trade Bitcoin, Ethereum, and 48 other popular cryptocurrencies
• Beautiful GUI Interface - Easy-to-use trading interface with price graphs
• Dynamic Market - Prices change based on supply and demand
• Multiple Buy/Sell Options - Purchase as little as 0.001 of any cryptocurrency
• Player Portfolio - Keep track of all your cryptocurrency holdings
• Price History - Visual representation of price movements
• Command Support - Use commands or GUI for all trading operations

## Installation

1. Download the StockMart.jar file
2. Place it in your server's plugins folder
3. Make sure you have Vault and an economy plugin (like EssentialsX) installed
4. Restart your server
5. Enjoy trading!

## Commands

• /stockmart or /sm - Open the main trading interface
• /stockmart help - Show all available commands
• /stockmart portfolio - View your cryptocurrency portfolio
• /stockmart buy <symbol> <amount> - Buy cryptocurrency directly
• /stockmart sell <symbol> <amount> - Sell cryptocurrency directly
• /stockmart price <symbol> - Check the current price of a cryptocurrency
• /crypto or /c - Show a summary of your cryptocurrency holdings

## Permissions

• stockmart.use - Allow players to use the StockMart plugin (default: true)
• stockmart.admin - Allow access to admin commands (default: op)

### Trading

1. Open the main interface with /stockmart
2. Browse through the available cryptocurrencies
3. Click on a cryptocurrency to open the buy/sell menu
4. Left-click to buy, right-click to sell different amounts
5. Watch your portfolio grow as you make smart trades!

### Market Mechanics

• Prices update every 5 minutes with natural market volatility
• Buy orders slightly increase the price of a cryptocurrency
• Sell orders slightly decrease the price of a cryptocurrency
• Each cryptocurrency has a price history shown as a simple graph

### Portfolio Management

• View your complete portfolio with /crypto or through the GUI
• See total value of all your cryptocurrency holdings
• Track individual performance of each cryptocurrency you own

## Configuration

The plugin is highly configurable through the config.yml file:

• Adjust price volatility
• Change update intervals
• Customize GUI appearance
• Modify transaction fees
• Personalize messages **

Dependencies**

• Vault - Required for economy integration
• An economy plugin (EssentialsX, etc.)

## Config:

# StockMart Configuration

# Economy settings
economy:
# Minimum purchase amount
min-purchase: 0.001
# Transaction fee percentage (0 to disable)
transaction-fee: 0.5
# Price volatility (higher values mean more volatile prices)
volatility: 3.0
# Price update interval in minutes
update-interval: 5

# GUI settings
gui:
# Main title of the market GUI
market-title: "&6StockMart - Crypto Exchange"
# Title of the portfolio GUI
portfolio-title: "&6StockMart - Your Portfolio"
# Fill empty slots with this material
filler-material: GRAY_STAINED_GLASS_PANE

# Message settings'
#you can translate if you would like!
messages:
prefix: "&6[StockMart] &r"
buy-success: "&aSuccessfully bought %amount% %symbol% for $%cost%"
sell-success: "&aSuccessfully sold %amount% %symbol% for $%value%"
not-enough-money: "&cYou don't have enough money! You need $%cost%"
not-enough-crypto: "&cYou don't have enough %symbol%! You only have %amount%"
price-update: "&6Crypto prices have been updated!"


## Support

If you encounter any issues or have feature requests, please contact the plugin me on discord. **

Enjoy Trading!**
Start your virtual cryptocurrency trading journey today and become a crypto tycoon in your Minecraft world!