aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 4830c949795c475cab3bfa05b501cbcc080235ed (plain)
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
# A TUI for local play of the game of Tak

## Building

Clone the repo, issue `cargo build` and enjoy (?)

## Usage

Takwrap supports local play, undo, and starting variant and game
exporting to PTN. See `takwrap -h` for options and details.

Note in particular that `takwrap` supports the following alternate
starting configurations, which are embedded in the exported PTN file
as `[Variant XXX]`.

- CPSn, counter-play start with n=1 is the default.

  White places a black flat, then black places a white flat. This
  repeats n times, after which normal play resumes.

- FCS, forbidden corner start.

  CPS1 but white may not place the black flat in a corner

- FES, forbidden edge start.

  CPS1 but white may not place the black flat on an edge

- TPS, two ply start.

  White places two black flats, then black places a white flat and
  normal play resumes.

- CZS, Czech start.

  White places a black flat, then normal play resumes

## Interfacing with engines

Takwrap does not have computer opponents built in, but instead allows
interfacing with external engine programmes with the `-e` parameter.
It expects the name of an executable in the path which accepts the
name of a file with a game-state in PTN, and which returns a single,
valid move.

See the file `wrap_taktician` for an example of utilising [Taktician](https://github.com/nelhage/taktician)
for this purpose.

Note that the engine is expected to respect the `[Variant XXX]` line
in the PTN game-state, so expect breakage with anything but the
default.

## Additional contributors

With thanks to

- ~devp for fixing a capstone->wall flattening bug