========================
 3D Printable Piecepack
========================

The piecepack_ 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`_.

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.

.. _piecepack: http://www.piecepack.org/
.. _`piecepack wiki`: http://www.ludism.org/ppwiki/

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

Building the 3D models
~~~~~~~~~~~~~~~~~~~~~~

To generate the .stl files for each piecepack component you need Make 
(tested with `GNU Make`_) and OpenSCAD_; 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_ 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.

.. _`GNU Make`: https://www.gnu.org/software/make/
.. _OpenSCAD: http://www.openscad.org/
.. _Slic3r: http://slic3r.org/

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/.