Skip to content

P4R1H/StockPiece

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StockPiece – Powerscale like a true capitalist

Market Banner

StockPiece is a unique stock market simulation game set in the One Piece universe. In this fan-made project, players trade character stocks, manage their portfolios, and compete on a leaderboard—all within a dynamic market environment influenced by in-universe events.


Overview

StockPiece provides an engaging and strategic experience by combining stock trading mechanics with popular One Piece elements. Players make investment decisions based on character popularity, trading volume, Manga events on TCB chapter releases. The platform is designed with a modern, responsive interface that adapts seamlessly across devices.


Features

  • Stock Trading: Buy and sell character stocks based on your agendas.
  • Market Windows: Trading sessions open in sync with official TCB chapter releases.
  • Portfolio Management: Monitor your investments and overall net worth.
  • Interactive Charts: Analyze visual price histories and market trends to see what character was popular when.
  • Leaderboard System: Compete with fellow pirates for the highest net worth.
  • Responsive Design: Enjoy a fully mobile-responsive interface.

Getting Started

Prerequisites

  • Node.js (v14+)
  • MongoDB
  • npm or yarn

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/stockpiece.git
  2. Install dependencies:
    cd frontend
    npm install
    cd ../backend
    npm install
  3. Configure environment variables:
    Create a .env file in the backend directory with the following:
    MONGODB_URI=your_mongodb_uri
    JWT_SECRET=your_jwt_secret
  4. Start the application:
    • Frontend:
      cd frontend
      npm run dev
    • Backend:
      cd backend
      npm run dev

Tech Stack

Frontend

  • React with TypeScript
  • Vite
  • CSS3

Backend

  • Node.js
  • Express.js
  • MongoDB

How to Play

  1. Account Setup: Create an account or log in.
  2. Initial Allocation: Receive an initial allocation of 10,000 Berries.
  3. Market Research: Study character stocks and market trends.
  4. Trading: Execute buy/sell orders during open market windows.
  5. Portfolio Tracking: Monitor your investment performance.
  6. Compete: Climb the leaderboard by maximizing your net worth.

Market Mechanics

Stock prices are driven by several key factors:

  • Trading Volume
  • Character Popularity
  • Market Events
  • Market Momentum

These elements combine to create a dynamic and challenging trading environment.


Trading Windows

To maintain fairness and integrity:

  • Opening: Trading opens upon the official chapter release.
  • Closing: Trading concludes before any leaks occur, preventing insider trading.

Contributing

Contributions are welcome. To contribute:

  1. Fork the Repository.
  2. Create a Feature Branch:
    git checkout -b feature/newFeature
  3. Commit Your Changes:
    git commit -m 'Add new feature'
  4. Push to Your Branch:
    git push origin feature/newFeature
  5. Open a Pull Request.

Legal Disclaimer & Credits

This fan-made simulation game is not affiliated with or endorsed by the official One Piece franchise. All One Piece characters, images, and related content are owned by:

  • Eiichiro Oda
  • Shueisha (Weekly Shōnen Jump)
  • Toei Animation

StockPiece is a non-profit project created for entertainment purposes only. No copyright infringement is intended.
For concerns regarding copyrighted content, please contact us immediately at [email protected].

About

The StockPiece is real

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •