CCash

A webserver hosting a bank system for Minecraft, able to be used from web browser or from CC/OC if you're playing modded.

the currency model most Minecraft Servers adopt if any, is resource based, usually diamonds, this model is fraught with issues however:

the primary issue is minecraft worlds are infinite leading to hyper inflation as everyone accrues more diamonds
there is no central authority minting the currency, any consumer can introduce more diamonds to the system
some resources are passively reapable, making the generation of currency a larger focus then of products
locality is required for transaction
theft is possible, ownership is possession based

CCash solves these issues and adds a level of abstraction, the main philosophy of CCash is to have fast core operations that other services build on

Build

drogon depedencies (varies by OS/distro)

# Debian
sudo apt install libjsoncpp-dev uuid-dev openssl libssl-dev zlib1g-dev

# macOS
brew install jsoncpp ossp-uuid openssl zlib

building the project

git clone --recurse-submodule https://github.com/EntireTwix/CCash/
cd CCash
mkdir build
cd build
cmake ..
make -j<threads>

then edit config.json to include the paths to your certs for HTTPS (I use certbot), or just remove the listener for port 443.

vim ../config.json

finally, run the program

sudo ./bank <admin password> <saving frequency in minutes> <threads>

Connected Services

Using the Bank's API allows (you/others) to (make/use) connected services that utilize the bank, a couple ideas can be found here

Go to here to see the API's endpoints. Language specific APIs can be found here.

FAQ

Q: how is money initially injected into the economy

A: you can take any approach you want, one that I recommend is using a one way exchange via the CC ATM above to have players mine the initial currency, this rewards early adopters and has a sunk cost effect in that the resource is promptly burned

Contributions

Thank you to the contributors

Name	Work
Expand	Frontend
React	CC {API, Shops, and ATM, Logo}
Doggo	Logs loading/adding Optimized, HTTP convention suggestions
Luke	Slight Doc edits

Features

Performance

In memory database instead of on disk
NOT written in Lua, like a OC/CC implementation
written in C++, arguably the fastest language
multi-threaded
parallel hashmaps a far superior HashMap implementation to the STD, that also benefits from multi-threaded
Drogon is a very fast web framework
Lightweight, anecodotally I experienced 0.0% idle, <1% CPU usage on average, 7% at peak, 1000 requests in 0.85s

Safety

Tamper Proof relative to an in-game implementation
Auto-Saving and Saves on close
HTTPS (OpenSSL)

Accessibility

RESTful API for connected services like a market, gambling, or anything else you can think of
able to be used millions of blocks away, across dimensions, servers, vanilla or modded.
Logging of all transactions, configurable in consts.hpp

3.9 KiB Raw Blame History