MCPcopy Index your code
hub / github.com/P4R1H/StockPiece

github.com/P4R1H/StockPiece @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
253 symbols 533 edges 96 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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: sh git clone https://github.com/yourusername/stockpiece.git
  2. Install dependencies: sh cd frontend npm install cd ../backend npm install
  3. Configure environment variables:
    Create a .env file in the backend directory with the following: env MONGODB_URI=your_mongodb_uri JWT_SECRET=your_jwt_secret
  4. Start the application:
  5. Frontend: sh cd frontend npm run dev
  6. Backend: sh 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: sh git checkout -b feature/newFeature
  3. Commit Your Changes: sh git commit -m 'Add new feature'
  4. Push to Your Branch: sh 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 stockpieceofficial@gmail.com.

Extension points exported contracts — how you extend this code

OnePieceStockMarketProps (Interface)
(no doc)
frontend/src/App.tsx
PriceHistoryGraphProps (Interface)
(no doc)
frontend/src/types/Components.ts
Dataset (Interface)
(no doc)
frontend/src/types/Components.ts
DatasetMeta (Interface)
(no doc)
frontend/src/types/Components.ts
DataPoint (Interface)
(no doc)
frontend/src/types/Components.ts

Core symbols most depended-on inside this repo

asyncHandler
called by 45
backend/src/utils/asyncHandler.utils.js
get_config
called by 11
Bots/Discord/shared_functions.py
pluralize
called by 9
frontend/src/components/Notifications/CustomSonner/CustomSonner.tsx
showError
called by 9
frontend/src/pages/Home/Home.tsx
isWindowOpen
called by 8
backend/src/utils/windowStatus.js
uploadOnCloudinary
called by 4
backend/src/utils/cloudinary.utils.js
asyncHandler
called by 3
emailRegistration/waitlistController.js
getAllowedOrigins
called by 3
emailRegistration/app.js

Shape

Function 164
Interface 41
Method 28
Class 16
Route 4

Languages

TypeScript79%
Python21%

Modules by API surface

frontend/src/pages/Admin/AdminServices.ts21 symbols
frontend/src/components/StockGraph/StockGraph.tsx16 symbols
Bots/Discord/cogs/owners.py13 symbols
frontend/src/types/Pages.ts12 symbols
frontend/src/components/Notifications/CustomSonner/CustomSonner.tsx12 symbols
Bots/Discord/bot.py10 symbols
frontend/src/pages/Admin/imageUpload.tsx9 symbols
frontend/src/pages/Home/Home.tsx8 symbols
frontend/src/pages/Admin/Admin.tsx8 symbols
Bots/Discord/cogs/general.py8 symbols
frontend/src/types/Components.ts7 symbols
frontend/src/pages/Login/LoginServices.ts7 symbols

Datastores touched

AdminCollection · 1 repos
ChapterReleaseCollection · 1 repos
ChapterUpdateCollection · 1 repos
CharacterStockCollection · 1 repos
CouponCollection · 1 repos
ErrorLogCollection · 1 repos
TransactionCollection · 1 repos
UserCollection · 1 repos

For agents

$ claude mcp add StockPiece \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact