From aae47fe2d90963bc5ee70fb49c8a4ba540375b98 Mon Sep 17 00:00:00 2001
From: David Vierra <codewarrior@hawaii.rr.com>
Date: Sun, 19 Sep 2010 15:11:37 -1000
Subject: [PATCH] added sample usage to readme

---
 README.txt | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 65 insertions(+), 1 deletion(-)

diff --git a/README.txt b/README.txt
index cf295da..92c836b 100644
--- a/README.txt
+++ b/README.txt
@@ -6,4 +6,68 @@ Includes a command-line client (mce.py)
 
 Requires numpy.
 
-Read mclevel.py to get started.
\ No newline at end of file
+Read mclevel.py to get started.
+
+
+
+
+mce.py is a command-line editor for SMP maps. It can be used interactively from a terminal, accept editing commands on standard input, or run a single editing command from the shell.
+
+Sample usage:
+
+% python mce.py
+    Usage:
+       mce <world> clone <sourcePoint> <sourceSize> <destPoint>
+       mce <world> fill <blockType> <destPoint> <destSize>
+       mce <world> replace <blockType> [with] <withBlockType> <destPoint> <destS
+ize>
+       
+       mce <world> export <filename> <sourcePoint> <sourceSize>
+       mce <world> import <filename> <destPoint>
+       
+       mce <world> player <player> <point>
+       mce <world> spawn <point>
+       
+       mce <world> createChunks <startChunk> <chunkSize>
+       mce <world> deleteChunks <startChunk> <chunkSize>
+       mce <world> prune <startChunk> <chunkSize>
+       mce <world> relight <startChunk> <chunkSize>
+       
+    Points and sizes are space-separated triplets of numbers ordered X Y Z.
+    X is position north-south, increasing southward. 
+    Y is position up-down, increasing upward. 
+    Z is position east-west, increasing westward.
+    
+    A player's name can be used to specify a point. 
+    Use the keyword 'delta' to specify a point near a player. e.g.
+    
+       mce clone codewarrior 5 5 5 codewarrior delta 10 0 0
+    
+    In this command:
+       'codewarrior' is the source point, 
+       '5 5 5' is the size of the source box, and 
+       'codewarrior delta 10 0 0' means 10 blocks south of me.
+       
+       
+    
+Please enter world number or path to world folder: 3
+Identifying  C:\Users\Rio\AppData\Roaming\.minecraft\saves\World3\level.dat
+Detected Infdev level.dat
+Saved 0 chunks
+Scanning for chunks...
+World3> fill 20 Player delta -10 0 -10 20 20 20
+
+Filled 8000 blocks.
+World3> player Player
+
+Player Player: [-1.7053128706213856, 62.620000004768372, 88.666301260713084]
+
+World3> player Player Player delta 0 25 0
+
+Moved player Player to (-1.7053128706213856, 87.620000004768372, 88.666301260713
+084)
+World3> save
+
+Saved 6 chunks
+World3> 
+