summaryrefslogtreecommitdiff
path: root/README.md
blob: 5b0ed6fedaef0a20736b3e4750dd4091046537d0 (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
58
59
60
61
62
63
64
65
66
67
68
69
3D Printable Piecepack
======================

The [piecepack](http://www.piecepack.org/) is a generic set of boardgame
parts designed by James Kyle and released under public domain. Hundreds
of games for the piecepack are available on the internet, both on the
official site and on the [piecepack
wiki](http://www.ludism.org/ppwiki/).

This piecepack is designed for 3D printers and can be printed at home
(or your local fablab) or sent to a 3D printing service. Currently it
includes the piecepack (with saucers and suite die), in basic, cards and
seasons variants.

Instructions
------------

### Building the 3D models

To generate the .stl files for each piecepack component you need Make
(tested with [GNU Make](https://www.gnu.org/software/make/)) and
[OpenSCAD](http://www.openscad.org/); one you have installed these
dependencies just run:

    $ make

from the root directory of this repository and wait.

If you want to print an expansion you can change the value of the
`SUITES` variable on line 7: decomment one of the options, or set it to
a combination of available suites. Note that the suite die expect at
least 4 suites, and if more are available they are printed instead of
the ace and null values.

Example settings for [Slic3r](http://slic3r.org/) are available in the
conf directory: you can load them in Slic3r, change the settings
(expecially those related to the printer) and re-export them in place.
Then you can use:

    $ make gcode

from the root directory of the repository to generate .gcode files which
can be sent to your printer.

### Printing

The models should be printed in an opaque material: when using PLA a
darkish color may be better than a light one.

All markings on the pieces are recessed in the surface and should be
painted with appropriate colors. On PLA I've used craft acrylics with
success by applying two layers of primer.

### Readme

The file README.md is generated from README.rst with:

    pandoc -o README.md README.rst

and is included in the repo for the benefit of gitorious.

License
-------

OpenSCAD code and SVG artwork Copyright 2013-2014 Elena Grandi

This work is licensed under the Creative Commons Attribution-ShareAlike
4.0 International License. To view a copy of this license, visit
<http://creativecommons.org/licenses/by-sa/4.0/>.