Millions - Stock Trading Simulation

Millions is a JavaFX-based stock trading simulation game where players navigate a dynamic market, manage their portfolio, and progress through trading ranks from Novice to Speculator.

Features

Dynamic Market Simulation: Stock prices fluctuate based on trends, noise, and scheduled shocks.
Progression System: Gain status levels (Novice → Investor → Speculator) based on your net worth and trading activity.
Interactive UI: A desktop-style interface with multiple "apps" including a Stock Market, Bank, Mail, and Settings.
Audio Support: Immersive background music and sound effects that change based on game state.
Data Driven: Load custom stock data from CSV files.

Prerequisites

The project includes platform specific installers for MacOS and Windows. Another option is running the application as a JAR directly from the terminal.

Prerequisites for downloading and running within IDE:

Java Development Kit (JDK) 17 or higher).
Maven 3.6 or higher.

Building and Running

Build the Project

To compile the project and download dependencies, run:

mvn clean install

Run the Application

To launch the game, use the JavaFX Maven plugin:

mvn javafx:run

Running Tests

To execute the unit test suite:

mvn test

Project Architecture

The project follows a modified Model-View-Controller (MVC) architectural pattern:

Model: Contains the core business logic and data structures (Player, Stock, Exchange, Share, etc.). Models are independent of controllers and views.
View: Handles the visual representation using JavaFX. Components are organized into views, apps, and components.
Controller: Orchestrates the interaction between models and views. GameController manages the main loop, while specific app controllers handle individual application logic.

Key Components

EventBus: A singleton messaging system for decoupled communication between different parts of the application.
MarketController: Manages stock price updates and history generation.
StockAppController: Handles the trading logic, searches, and portfolio updates.
TimeAndWeatherController: Manages in-game time progression and environmental effects.

Design Decisions

Precision: Used BigDecimal for all financial calculations to avoid floating-point errors.
Thread Safety: UI updates from background timers are wrapped in Platform.runLater() to ensure consistency with the JavaFX Application Thread.
Encapsulation: Collections returned from models (like Portfolio.getShares()) are unmodifiable to prevent accidental external modification.
Validation: Strict input validation in constructors ensures that objects remain in a valid state from creation.

Credits

Developed as a group project by Einar Skøien & Per Eric Trapnes for IDATT2003 - Programmering 2 at NTNU.

einaskoi/Millions

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors 2

Languages

Packages