Read Me

microlite20 Character Generator

contact info: chgowiz@gmail.com

The m20 Character Generator allows you to quickly generate a character and then download a PDF of the m20 character sheet for your use and printing. The latest version is hosted on the microlite20 site.
The source code is made available here for anyone who wishes to adapt the character generator, as well as to provide a way for anyone to 'contribute back' to the project.
Sourceforge website: http://sourceforge.net/projects/m20chargen/
The generator is currently based on the following rulesets from the Macropedia:
- Core
- Expert (Grimstaff)
More rulesets from the Macropedia will be made available going forward.

Things I'd like to do (eventually):

A way of incorporating ruleset descriptions into the selection screen via RSS from the microlite20 Macropedia.
Create an NPC generator from the character engine.
Use different character sheets (maybe have thumbnail previews on the site)
Incorporate more rules
Convert to more of a 'scripted' engine where homebrew rules could be added easily

Installing this on your own server:

Currently m20chargen requires that PHP 5.x be installed on your webserver. It might work with 4.x, but I've made use of the latest versions, so I can't guarantee it.

Get the latest SVN trunk and put everything into a single directory, such as m20cg. The images folder should go there as well.

You will also need to install the following libraries into the same directory as m20chargen:

FPDF (ver 1.53) available here: http://www.fpdf.org/en/download.php
This freeware library provides basic PDF manipulation functionality.

FPDF_TPL (ver 1.1.1) and FPDI (ver 1.2) available here: http://www.setasign.de/products/pdf-php-solutions/fpdi/downloads/
These freeware libraries provide template functionality for PDFs based on the FPDF libraries. This allows us to use preexisting PDF character sheets and write the generated values into them.


Document version history:
5.15.08 – updated app changelog, Todo list
5.14.08 – first version
Application version history
v1.2 – incorporated Modern ruleset
v1.1 – character class rewritten to support Core and Expert and other rules, display made more generic to support multiple rulesets.
v1.0 – Core rules included – basic generator