Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zamiell/hanabi-bot

A framework for creating Hanabi bots
https://github.com/zamiell/hanabi-bot

Last synced: about 1 month ago
JSON representation

A framework for creating Hanabi bots

Awesome Lists containing this project

README 

        
# hanabi-bot



This is a framework for creating [Hanabi](https://boardgamegeek.com/boardgame/98778/hanabi) bots that play with each other. It is written in [Go](https://golang.org/). Eventually, the idea is to have the option for players to play together with bots on [Hanabi Live](https://github.com/Zamiell/hanabi-live).







### Instructions for Coding a New Strategy



Copy the "strategy_dumb.go" file and rename it to "strategy_whatever.go". Fill in all of the functions. Then, add `whateverInit()` to the "strategy.go" file.







### Installation (for experts)



* The project doesn't require any special dependencies. Just clone the repo and go.







### Installation (for noobs/contributors)



Like many code projects, we use [golangci-lint](https://github.com/golangci/golangci-lint) to ensure that all of the code is written consistently and error-free. We ask that all pull requests pass our linting rules.



The following instructions will set up the development environment and the linter. This assumes you are on Windows and will be using Microsoft's [Visual Studio Code](https://code.visualstudio.com/), which is a very nice text editor that happens to be better than [Atom](https://atom.io/), [Notepad++](https://notepad-plus-plus.org/), etc. If you are using a different OS/editor, some adjustments will be needed (e.g. using `brew` on MacOS instead of `choco`).



Note that these steps require **an elevated (administrator) command-shell**.



* Install [Chocolatey](https://chocolatey.org/):

  * `@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"`

* Install [Git](https://git-scm.com/), [Golang](https://golang.org/), and [Visual Studio Code](https://code.visualstudio.com/):

  * `choco install git golang vscode -y`

* Configure Git:

  * `refreshenv`

  * `git config --global user.name "Your_Username"`

  * `git config --global user.email "[email protected]"`

  * `git config --global core.autocrlf false` 


  (so that Git does not convert LF to CRLF when cloning repositories)

  * `git config --global pull.rebase true` 


  (so that Git automatically rebases when pulling)

* Clone the repository:

  * `cd [the path where you want the code to live]` (optional)

  * If you already have an SSH keypair and have the public key attached to your GitHub profile, then use the following command to clone the repostory via SSH:

    * `git clone [email protected]:Zamiell/hanabi-bot.git`

  * If you do not already have an SSH keypair, then use the following command to clone the repository via HTTPS:

    * `git clone https://github.com/Zamiell/hanabi-bot.git`

  * Or, if you are doing development work, then clone your forked version of the repository. For example:

    * `git clone https://github.com/[Your_Username]/hanabi-bot.git`

* Enter the cloned repository:

  * `cd hanabi-bot`

* Install the Golang project dependencies and build it:

  * `go build`

* Install [the Golang linter](https://golangci-lint.run/usage/install/#local-installation).

* Install the VSCode extension for Golang:

  * `code --install-extension "golang.go"`

* Open VSCode using the cloned repository as the project folder:

  * `code .`

* Test the Golang linter:

  * On the left pane, open "main.go".

  * In the bottom-right-hand corner, click on "Analysis Tools Missing" and then on "Install". You will know that it has finished once it displays: "All tools successfully installed."

  * Add a new line of "test" somewhere, save the file, and watch as some "Problems" appear in the bottom pane.

* Run the code:

  * Launch a Git Bash shell:

    * `"%PROGRAMFILES%\Git\bin\sh.exe"`

  * Use the included run script:

    * `./run.sh` 


    (by default, it uses the Hyphen-ated strategy with 3 players; edit "main.go" to adjust this)