Home

Awesome

MonsterEOS

MonsterEOS Icon

Setup instructions and technical content in the bottom of the page! :)

About

MonsterEOS was born as an experimental decentralized application in the EOS Blockchain. It is a Tamagotchi style game where you keep your pets alive and happy by feeding them, providing a pleasant environment, and letting them rest. By popular demand and adoption from the EOS community, we have added requested features such as battles and a monster market.

The project will ALWAYS be open source because we believe it’s a must for a decentralized world, and also, because we want the project to be building block and code reference for other great games and dapps on the EOS blockchain. In fact, we encourage everyone to browse our code repository, and extend/modify the game and re-publish as you wish - the more dapps built for our wonderful EOS community the better.

The game is currently in BETA, and under constant development and improvement. This does not restrict us from implementing profit channels to fund the required resources and team. For now, the project receives 1% of all the market transfers and we are studying ways of implementing in-app purchases avoiding PAY-TO-WIN schemes.

Many crypto-world games are based on a gambling scheme. These have a place in the market, but our goal for MonsterEOS is for folks to just have FUN, period. It's okay to create monsters, raise them, love them and then exchange them. That's why we have a market, but we aren't intending MonsterEOS to be second source of income for people, besides... You will probably love your monsters too much to part with them.

We love the EOS Community and we know that we can build a better world together!

Connect with us!

Discord: https://discord.gg/gmrDtHF

Twitter: https://twitter.com/MonsterEos

Medium: https://medium.com/monstereos

GitHub: https://github.com/MonsterEOS

Telegram: https://t.me/joinchat/Hel9rgyuHrEwzsjG2SlUNQ

Official Collaborators & Shareholders

Access our DAO here: https://github.com/MonsterEOS/dao

NameTitleSocial Info
Leo RibeiroFounder and Head of DevelopmentGitHub / Twitter / Steemit
Alex RozgoHead of Gaming EngineeringGitHub / Twitter / Steemit
Vertex StudioArts & Gaming StudioOfficial Website
CypherglassSponsor of Infrastructure and EOS ResourcesOfficial Website / Twitter / Youtube / Steemit
Friedger MuffkeDeveloperGitHub / Twitter / Steemit
Marcelo MendesDeveloperGitHub / Twitter
Julien LuccaDeveloperGitHub / Twitter
John WilliamsonDeveloperGitHub / Twitter / Steemit
Jenny CalpuPR & MarketingTwitter / Steemit
Daniel WagnerGaming CuratorMedium

The project is open to the public and we welcome anyone who would like to collaborate. Our Github repository is there for the community, but in order to receive shares of the project and participate in our distribution, you must be approved by board members.

Our Decentralized Autonomous Organization is still being defined but you can check out our current proposal here. This model is inspired by Slicing Pie for startup companies, and we believe that it’s the fairest way to reward collaborators of an open source project. We intend to translate our agreement into an EOS Smart Contract and automate the distribution process in the future.

Partnerships

Large Seafaring Mammal T-Shirts: Buy your shirt here!

MyEOSKit - EOS Blockchain Explorer: https://www.myeoskit.com/#/tx/monstereosio - This is where we link our transactions and explore them.

MonsterEOS Animal Jungle Version - JungleNet is the TestNet that we consider as our staging environment, and guess what?! They just prepared an Animal Version of Monsters! Coming out Soon...

If you have any partnership ideas, feel free to contact us in our Telegram, GitHub or Email.

Disclaimer

This project remains purely experimental software and is not to be considered in any way production ready, and has no guarantee of any kind. Use at your own risk.

Any transferred tokens sent to account name 'monstereosio' will not return any entitlement of any asset, investment digital or physical including the sent asset itself. Any proceeds received from any user transfers are used at the sole control and discretion of the receiver.

Big Thanks & Credits

Open source is all :heart:

Monsters Pictures Package: Itch.io @Pipoya - Free RPG Monster Pack

Sleeping GIF Credits: Giphy @AlabasterPizzo

Arena Background Credits: Freebies from craftpix.net - license here: Craftpix

Setup

First of all, clone the repo and enter in the root folder of the project:

git clone https://github.com/MonsterEOS/monstereos
cd monstereos

You will need to install node (version 8+), yarn and docker.

Chain and Backend

We structured everything in microservices and it can be automagically initialized by docker! Don't be afraid of docker, a lot of people hear docker and run away but we already did the hard part (configuration) for you. You will just need to install docker in your computer (a simple installer that you will press next next next finish lol).

After you installed docker just run the following commands:

Start docker containers and Create postgres database and init chain and monster data

./setup.sh

Tip: Before continuing with setup run docker-compose logs -f to make sure the nodes are running fine.

<p align="center"> <img src="docs/assets/setupsh.png" width="600"> </p>

Now that you have installed everything you can always start the app with the following command:

./start.sh

Note: the postgres password is pass, you can change it in docker-compose.yml

Open Kitematic (a nice UI for docker containers management that comes by default on docker installation) and you will see all the containers running (or run the command docker-compose logs -f):

Frontend App: UI

With all these nodes running you can just access it with our frontend app:

cd services/frontend
yarn
yarn start

Feel free to build any other apps and/or dockerize it. We didn't create a docker container for it because we usually build the static files (yarn build) and serve it on gh-pages branch.

Troubleshooting

Removing all data

./flush.sh

EOS Dream Stack

You can build any Dapp using the above structure. Tweak the structure a little bit to satisfy all your needs, i.e.: you can change the postgres for other database as mongo or mysql; you might not need demux and the backend if your app is very basic, allowing the frontend to read directly from the chain; change the frontend to whatever framework you want to use as Vue or Angular, not only this but your frontend can be a mobile native app, why not?

Notes