BitQuest
BitQuest is a Minecraft server with a Bitcoin-denominated currency and MMORPG elements, as the form of a plugin.
Play BitQuest
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
How it works?
Everyone is a Bitcoin wallet
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. Thanks to the open nature of Bitcoin, all transactions in the server can be seen on the Blockchain using tools like Insight or Blockchain.Info. This is helpful for debugging and transparency.
And there's loot!
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.
Everyone can send money anywhere
You can send Bitcoin to an outside wallet or other players using the Minecraft console command:
/transfer <amount> <recipient-bitcoin-address>
Players can also send money using email instead of a bitcoin address using:
/transfer <recipient-email>
With this method the recipient will receive an email notifying that a bitcoin transaction has been made to a XAPO wallet linked to his email.
Server address
The BitQuest server has it's own address, used for giving Loot to players
About the back-end technology
All persistent data is saved in a redis database so the server can respond as quick as possible. All transactions in the game are on-chain using Blockcypher's microtransactions API or in case of player-to-email XAPO API.
Everybody is welcome to contribute. :D
Here are the instructions to modify, install and run the server as localhost.
Installation
Framework
You can use eclipse or intellij to open and modify this project
Installing Dependencies
- Be sure you have installed the last version of java version
Note: if you are running a Debian-based Linux distribution like Ubuntu, you can run the setup script included instead of following the rest of these instructions:
Ubuntu
$ cd setup_scripts
$ ./ubuntu.sh
Make sure you are in the setup_scripts directory before running the script. Otherwise, follow the rest of the instructions.
Manual Setup
- Install gradle and redis
OSX
Install brew, then run
$ brew install gradle redis
Ubuntu
$ sudo apt-get install gradle redis-server
Compile project
OSX and Ubuntu
To compile project go to the bitquest directory and run
$ ./gradlew shadowJar
This will generate a new file at bitquest/build/libs/bitquest-all.jar
that you can use as a plugin in your localhost minecraft server.
Run server in localhost
Spigot
- Make a new directory called
spigot
and download there the last BitQuest's spigot . If you get an error regarding a missing main manifest attribute, make sure you downloaded the actual spigot jar and not the spigot-api jar. - Go to this directory and run spigot
OSX and Ubuntu
$ java -jar spigot-1.8.8-R0.1-SNAPSHOT.jar
OSX and Ubuntu
The first time it runs it will generate a bunch of files and directories.
- Open
spigot/eula.txt
and change
eula=false
to
eula=true
- Run spigot again
OSX and Ubuntu
$ java -jar spigot-1.8.8-R0.1-SNAPSHOT.jar
Now you should have a new directory spigot/plugins/
- Close the server with
cmd + C
- Copy or move
bitquest/build/libs/bitquest-all.jar
tospigot/plugins/
or make a symbolic link:
OSX and Ubuntu
$ ln -s $bitquest/bitquest/build/libs/bitquest-all.jar $spigot/plugins/bitquest-all.jar
where $bitquest
is your bitquest root directory and $spigot
is the directory containing your spigot jar.
- Run spigot again to run the server with bitquest plugin
OSX and Ubuntu
$ java -jar spigot-1.8.8-R0.1-SNAPSHOT.jar
Redis
In the bitquest directory
- Run the redis server
OSX and Ubuntu
$ redis-server
Now you will be able to enter to your localhost bitquest minecraft server adding localhost
as server
More info about BitQuest at https://bitquest.co/