about summary refs log tree commit diff stats
path: root/README.org
blob: 533cf55013cc6573c8ff4a3170f70d1ed3c2b9d9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
#+title: Caelum
#+subtitle: Caelum is a text based Cee-lo game
#+export_file_name: index
#+setupfile: ~/.emacs.d/org-templates/projects.org

| Website         | https://andinus.nand.sh/caelum             |
| Source          | https://git.tilde.institute/andinus/caelum |
| GitHub (mirror) | https://github.com/andinus/caelum          |

* Demo

This was recorded with ~asciinema~.

[[https://asciinema.org/a/410291][https://asciinema.org/a/410291.png]]

+ Caelum v0.1.1: https://asciinema.org/a/410291

* Installation

Caelum is released to CPAN, you can get it from there or install it from
source. In any case, ~zef~ is required to install the distribution.

You can run Caelum without ~zef~. Just run ~raku -Ilib bin/caelum~ from
within the source directory.

** Release

1. Run ~zef install caelum~.

Caelum should be installed, try running ~caelum --version~ to confirm.

** From Source

You can either download the release archive generated by cgit/GitHub or
clone the project if you have ~git~ installed.

*** Without ~git~

1. Download the release:
   - https://git.tilde.institute/andinus/caelum
   - https://github.com/andinus/caelum/releases
2. Extract the file.
3. Run ~zef install .~ in source directory.

*** With ~git~

All commits will be signed by my [[https://andinus.nand.sh/static/D9AE4AEEE1F1B3598E81D9DFB67D55D482A799FD.asc][PGP Key]].

#+begin_src sh
# Clone the project.
git clone https://git.tilde.institute/andinus/caelum
cd caelum

# Install octans.
zef install .
#+end_src

* Documentation

** Implementation

Caelum is an implementation of [[https://en.wikipedia.org/wik/Cee-lo#Cee-lo_without_a_bank_(winner_take_all)][Cee-lo without a bank]]. The bet amount is
set to be the average of whatever each player decides.

** Options

*** players

Number of players. Default is 2, should be an integer greater than or
equal to 2.

* News

** v0.1.1 - 2021-04-27

+ Fixed bug in winning logic.

** v0.1.0 - 2021-04-27

Initial implementation.