Eratos is a simple companion to c10t, a Minecraft cartography tool. Generate maps using a friendly, human-readable YAML configuration instead of juggling shell scripts, command line switches and Minecraft block IDs!

Eratosthenes was a Greek thinker who up and invented geography. He also came scary close to estimating how huge the Earth is just by looking at the sun from two cities—two thousand, two hundred and some-odd years ago. Wow. That is blisteringly badass.

Requirements

• c10t
• Ruby 1.8.7
• trollop Ruby gem (gem install trollop)

Usage

Imagine if you could configure c10t with a YAML file like the following:

---
settings:
  c10t: ~/bin/c10t
worlds:
  snow:
    world: &snow_world ~/Library/Application Support/minecraft/saves/World5
    folder: &snow_folder ~/Sites/minecraft/maps/snow
maps:
  islands_overview_night:
    world: ~/Library/Application Support/minecraft/saves/World2
    output: ~/Sites/minecraft/maps/islands/overview.png
    night: true
  snow_isometric_structures:
    world: *snow_world
    output:
      folder: *snow_output
      file: structures.png
    exclude: all
    include:
      - cobblestone
      - mossy_cobblestone
      - wood
      - brick
    isometric: true

Now imagine no more, because that is precisely what Eratos is good for!

All you’ll need is a YAML file with a hash named maps in it. Each maps entry corresponds to an image you’d like to generate using c10t. At the very least, you’ll want world and output keys for each map:

---
maps:
  overview:
    world: ~/Library/Application Support/minecraft/saves/World1
    output: ~/Desktop/overview.png

You may also need to tell Eratos where your c10t binary is, if it’s not in your $PATH:

---
settings:
  c10t: ~/bin/c10t

Then, to generate your maps, run bin/eratos, specifying the path to your config file with the --config or -c switches:

eratos -c config.yml

License (MIT)

Copyright © 2010 Ross Paffett

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.