Model Citizens - v0.8 for Minecraft 1.7.10 - By FyberOptic
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Model Citizens allows you to place character models into the world
which can be posed, wear armor, hold items, and have a complete
inventory that players can loot.

Models can be spawned by using a Model Placer item, only obtainable
from the Creative menu or by players breaking a model already in the
world.  Using the item produces a Steve model by default, facing your
orientation.

Right-clicking a model provides you access to its inventory.  At the 
top left are standard armor slots, which will render on the model.
The top right area will display the model's name.  Below is a 
standard player inventory arrangement, with the bottom-left slot 
having a hand icon.  Any object you place in this slot will render 
in the model's hand.

Models are weak against shovels, but are invulnerable to explosion
damage.  This prevents accidental removal of important models (and
their inventories) from your maps.    

When broken in creative model, a model is fully destroyed.  When in
survival, the model drops its full inventory as well as a Model 
Placer item.  The item will retain its information and can be placed
again in the world, with only its orientation changing when placed.

When in creative mode, using middle-click to pick the block will 
similarly duplicate a model, as well as its entire inventory.  This
allows you to quickly place many similar copies in the world.

To pose and customize a model, shift-right click its base with an 
empty hand while in creative mode to get its configuration GUI.  
There are several pages of settings.  The initial page allows you to 
specify the model type (either standard or skeleton), and to enter a 
username to use for the texture.  The other pages allow you to set 
the model's orientation.

Right-clicking in the configuration GUI will toggle the controls up and
down, allowing you to move it out of the way while posing it.  Both
the position and the page will be remembered if you exit the GUI, 
making it easy to pick up where you left off if you have to move your
character for a better view while posing.

If you wish to use a standard skeleton model and texture, but still 
give it a custom name, then prefix the name with an exclamation mark.
This would also allow a custom name for the Steve model.

Model textures are searched for locally first, from within the mod 
JAR itself.  If not found there it will pull the standard model for
that player from Mojang's servers.  The location within the JAR to 
place your custom textures is assets/modelcitizens/textures/models.  
Make sure they're PNG format, and that the filenames are all lower-
case.



-- Changelog --

v0.8 - Sunday May 24th, 2015
 - Fixed face culling for skeleton
 - Fixed server-side crash on startup
 - Models can be broken (vulnerable to shovel), still explosion-proof
 - Models drop their items and a copy of themselves in survival mode
 - Middle-click block select in creative mode duplicates model and inventory
 - Added ability to add custom model textures into JAR

v0.7 - Saturday May 23rd, 2015
 - Initial release!
 



