caRcassonne

---

caRcassonne is an open source client in Ruby striving to implement the rules and basic tile sets of the Carcassonne Boardgame and possibly expansion sets. Eventually this client might be forked into a generic tile-based boardgame generator/client.

Discontinuation notice

While I still hope to create my own Carcassonne game some day, it'll likely be a complete rewrite as I have no idea where I left off with this repo. Thus, this repository is no longer maintained, and will be archived.

Installation Guidelines

---

From Git:

• gem install gosu
• git clone git://github.com/FiXato/caRcassonne.git && cd caRcassonne

And if you want to run the TileEditor, you also need GGLib for now:

• gem install gglib

Installation is not available yet.

From RubyForge/GemCutter:

Not available yet

Usage

---

Start a new game using the Original-Carcassonne-Classic tile set:

./carcassonne.rb Original-Carcassonne-Classic

Start a new game using the O.C.C. tile set and continue from savestate:

./carcassonne.rb Original-Carcassonne-Classic 20100909004744.yaml

Start the TileEditor using the Original-Carcassonne-Classic tile set:

./tile_editor Original-Carcassonne-Classic

NOTES:

The original tile set is not included, but in the near future a custom default tile set will be included.

Commandline Arguments

Currently carcassonne supports no command-line arguments. In the future it might support:

• --load-savestate => Load specified savestate
• --load-tileset => Set tile set as active tileset
• --version => Return the current VERSION of caRcassonne

By default all debug info and errors will be output via STDOUT.

However, the following command-line arguments will in the future be available to set the verbosity:

• --log-errors => Fatal and non-fatal errors.
• --warn => Logs warnings besides the (non-)fatal errors.
• --verbose => Besides the --warn output, also outputs info.
• --debug => Most verbose form. --verbose plus debug info.

Examples

Simplest way to run it would usually be: ./carcassonne.rb Original-Carcassonne-Classic

ToDo

---

See the TODO.markdown file.

Notes on Patches/Pull Requests

---

1. Fork the project.
2. Make your feature addition or bug fix.
3. Add tests for it (even though I don't have tests myself at the moment). This is important so I don't break it in a future version unintentionally.
4. Commit, but do not mess with Rakefile, version, history, or README. Want to have your own version? Bump version in a separate commit! That way I can ignore that commit when I pull.
5. Send me a pull request. Bonus points for topic branches.

Copyright

---

Copyright (c) 2010 Filip H.F. "FiXato" Slagter. See LICENSE for details.

---