BitQuest is a Minecraft server with a Bitcoin-denominated currency and MMORPG elements. This repository is the open source code running on the server.
To play in the official BitQuest server you must own the official Minecraft game for PC/Mac/Linux and add this server address:
play.bitquest.co
This server is still under development, and bugs can, and most likely will, happen. Please report any bugs to a moderator promptly, to ensure they are fixed. Also note that your wallet is not guaranteed, and you may experience issues with your balance. For this reason, it is highly recommended that you do not deposit large amounts, or anything you do not wish to place at risk by being tied to the server. In addition, if you are caught breaking rules and are banned, you forfeit your access to your server wallet, and all funds tied to it. With this said, rules are non-negotiable, and will be strictly enforced. This server is a fair server, and anyone abusing any system set in place will be punished. Please play fair, have fun, and enjoy the server
The BitQuest server and every player has a bitcoin address. Any player can receive and send bitcoin to any address inside or outside the game. This is useful for buying materials, selling crafts, trading, tipping, etcetera.
Every time a player kills an enemy (mob) there is a chance to get loot. If that is the case the server makes a transaction directly from the server address to the player address and the player is notified.
You can send Bitcoin to an external wallet with /transfer:
/transfer <amount> <recipient-bitcoin-address>
Additionally, players can send Bitcoin to other players via /send:
/send <amount> <username>
The BitQuest server has it's own address, used for giving Loot to players
All persistent data is saved in a redis database so the server can respond as quick as possible.
Everybody is welcome to contribute. :D
Here are the instructions to modify, install and run the server as localhost.
You must install Java JRE, JDK and Maven
sudo apt install -y openjdk-8-jre openjdk-8-jdk maven
There is a maven project that will download the spigot 1.12.2 (downloading the latest version will be automated in future):
maven package -B
Or using all of your cpu core (fastest) (If you have low ram your build can crash)
maven package -B -T 1C
You can easly format the code by doing (you can exec this script from anywhere (you can do ../../../../../build.sh if you where on src/java/main/bitquest/bitquest/)):
./format.sh
A Bitcoin Core testnet node running in your computer or local network with the json-rpc interface activated.
Tou can use Docker to run a BitQuest server. There's also an official BitQuest docker image. The recommended way to configure the image is using a docker-compose.yml file that can link to a directory where the worlds are stored. An example is included here. Configuration can be done via enviroment variables:
environment variable | description |
---|---|
BITQUEST_NODE_USERNAME | username for Bitcoin node |
BITCOIN_NODE_PASSWORD | password for Bitcoin node |
BITQUEST_NODE_HOST | IP to a bitcoin node with JSON-RPC interface enabled |
ADMIN_UUID | Minecraft user ID for the main administrator |
Please make sure you have redis installed. If you are running via docker please make sure you have a redis container linked to the bitquest container.