@aeon-games/stock-exchange
v5.0.0
Published
Stock Exchange
Readme
Stock Exchange
Purpose
Stock Exchange is a financial simulation and strategy game within the Aeon Games ecosystem. Players (and agents) navigate a volatile market of futuristic stocks, using news events and historical trends to buy low and sell high. The game tests risk management, pattern recognition, and decisive action in a fast-paced trading environment.
Key Features
- Dynamic Market Simulation: Stocks have varying prices, trends, and volatility levels that evolve each turn.
- News Event Integration: Real-time news items provide clues about upcoming price movements and sector-wide shifts.
- Advanced Trading Options: Support for long positions, short selling, and portfolio management.
- Visual Analytics: Price history charts and trend indicators help players make informed trading decisions.
Key Files
src/index.tsx: Core game implementation, including the market engine, news generation, and trading logic.package.json: Package metadata and dependencies.tsconfig.json: TypeScript configuration.
Usage
The StockExchange component is integrated into the Aeon Games platform:
import StockExchange from '@aeon-games/stock-exchange';
<StockExchange
gameId="neo-tokyo-exchange"
startingCapital={10000}
onSessionComplete={...}
/>Mechanics
- Portfolio: Track cash balance, long positions (shares owned), and short positions (shares owed).
- Market Dynamics:
- Trend: Long-term price direction bias.
- Volatility: Magnitude of random price fluctuations.
- Impact: News events that force immediate and significant price changes.
- Win Condition: Maximize total net worth (cash + position value) over a fixed number of turns.
