-------------------------------------------------------------------------------
---Contents--------------------------------------------------------------------
-------------------------------------------------------------------------------

Section 1 - General Information
Section 2 - Preview
Section 3 - Install Instructions
Section 4 - What's New (Changelog)
Section 5 - Usage
Section 6 - Command List
Section 7 - Command Examples
Section 8 - Properties File
Section 9 - Support

-------------------------------------------------------------------------------
---1. General Information------------------------------------------------------
-------------------------------------------------------------------------------

Created By: simo_415
Version: 1.8
Mincraft Version: Beta 1.1.2
Thread: http://www.minecraftforum.net/viewtopic.php?f=25&t=100267

-------------------------------------------------------------------------------
---2. Preview------------------------------------------------------------------
-------------------------------------------------------------------------------

http://www.youtube.com/watch?v=P4qNc6FNLow

-------------------------------------------------------------------------------
---3. Install Instructions-----------------------------------------------------
-------------------------------------------------------------------------------

1. Go to the minecraft bin directory and backup minecraft.jar
2. Using 7zip or equally capable ZIP viewer open minecraft.jar
3. Delete the META-INF folder
4. Copy ALL the class files contained within the mod to minecraft.jar, replacing the existing files.
5. Enjoy the mod.

Note: If you have problems installing this mod, refer to help on the thread.

-------------------------------------------------------------------------------
---4. What's New---------------------------------------------------------------
-------------------------------------------------------------------------------

---V1.8------------------------------------------------------------------------

This release has a number of changes from the previous releases, the command 
set has now been broken up into two distinct sets, standard commands (such as
set, tele, instantmine, damage, etc) and world edit commands (previously known
as cuboid commands). 

The world edit commands are accessed by hitting '//' before your command name.

The list of current world edit commands is as follows (these are exactly the 
same as the "cuboid" commands in V1.6 and V1.7):
//box <BLOCKID> - Creates a box between the two specified points
//contract <n|s|e|w|u|d> [DISTANCE] - Reduces the selected area in the direction specified
//copy - Copies the selected area
//expand <n|s|e|w|u|d> [DISTANCE] - Expands the selected area in the direction specified
//fill <BLOCKID> - Fills the selected area
//help [COMMAND] - Specific world-edit help
//load <FILENAME> - Loads a saved config file so that it can be pasted
//paste - "Pastes" the copied (or loaded) region to the south-west of you
//remove - Removes the selected region
//reset - Resets the selected region
//save [FILENAME] - Saves the selected region to file
//set1 - Sets one corner of the region
//set2 - Sets one corner of the region
//walls <BLOCKID> - Puts walls around the selected region

Also added in this release is error messaging. The mod will now tell you if you
don't have enough parameters, your formatting is wrong or if the command you
typed in doesn't exist, just to name a few. This should help in debugging any
problems you have with commands. 

Along with the error messaging there is better error handling, so now the mod 
should NEVER cause the game to crash, and there should be an error log written 
if a problem occurs.

The new commands in this release are as follows:
/dropstore - This command transfers everything in your inventory into a chest 
   that it creates next to you.
/grow [all] - Grows all saplings/wheat on the map.
/itemname - Use this command to discover the itemname and ID of your currently 
   selected item.
/msg <MESSAGE> - This commands adds a message to the console.
/removedrops [all] - This command removes item drops from the world.
/replenish [all] - Re-stocks your items in your inventory to the maximum ammount
/search <SEARCHTERM> - Allows you to search for items using a name
/spawn <NAME|ID|random> [QTY] - Allows you to spawn an individual creature.
/spawnstack <NAME|ID|random>... - Same as /spawn in previous releases
/useportal - Instantly transfers you to the nether, use it again to go back.

Changed Functionality:
/item Allows you to enter an Item name rather than ID. The item name is found
   by hovering over the item in your inventory.
/spawn has changed to /spawnstack
/spawn now allows a number of the specified NPC to spawn

Bugs Fixed:
/explode now works as expected (tip: after big blasts use /removedrops).

---V1.7------------------------------------------------------------------------

This version adds a few new commands and a number of changes to the mod which
should allow for further expansion in the future. The new commands in this 
release are:

/damage - Turns player damage on/off
/explode [SIZE] - Sets off an explosion in your current location.
/extinguish|ext [all] - Puts out all nearby fire (or all fire)
/firedamage - Turns fire damage on/off
/timeschedule <reset | <TIME1> <TIME2>> - Sets a period of time (HH:MM format), 
   this will make minecraft always within this time.
/waterdamage - Turns water damage on/off

Also in this release a few other things were fixed/added:
/spawn <NAME> now does not have to be case-sensitive
/cuboid now has expand and contract options.

---V1.6------------------------------------------------------------------------

This version adds a "cuboid" type command to the mod:

To use cuboid you first need to specify the corners of the region that you want
to use cuboid with. To do this use:

/cuboid set1
/cuboid set2

Once both positions are set these commands become accesible:

/cuboid fill <BLOCKID> - This fills the selected region with the BLOCKID
/cuboid remove - This removes the selected region (same as /cuboid fill 0)
/cuboid box <BLOCKID> - This creates a box around the selected region with the 
   specified BLOCKID.
/cuboid copy - This copies the selected region to memory
/cuboid paste - This "pastes" the copied region to the map - to the immediate
   north east of the player.
/cuboid save [FILENAME] - This saves the copied region to file. These files are
located at ".minecraft/mods/sppcommands/saves". The files are uncompressed and
in later versions of this mod probably won't be compatible.
/cuboid load <FILENAME> - This loads the specified file to memory. The files 
should be in the same format that "/cuboid save" saves them as.

/cuboid get - This will return the two points which set1 and set2 are at. 
/cuboid reset - This will reset the two points set1 and set2.

See the examples for sample usage.

---

Other than /cuboid this version also comes with a number of new commands which 
should come in handy:

/falldamage - Turns fall damage on/off
/instantmine - Turns instant mining on/off
/jump - Moves you from where you are to where your mouse is pointing. Note: 
   This command is buggy and may put you in the block you move to.
/return - Moves the player to the last position before teleport
/setjump [JUMP|reset] - Sets the height that you jump. Note: Turns fall damage off
   if the jump is configured to move than 1.
/setspeed [SPEED|reset] - Sets the speed that the player moves

Use /help <COMMANDNAME> to find out information about each command. For example - /help falldamage

There is now a spc.settings file saved by the mod to the level save - this 
contains information which the mod uses and is configurable. This allows 
your settings to be saved, such as playerspeed and instantmine. 

This also release has a fix for the "/time day" command affecting redstone.

---V1.5------------------------------------------------------------------------

This version adds a number of new commands which are outlined below:

/ascend - Moves you to the next platform above your position
/descend - Moves you to the next platform below your position
/repair [all] - Repairs the currently selected item to full health
/duplicate [all] - Duplicates and drops the currently selected item stack
/destroy [all] - Destroys the current item
/itemstack <ITEMID> [QUANTITY] - Gives the player the specified quantity of maximum item stacks of the item.
/defuse [all] - Defuses any TNT nearby which has been hit, drops 1 tnt in its place
/killall [all] - Added [all] functionality which will remove all NPCs nearby
/killnpc [all] - Same as killall (killall to be removed in a later release).

Use /help <COMMANDNAME> to find out information about each command. For example - /help ascend

Made readme clearer

---V1.4------------------------------------------------------------------------

Single Player Commands mod now compatible with BETA 1.1.X

Added the ability to spawn custom mobs. This new feature changes the way /spawn works,
and changes all the NPC codes. Use /spawn list to find monster names and associated codes.
Please note that monster names ARE case sensitive.

You can now change the command names through a properties file, refer to the help
below for more information about this.

Fixed the bugs which were introduced in the last release

---V1.3------------------------------------------------------------------------

Single Player Commands mod now compatible with BETA 1.0.X

/health inf == /health infinite
/health now provides a message when used
Fixed bug where if you die you lose your waypoints

---V1.2------------------------------------------------------------------------

New Commands - 

difficulty
killall
music

Use /help <COMMANDNAME> to find out information about each command. For example - /help music

Added some extra functionality to /spawn
Moved the majority of the mod's functionality into a new class, PlayerHelper. This will help with compatability of other mods.
Fixed /time day and /time night to work like they should
Added more content to the readme

---V1.1------------------------------------------------------------------------

New commands -
clear
heal
health
help
listwaypoints
spawn
time

Use /help <COMMANDNAME> to find out information about each command. For example - /help time

Removed changes to cy.class so only TWO classes needed for mod to function correctly.
Fixed player skin bug.
Seperated waypoint save from level.dat into a seperate file named waypoints.dat
Cleaned up code and made more robust
More detailed readme

-------------------------------------------------------------------------------
---5. Usage--------------------------------------------------------------------
-------------------------------------------------------------------------------

1. After applying mod open minecraft.
2. Start a saved world or new world (as per usual).
3. Type 't' (by default) to bring up the chat console.
4. Type in the command and hit enter; a list of commands can be found below.

View the preview video for more information.

-------------------------------------------------------------------------------
---6. Commands-----------------------------------------------------------------
-------------------------------------------------------------------------------

---Normal Commands-------------------------------------------------------------

ascend - Moves you to the next platform above your position
clear - Clears the console
damage - Turns player damage on/off
descend - Moves you to the next platform below your position
destroy [all] - Destroys the current item
defuse [all] - Defuses any TNT nearby which has been hit, drops 1 tnt in its place
diff <VALUE> - Same as /difficulty
difficulty <VALUE> - Sets the difficulty of the game, valid range is 0-3.
*dropstore - This command transfers everything in your inventory into a chest that it creates next to you.
dupe [all] - Same as /duplicate
duplicate [all] - Duplicates and drops the currently selected item stack
explode [SIZE] - Sets off an explosion in your current location.
extinguish [all] - Puts out all nearby fire (or all fire)
ext [all] - Same as extinguish 
falldamage - Turns fall damage on/off
firedamage - Turns fire damage on/off
give <ITEMCODE> [QUANTITY] - Same as /item
goto <NAME> - Goto a waypoint
*grow [all] - Grows all saplings/wheat on the map.
h [COMMAND] - Same as /help
heal <HEALTH> - Heals a player the specified number of points
health <MIN|MAX|INFINITE> - Sets the health of a player to pre-defined figures
help [COMMAND] - Gives general help when COMMAND isn't specified, gives specific help when COMMAND is specified.
home  Teleport to spawn point
i <ITEMCODE> [QUANTITY] - Same as /item
instantmine - Turns instant mining on/off
item <ITEMCODE|ITEMNAME> [QUANTITY]  Gives player item, if quantity isnt specified maximum amount of that item
*itemname - Use this command to discover the itemname and ID of your currently selected item.
itemstack <ITEMCODE> [QUANTITY] - Gives the player the specified quantity of maximum item stacks of the item.
kill  Kills the current player
jump - Moves you from where you are to where your mouse is pointing. Note: This command is buggy and may put you in the block you move to.
killnpc [all] - Kills all nearby living creatures except for yourself.
l - Same as /listwaypoints
listwaypoints - Lists all waypoints
*msg <MESSAGE> - This commands adds a message to the console.
music [VOLUME] - Requests a music track to be played (max 2 per day, won't always work), if volume is specified, sets the volume
p - Same as /pos
pos  Gives current player position
return - Moves the player to the last position before teleport
rem <NAME> - Removes the specified waypoint
*removedrops [all] - This command removes item drops from the world.
*replenish [all] - Re-stocks your items in your inventory to the maximum ammount
repair [all] - Repairs the currently selected item to full health
s <NAME> - Same as /set
*search <SEARCHTERM> - Allows you to search for items using a name
set <NAME> - Mark a waypoint on the world
setjump [JUMP|reset] - Sets the height that you jump. Note: Turns fall damage off if the jump is configured to move than 1.
setspawn [<X> <Y> <Z>]  Set the current position as the spawn point, if X Y Z are specified sets that position as spawn point
setspeed [SPEED|reset] - Sets the speed that the player moves
*spawn <NAME|ID|random|list> [QTY] - Allows you to spawn an individual creature.
*spawnstack <NAME|ID|random|list>... - Same as /spawn in previous releases
t <X> <Y> <Z> - Same as /tele
tele <X> <Y> <Z> - Teleport to X Y Z coordinates.
time [set|get|day|night [minute|hour|day [TIME]]] - Set and get the time within minecraft.
timeschedule <reset | <TIME1> <TIME2>> - Sets a period of time (HH:MM format), this will make minecraft always within this time.
*useportal - Instantly transfers you to the nether, use it again to go back.
waterdamage - Turns water damage on/off

* = New Command

---World Edit Commands---------------------------------------------------------

//box <BLOCKID> - Creates a box between the two specified points
//contract <n|s|e|w|u|d> [DISTANCE] - Reduces the selected area in the direction specified
//copy - Copies the selected area
//expand <n|s|e|w|u|d> [DISTANCE] - Expands the selected area in the direction specified
//fill <BLOCKID> - Fills the selected area
//help [COMMAND] - Specific world-edit help
//load <FILENAME> - Loads a saved config file so that it can be pasted
//paste - "Pastes" the copied (or loaded) region to the south-west of you
//remove - Removes the selected region
//reset - Resets the selected region
//save [FILENAME] - Saves the selected region to file
//set1 - Sets one corner of the region
//set2 - Sets one corner of the region
//walls <BLOCKID> - Puts walls around the selected region


-------------------------------------------------------------------------------
---7. Examples-----------------------------------------------------------------
-------------------------------------------------------------------------------

---Normal Commands-------------------------------------------------------------

/ascend - Moves you to the platform above (if there is one)
/clear - Clears the console.
/damage - Turns player damage off
/defuse - Defuses primed TNT in close radius of you
/defuse all - Defuses all primed TNT in the map.
/descend - Moves you to the platform below (if there is one)
/destroy - Destroys the current item
/destroy all - Destroys everything in your inventory
/difficulty 0 - Sets the difficulty to peaceful
/difficulty 3 - Sets the difficulty to hard
/dropstore - transfers everything in your inventory into a chest that it creates next to you.
/duplicate - Duplicates and drops the current item
/duplicate all - Duplicates and drops your entire inventory
/explode - Creates an explosion at your current location
/explode 10 - Creates an explosion at your current location of size 10.
/extinguish - Gets rid of all fire nearby
/extinguish all - Gets rid of all fire in the map
/falldamage - Turns fall damage off. /falldamage again will turn it on.
/firedamage - Turns fire damage off
/goto example - Teleports the player to the waypoint named "example"
/grow - Grows nearby plants
/grow all - Grows everything in the world
/heal 10 - Heals a player 10 health
/heal -10 - Removes 10 health from the player
/health min - Sets the players health to half a heart health
/health max - Sets the players health to ten full hearts
/health infinite - Sets the players health to 65565 (maximum ammount of health allowed).
/help goto - Provides an ingame help message about the goto command
/help spawn - Provides an ingame help message about the spawn command
/help - Provides a generic help message.
/instantmine - Turns instant mine on. /instantmine again will turn it off.
/item 1 - Gives the player 64 stone
/item 278 - Gives the player 1 diamond pickaxe
/item 278 64 - Gives the player 64 diamond pickaxe's
/itemname - Gives you the current items name and ID.
/itemstack 1 64 - Gives the player 64 stacks of 64 stone
/itemstack 278 10 - Gives the player 10 diamond pickaxes
/jump - Will teleport the player to the block where the mouse is pointing.
/kill - Kills the current player
/killall - Kills all nearby living creatures.
/killall all - Kills every living creature that is currently on the map.
/listwaypoints - Lists all waypoints that have been set on the given map
/msg hello world - Puts a message on the console "hello world"
/music - Requests a music track to be played. Note that only one or two tracks can be player per day.
/music 10 - Sets the volume of music to 10.
/pos - Gives the players position in X Y Z coordinates
/rem example - Removes the waypoint named "example"
/removedrops - Removes items that are on the ground nearby
/removedrops all - Removes all items on the ground in the world
/repair - Repairs the current item
/repair all - Repairs every item in your inventory
/replenish - Makes the current stack maximum again
/replenish all - Makes all stacks maximum
/return - Teleports the player to the position they were before they teleported. 
/search pick - Searchs items for the name "pick" and returns all matches.
/set example - Sets a waypoint at the current position named "example"
/setjump 5 - Sets the player jump to 5.
/setjump reset - Resets the player jump to default.
/setspawn - Sets the current position as the spawn point
/setspawn 0 66 0 - Sets the spawn point at (0,66,0)
/setspeed 5 - Sets the player speed to 5.
/setspeed reset - Resets the player speed to default.
/spawn list- Prints a list of monsters and monster codes to screen
/spawn random - Spawns a random monster
/spawn random 10 - Spawns 10 random monsters
/spawn creeper 20 - Spawns 20 creepers
/spawn 92 - Spawns creature #92
/spawn 92 5 - Spawns 5 of creature 92.
/spawnstack list - Prints a list of monsters and monster codes to screen
/spawnstack Zombie - Spawns a zombie nearby
/spawnstack 92 - Spawns the creature with id = 92, a cow in this case.
/spawnstack random - Spawns a random creature
/spawnstack r r - Spawns two random creatures ontop of one another
/spawnstack 92 Creeper 56 - Spawns creature 92 ontop of a creeper ontop of creature 56 (ghast > creeper > cow)
/tele 0 66 0 - Teleports the player to the coordinates (0,66,0)
/time - Gives the player the current time
/time day - Sets the time to the morning, ie: hour = 0, same as /time set hour 0
/time night - Sets the time to night, ie: hour = 13, same as /time set hour 13
/time get hour - Gets the current hour
/time get minute - Gets the current minute
/time set day 1 - Sets the current day as 1
/time set hour 10 - Sets the current hour as 10
/timeschedule 12:00 0:00 - Sets a time schedule of 12:00 to 0:00. This means that once the time hits 12:00 it will go to 0:00
/useportal Puts you in the nether, run again to go back to the normal world.
/waterdamage - Turns water damage off

---World Edit Commands---------------------------------------------------------
//set1 - Sets position 1.
//set2 - Sets position 2.
//fill 1 - Fills the region between position 1 and position 2 with BLOCKID 1 (stone)
//box 3 - Creates a box in the region of position 1 and position 2 which is made of BLOCKID 3 (dirt)
//remove - Removes the region between position 1 and position 2.
//get - Gets position 1 and position 2 and prints them to screen
//reset - Resets position 1 and position 2
//copy - Copies the BLOCKS between position 1 and position 2, these are put into memory.
//paste - Pastes the blocks which were copied into memory, into minecraft to the north-east of the player.
//save - Saves the copied region to file
//save file1 - Saves the copied region to file - "file1"
//load file1 - Loads the file "file1" into memory which can now be "pasted"
//expand north - Expands the selected region north 1 block
//expand up 10 - Expands the selected region up 10 blocks
//contract east - Contracts the selected region 1 block from the east
//contract south 10 - Contracts the selected region 10 blocks from the south

-------------------------------------------------------------------------------
---8. Properties File----------------------------------------------------------
-------------------------------------------------------------------------------

To change command names from what they are to alternate versions you need to 
add this file to your .minecraft directory.

.minecraft/mods/sppcommands/sppcommands.properties

Within this properties file should be key value pairs seperated by an equals "=" 
sign. Where the key is the command name and the value is the new value.

For example to change /goto to /warp

goto = warp

Example sppcommands.properties file
#START OF FILE

give =
goto = warp
item = 
pos = 
p = 
spawn = q

/set1 = /s1
/set2 = /s2

#END OF FILE

-------------------------------------------------------------------------------
---9. Support------------------------------------------------------------------
-------------------------------------------------------------------------------

If you are having any trouble with this mod please post on this forum thread, I check it regularly:
http://www.minecraftforum.net/viewtopic.php?f=25&t=100267

That way when I help you with your problem, people with the same problem can also find the solution.

Bugs Reports/Bug Fixes/Feature requests/Problems should all be posted on that forum thread.

I love hearing feedback, so any feedback so greatly appreciated, if you like the mod please tell me!
