/pokerwars.io-starterbot-java

A starter bot written in Java for the pokerwars.io platform. To play: pull this code, register on pokerwars.io, get your API token and play!

Primary LanguageJava

pokerwars.io-starterbot-java

This is a simple example of how you could implement a pokerwars.io bot with Java and Spring Boot. It comes with a few simple poker strategies, the default is RANDOM, but you should change this and try to implement your own!

Quick start

A few requirements to play:

  • have Java 8 JDK or newer installed
  • make sure that the computer where your bot runs is visible from the internet, so we can communicate with him/her. This is an useful service to double check this. Bot default port is 8090, but you can change this on the src/main/resources/application.yml file. If you need help to open a port on your router check this guide, or if you do not have access to your router or your bot is behind a firewall, try ngrok. If you struggle, contact us, we are always willing to help you.
  • Register with us and retrieve your API token and username.
  • check out this repo with git or download it from this link.
  • in the code you just downloaded, update the src/main/resources/application.yml file with your username, token and bot ip address and port:
pokerwars:
    bot:
        username: [[[INSERT-YOUR-POKERWARS-USERNAME-HERE]]]
        token: [[[INSERT-YOUR-POKERWARS-TOKEN-HERE]]]
        # make sure your bot can be seen from external at the IP and port you specify below, so pokerwars.io can talk to him/her.
        # this is an useful service to double check this: http://canyouseeme.org/ . Bot default port is `8090`, but you can change this just above in this file
        endpoint: http://[[[INSERT-YOUR-PUBLICLY-AVAILABLE-BOT-IP-ADDRESS-AND-PORT-HERE]]] # example: http://1.2.3.4:8090/ 

Now you can implement your own poker strategy and play with it! Or use one of the available strategy.

Play!

Now you are ready to run the bot!

If you are in Linux or Mac, open a console and from the main project directory type:

[pokerwars.io-starterbot-java]$ ./gradlew bootRun

If you are on Windows, open a command prompt and from the main project directory type:

pokerwars.io-starterbot-java> gradlew bootRun

The bot will try to subscribe to pokerwars.io when it starts up. If no errors happens, it will start playing straightaway, otherwise you should see an error. The most common is that we cannot see your bot, please double check your bot is visible from the internet and you have configured your router correctly. If you do not have access to your router or your bot is behind a firewall, try ngrok.

Extending this bot

If something is not clear in this code, refer to also to our documentation for the structure and content of the data we send to your bot. How you choose to manipulate that information to inform your bot's strategy is up to you!