farkle's Introduction

Farkle

Simulation of a Farkle variant.

Modules

Core - Game engine and interfaces
Rules - Scoring rules and players
Driver - Runs the Farkle simulation in various ways

Getting Started

Run FarkleDriver. Modify the source to add or remove players.

Implementing a Player

Create a class that extends AbstractPlayer.

Submitting a Player

Submit a pull request if you would like your Player contributed to the project. Open source players should be put in Rules/src/main/java/org/thedoug/farkle/player. Closed source players may be jar'd and put in Driver/compiled.

Rules

See Wikipedia's Play and Standard Scoring sections.

Specific to this version:

Winning score is 10,000.
Only 5 dice are used.
All players get the same number of turns as the winning player. Players can tie.

farkle's People

Contributors

Watchers

farkle's Issues

As a new competitor I would like some documation so that I can get started on building a Farkle bot.

Verification

Document (on the Wiki or in the Readme.md) how to execute the Farkle framework with custom bots.
Document (on the Wiki or in the Readme.md) what classes competitor's should extend/implement to build a Farkle bot.
Document (on the Wiki or in the Readme.md) how Farkle bots should be submitted.

Write a tool to enumerate each possible scenario and analyze a player's decisions

Should be able to compare 2 players to see where there are differences, if any.

Add dependencies/dependency management to the repo.

Jars in dirs? SBT? Gradle?
Should play nice with IntelliJ/Eclipse.

Implement new Farkle rule: Must hit 10,000 points exactly

To win, player must hit 10,000 points exactly. Rolls exceeding it aren't counted.

Improve driver feedback

Driver should:

Tell me when it starts instead of waiting for periodic updates.
Tell me when it finishes and how long everything took.
How many ties there were (especially for 2 players).
How much better one player is than another.

Add sample project files to the repo

Include a means of generating a .idea/.imls for quick setup (batch file, shell script), or just check them in in-place, and then add to git-ignore, if that's possible.