***RM_248 - VC Subway Car***

So, welcome to Vice City, home to a million souls, and about twice that number of actual people...

Thankyou for downloading this room, and I hope you have as much fun using it as I have had in creating it. The Subway
Car is part of the Vice City (VC) series, reacreating the gritty feel of a city plagued by crime, the subway tunnels that
lie far beneath it's mean streets a convienient way to cross the city by day, and a death-trap to the unwary by night...

Included are three different 'Scenes':

* Crowded		A packed commuter train slows down as it approaches the subway station
* Empty			An empty carriage late at night speeds up inbetween stations
* Notinservice		Lights dimmed, an out of service train speeds through the tunnels

Furthermore, because Room 248 is an empty room, it has only one location (as opposed to your usual rooms with multiple
locations). To counter this, Object Parenting has allowed all objects in the room to be moved at the same time, allowing
you to move the room to suit your pose rather than having to adjust the pose to suit the location. This has been done
with the use of ControlBalls (see below for more information).

In addition to this, there are also extra locations for each Scene, meaning that you can move the objects to where you 
want to be in one location, then in another location have the objects in a completely different place, meaning that you 
don't have to keep moving all the objects in the room all the time! How's that for customisation! :)

This has been done through the use of xGMM , a JSGME-compatible generic mods manager by gerello. See below for more details. 

- Number251137

_________________________________________________________________________________________


***Requirements:***

* Hook 5 (Paid)
* Siberia's Hook5 Object Pack, plus all the updates

_________________________________________________________________________________________


***Installation Instructions***


For users of Klub 17 v.7.5: 

* Unpack the folder 'v.7.5' into your base game folder. The file directories have been set up so that the .txx file 
  should go into your Archives -> 2.114.001 folder.   

* Unpack the folder 'All Versions' into your base game folder. The file directories have been set up so that the
  .ogg files should go into the Music folder and the objects/envmaps/particles/scripts/room files should go into
  your Mod -> ActiveMod folder. Overwrite any files.


For users of Klub 17 VX:

* Unpack the folder 'VX' into your base game folder. The file directories have been set up so that the .zip file 
  should go into your Addons folder.   

* Unpack the folder 'All Versions' into your base game folder. The file directories have been set up so that the
  .ogg files should go into the Music folder and the objects/envmaps/particles/scripts/room files should go into
  your Mod -> ActiveMod folder. Overwrite any files.

_________________________________________________________________________________________


***Object Parenting***

Q. What is Object Parenting?
A. Object Parenting is the ability to control multiple objects, lights and particle effects with just one object.

Q. So, how does it work then?
A. Just move the ControlBall as you would any other object. The objects attached to it with move along with it.

Q. Does it only work for objects?
A. Object Parenting also works for lights, as well as Particle effects (or as I call them, environmental effects),
   like smoke, fire, lightning, etc.

Q. What happens if I change Scenes?
A. Object Parenting WILL NOT WORK once you select a new Scene through the Hook 5 'Includes' menu. In order to 
   activate Object Parenting in the new Scene, 'Save' it and then click the 'reload' button. If you are unsure how
   it works, the visual aid 'Scene Selection' located in the main folder should help.

Q. Why is the introduction of Object Parenting significant?
A. It's significant because a single object can now control all the objects tied to it. For example, you might
   add a table to your room and then add things on top of it. To move it, you would have had to move each 
   individual item to a new location. By tying all the objects to one object, you can now move the table, and
   all of the items on it at the same time!

Q. Why is this even more significant for object rooms?
A. Well, in rooms that consist entirely of objects, you will have far more freedom to reposition your room in order
   to suit your poses. Because that entire room, and everything in it, can be so easily moved, you can then move
   the whole room, rather than having to rely on a few pre-programmed locations you would see in most 'normal' rooms.  

_________________________________________________________________________________________


***ControlBalls***

Q. So, what are ControlBalls then?
A. Well, ControlBalls are simply a convinient way of tying objects to a single object. Rather than having a random
   object as the 'controller' of several objects, by assigning a ControlBall to the collection of objects you
   wish to tie together, you are able to instantly recognise the object you need to move in order to move them all.

   Take the example above. If you had a table with objects on it, then one way would be to tie all the objects to
   the table, and then move the table. But if you didn't know that all the objects were tied to the table, you
   would have to mess around trying to work out which object moved everything. By designating a ControlBall as the
   controlling object, it is obvious which object you need to select to move all the objects.

Q. So what's with all the Tiers then?
A. Each Room should be able to be moved using a single ControlBall. In order to do this, each ControlBall was 
   assigned a 'Tier number', so that higher Tier ControlBalls can control lower Tier ControlBalls. 

Q. What are you talking about?
A. Okay, so a Tier1 ControlBall can move the table in the example above, and in turn, a Tier3 ControlBall can 
   move that Tier1 ControlBall AND the table. But that Tier3 ControlBall can ALSO move another Tier1 ControlBall
   that moves a bed. In this way, it should be clear (hopefully!) what you need to move in order to move all the
   objects in that room. If you are unsure how it works, the visual aid 'Using ControlBalls' located in the main
   folder should help.   

_________________________________________________________________________________________


***Adding Locations***

Q. How do I add additional locations?
A. There are two options. For experienced Gardeners, you can just copy and paste the relevant file into the 
   'RM_248 - VC Subway Car' folder. The _level defintion file has been set up so that it will automatically 
   recognise the new 'scene' and you will be able to activate it in the Hook 5 'Includes' menu as normal.

   Option 2, perhaps a method for newer Gardeners, or those less familiar with the level defintion file
   structure, is to use the Generic Mod Manager to move the relevent 'scene' to the 'RM_248 - VC Subway Car'
   folder. If you have unsure how it works, the visual aid 'Adding Locations' located in the main folder
   should help

Q. Why not just put all the 'scenes' in the folder to start with?
A. This is an entirely reasonable question, and the reason I didn't do that was because it cluttered up the 
   Hook 5 'Includes' menu with scenes you may not even want or need. This way, you only get the scenes you
   want and it looks far cleaner.

_________________________________________________________________________________________


***Addendum***

I think I've covered almost everything, but if I've missed something, or you're still a bit unsure about
how something works, don't hesitate to message me. Have fun!

- Number251137