Model Citizens - v1.0 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 (if enabled in the config).  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.

When invulnerability is disabled, models are weak against shovels, 
but are still invulnerable to explosion damage.  This prevents 
accidental removal of important models (and their inventories) from 
your maps.  When broken, the model drops its full inventory and 
optionally a Model Placer item (if enabled).  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.

Using the mouse wheel in the configuration GUI will either flip
through the pages or finely tune a slider control depending on what 
you're hovering over.  Holding shift while doing this will adjust 
a slider even more precisely.  

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 different display name than the texture name,
or want to use a default Steve or skeleton texture along with a 
name, then the exclamation mark can be used as a separator.  Texture
name goes first, then display name.  Leave the texture name blank 
to use the default Steve or skeleton ones.

Model textures are searched for locally first, from within the 
config/modelcitizens folder.  If not found there it will pull the 
standard model for that player from Mojang's servers.  Your custom 
textures should be in PNG format, and the filenames all lowercase.



-- Changelog --

v1.0 - Friday May 29th, 2015
 - Added ability to scale models
 - Mouse wheel now scrolls through model configuration GUI pages
 - Mouse wheel finely tunes sliders, even more precise if shift is held

v0.9.2 - Monday May 25th, 2015
 - Increased render bounding box to pass frustum check

v0.9.1 - Sunday May 24th, 2015
 - Fixed crash in model configuration GUI 

v0.9 - Sunday May 24th, 2015
 - Added config options for invulnerability and model item drops
 - Changed name field to allow ! to separate texture and displayed name
 - Got rid of lava block breaking texture
 - Fixed name not being saved if GUI closed too quickly after changing 

v0.8.1 - Sunday May 24th, 2015
 - Fixed bug introduced in 0.8 preventing skeleton model from being posed 
 - Changed custom texture location to config folder

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!
 



