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	Project Work	Connected Service Work
Expand	Slight docker changes	Frontend
React	CC API, Logo	CC Shop, CC ATM.
Doggo	Logs loading/adding Optimized, HTTP convention suggestions, Python API	`N/A`
Luke	JS API, Docker, Slight Doc edits	`N/A`
Jolly	Slight Doc edits	`N/A`

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
xxHash for the hashing of passwords, it is very fast: graph
Lightweight, anecodotally I experienced (on my laptop's i7 6700K, 8 threads):
- memory usage of 8.5 MB (with 0 users)
- 0.0% CPU usage idle
- <1% CPU on average
- 1000 requests in parallel completed in 0.85s which spiked CPU usage to 7%

Safety

Tamper Proof relative to an in-game implementation
Auto-Saving and Saves on close
All passwords are Hashed
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

4.6 KiB Raw Blame History