https://github.com/nahkd123/stonks

Global market mod for top selling block game
https://github.com/nahkd123/stonks

bazaar fabric minecraft mod modding server-mod

Last synced: about 1 month ago
JSON representation

Global market mod for top selling block game

• Host: GitHub
• URL: https://github.com/nahkd123/stonks
• Owner: nahkd123
• License: mit
• Created: 2023-08-07T18:01:41.000Z (almost 2 years ago)
• Default Branch: main/1.21.x
• Last Pushed: 2025-04-09T21:47:26.000Z (about 1 month ago)
• Last Synced: 2025-04-09T22:29:11.848Z (about 1 month ago)
• Topics: bazaar, fabric, minecraft, mod, modding, server-mod
• Language: Java
• Homepage: https://nahkd123.github.io/stonks/
• Size: 723 KB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
![Stonks Banner](docs/banner.png)

# Stonks

![Build Status Badge](https://img.shields.io/github/actions/workflow/status/nahkd123/stonks/gradle.yml)

![License Badge](https://img.shields.io/github/license/nahkd123/stonks)

![Dynamic Version Badge](https://img.shields.io/github/v/release/nahkd123/stonks)

![Minecraft Version Badge](https://img.shields.io/badge/minecraft-1.21-red)

Weird little stocks/items market for block game.

## Get Stonks (for Fabric)

### Releases

All releases can be found in [Releases page](https://github.com/nahkd123/stonks/releases).

### Development builds

You can grab development builds [here](https://github.com/nahkd123/stonks/actions/workflows/gradle.yml?query=branch:main/1.21.x+is:success). Click on latest workflow run, scroll down to Artifacts section and click on ``Fabric Artifacts`` to download. Then copy ``stonks-fabric-[MOD VERSION]+[GAME VERSION].jar`` to your ``mods/`` folder/directory.

> **Small note**: The link above includes filter for success development builds only. Click on "Actions" tab to see everything.

## Documentations

For documentations, please [see here](https://nahkd123.github.io/stonks/). Documentations are maintained in `docs/` branches.

## Contributing

All contributions are welcomed! This includes code, documentations, finding bugs and even helping other people using Stonks! 

Please take a look at [Code of Conduct](./CODE_OF_CONDUCT.md) before contributing to this project.

> **tl;dr**: be nice in general.

After that, see [Contributing guide](./CONTRIBUTING.md) to get started.

## A story behind the version 2

Most people doesn't know this, but Stonks was originally created as a [Bukkit plugin](https://github.com/MangoPlex/stonks). It was created to showcase the FeatherPowder's capability, but ended up abandoning it because the code base is too hard to maintain.

The first [Stonks for Fabric](https://github.com/phomc/stonks) port (let's call this "Stonks 1.1") was released under PhoMC organization. This one includes MongoDB support, but then I realized SQL databases are the better candidate for storing players' offer data.

And now we have Stonks 2.0! I decided to go for "local first" - storing all data locally before adding SQL support to the mod/plugin. I also decided to separate the market logic (``core`` subproject) and mod + plugin front-end (``fabric`` and ``bukkit`` subprojects) so other people can use Stonks Core for their "virtual market", like stocks market training platform for example, while keeping "Stonks for Fabric" and "Stonks for Bukkit".