1
3
Fork
You've already forked 10000
0
The dice game Ten Thousand (aka Farkle) for CLI
  • Python 100%
2026年04月19日 10:20:31 +10:00
src/ten_thousand Bump to v3.0.0 2026年04月18日 21:29:15 +10:00
tests Refactor into cli, logic, storage, and constants modules 2026年04月18日 21:12:51 +10:00
.gitignore Add record storage 2025年10月05日 16:09:43 +11:00
LICENSE adds GPLv3 license file 2025年02月15日 23:29:49 +11:00
pyproject.toml Change development status to production/stable 2026年04月18日 21:28:35 +10:00
README.md Improve wording of instructions for installation of the game 2026年04月19日 10:20:31 +10:00
tty_v2.0.0.gif Bump to v2.0.0 2025年10月04日 23:54:02 +10:00

10000

Installation

Run pip install . at the root of the repository to install the game, and use the command 10000 to start it. (Starting it for the first time creates the hidden folder .10000 in the home directory, in which the local all-time record for the game is stored.)

Gameplay

  • The game is played with a total of six dice and the aim is to reach at least 10,000 points in as few turns as possible. It's up to you how far you want to push your luck along the way.
  • A turn begins with the first roll of all six dice. With each roll, at least one scoring die or dice combination must be set aside (the point values are shown below).
  • If all dice have been successfully set aside with one roll or more, the turn can be continued with all six dice.
  • A turn is over when you either decide to keep the points you have scored, which is possible from 350 points, or when you haven't scored any points with a roll, i.e. you couldn't set aside any dice.
  • If your turn includes points from a dice combination (three or more of a kind, three pairs or a straight), you must prove that you have earned the extra points by subsequently scoring at least 350 points in an additional turn (the points scored in this additional turn are not added to your score).

Preview

Have a look at v2.0.0 of this game:

A terminal recording of v2.0.0 of this game.

Point system

Single dice

  • 5 = 50 points
  • 1 = 100 points

Three or more of a kind

Three of a kind

  • 2 2 2 = 200 points
  • 3 3 3 = 300 points
  • 4 4 4 = 400 points
  • 5 5 5 = 500 points
  • 6 6 6 = 600 points
  • 1 1 1 = 1,000 points

Four / five / six of a kind

  • Like three of a kind but each additional die means +1,000 points
    • 2 2 2 2 = 1,200 points
    • 3 3 3 3 3 = 2,300 points
    • ...

Flat points

Three pairs

  • 1 1 2 2 3 3 = 1,500 points
  • 2 2 4 4 6 6 = 1,500 points
  • ...

Straight (1 to 6)

  • 1 2 3 4 5 6 = 1,500 points

Resources

  • For more information on the dice game Ten Thousand, see the Wikipedia article on Farkle.