No description
Find a file
2021-06-10 14:16:44 -07:00
include reverted xxhash changes 2021-06-10 14:11:51 -07:00
src reverted xxhash changes 2021-06-10 14:11:51 -07:00
third_party added drogon 2021-04-02 01:28:19 -07:00
.gitignore 🐛 further bug fixes 2021-06-03 01:54:58 -07:00
.gitmodules added drogon 2021-04-02 01:28:19 -07:00
CMakeLists.txt reverted xxhash change 2021-06-10 14:16:44 -07:00
config.json Create config.json 2021-06-09 16:13:49 -07:00
help.md password for add user moved to header 2021-06-10 12:17:50 -07:00
LICENSE Create LICENSE 2021-04-27 22:53:00 -07:00
main.cpp Split .hpp into .h and .cpp 2021-06-10 01:57:18 -07:00
README.md 🐎 made xxhash dynamically linked 2021-06-10 13:14:12 -07:00
services.md updated connected services 2021-06-09 23:58:19 -07:00
users.json Create users.json 2021-06-09 16:14:31 -07:00

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)

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

xxhash depedency

sudo apt install xxhash

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

Go to here to see the API's endpoints. Using the Bank's API allows (you/others) to (make/use) connected services that utilize the bank, a couple ideas 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}
Doggo Logs loading/adding Optimized, Python API

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 log_consts.hpp

Dependencies