AKK Horse Ranch 

AKK Smart Horse Touring Carriages

The AKK Smart Horse product line offers Second Life Sim Owners a way to offer automated tours of their SIMs.  These products are based on the AKK 08 Legend Horses and Carriages.  The touring script they are based on is by Yavanna Llanfair of YavaScript.  She has kindly modified her scripts to talk with the AKK Smart Horse carriages.

The Smart Horse Touring Carraiges can used in standalone mode or on demand mode.  Standalone mode is a carraige that is already rezzed and waiting for someone to use.  On Demand Mode is where the carriage rezzes when someone touches the Smart Horse Calling Post.

The first section of this page is how to program in tours.  The second section will be on how to set up the on demand mode. 

When you receive your Touring Carriage, a tour designer staff is provided.  It serves 2 purposes; 1) it can be used to design each tour by wearing it and walking to each place you want something to happen (you need to indicate the action on the menu when you get to that spot) and 2) wear it once in awhile to check for updates to the carriage.

All AKK Smart Horse Carriages are controlled by tour definitions.  These tour definitions are define in a notecard named "Pod destinations", placed in the contents of the Smart Horse carriage.  (When ever the pod destinations notecard is changed, the "Pod transport script" needs to be reset.  to do this open it and press the reset button)   The owner of the Smart Horse determines the route, speed, and text to be displayed to the riders.  The following is the documentation for building routes.  It is broken into 3 parts:

1. The basic commands are understood by Yav's scripts.  The AKK Smart Horse has default behaviors that make these the commands enough to learn.
2. The basic AKK Smart Horse Extensions to take advantage of the additional Smart Horse capabilities.  These capabilites like raising the raising the or lower the convertable top, turning on and off lights, enhance the tour experience.
3. The advanced AKK Smart Horse Extensions that override the default behaviour of the Smart Horse.  These commands can overide the horses poses and default speeds for trot and gallop.

Basic Commands:

The basic tour definition is of this format (bold indicates a command):

{

Name: tour name

Position: waypoint position to proceed to 

Text: Text to be displayed with a whisper

Rotation: rotate to look at a point of interest 

Pause: time to wait at the way point

Position: the next waypoint to proceed to

Speed: the speed to proceed to the next way  point

... : the rest of the instructions

Position: the last waypoint

}

All tours are started with a "{" and ended with a "}".  There can be multiple tours in the notecard.  The AKK Smart Horse comes with sample tours based on the AKK Horse Ranch Island.

The following is a list of the basic commands, their format, what they do, and examples:

• { - begin tour definition - required
• Name: - Name: tour name - free text after the command, only the first 12 charaters wil be displayed in the popup dialog for the tour rider to choose from.  (example - Name: Tour Sim)
• Position: - Position: x,y,z - where x,y,z are the coordinates of the next waypoint.  The Position can be on or above the ground, the carraige cannot go underground, though it can go under the water.   (example - Position: 10, 31, 21) moves the AKK Smart Horse Touring Carriage to the coodinates of <10, 31, 21> on the current region.  To specify positions in an adjacent sim to the west use (waypoint position.x - 256) for the x position, for a waypoint in the sim to the east use (waypoint position.x + 256) for the x coordinate.   for a waypoint in a sim south of the current use a y coordinate of (waypoint position.y - 256) and for a sim to the north use (waypoint position.y + 256) for the y coordinate.  (example - Position: -3, 125, 21) specifies a position in the sim to the west of the current sim at  <253, 125, 21>.  Another note, by default, the smart Horse will use the fly pose if the carraige is over 2 meters above the ground.
• Pause: - Pause: n - where n is the number of seconds to pause, before proceeding to the next command.  (example - Pause: 5) pauses 5 seconds.
• Speed: - Speed: n - where n is a value between 1 and 100.  The AKK Smart Horse Touring Carriage defaults to walking at speeds up to 20, troting at speeds between 20 and up to 40, and gallops at speeds over 40.  (example - Speed: 25) by default the carraige will betroting to the next way point at a speed of 25.
• Rotate: - Rotate: d - where d is the number of degrees to rotate in a counter clock wise position.  a negative d will be the number of degrees in the clockwise position.  (example: Rotate: 90 ) will rotate the carriage 90 degrees counter clockwise, so if it is facing straight north it will now be pointing straight west.  (example: Rotate: -90 ) will rotate the carriage 90 degrees clockwise, so if it is facing straight north it will now be pointing straight east. 
• Text: - Text: commentary - where commentary is the text to be displayed whith a whisper.  SL only displays the first 256 characters of the comentary and only the text that is on the same line Text: command wil be displayed.  (example - Text: Welcome to the begining of the tour) would display the words "Welcome to the begining of the tour" in anyones chat window that is with in 10 meters of the tour carraige at that point.
• } - end tour definition - required all tour definitions must end with a }.

Basic AKK Smart Horse Touring Carriage commands

These basic commands control the lights and convertable top of the carriage:

• Ext: topup - puts the top up on the carriage if it is equiped with a convertable top.  This is the default state for the top
• Ext: topdown - put the top down on the carriage if it is equiped with a convertable top.
• Ext: autolights - the lights on carraiges that have them automtatically are on between sunset and sunrise.  This is the default state of the lights on carraiges that have them.
• Ext: lightson- forces the lights to be on for carraiges equiped with them
• Ext: lightsoff - foreces the lights to be off for those carriages that are equiped with them.

Advanced commands for the AKK Smart Horse Touring Carraige:

These commands are used to override poses and set behavior paramaters (and extended sample of how to use these comands can be found in the tour Smart Horse Carriage that you purchase):

• Ext: autogait - This tells the Smart Horse to determe which animations to perform based on speed.  This is the default mode.  If after using a forced pose the horse should return to this mode, then use this command.
• Ext: stand - forces the Smart Horse to stand until a different animation or Ext: autogait is found in the tour description.  The Horse will stand while moving if this command is used.
• Ext: walk - forces the Smart Horse to walk until a different animation or Ext: autogait is found in the tour description.  The Smart Horse will walk even while the carriage is paused if this command is used.
• Ext: trot- forces the Smart Horse to trot, even while the tour is paused, until a different animation or Ext: autogait is found in the tour description.
• Ext: gallop - forces the Smart Horse to gallop until a different animation or Ext: autogait is found in the tour description.
• Ext: fly - forces the Smart Horse to fly until a different animation or Ext: autogait is found in the tour description.
• Ext: gallopspeed - Ext: gallopspeed n - where n is the speed at which the horse automatically (autogait) gallop.  The default is 40.
• Ext: trotspeed - Ext: trotspeed n - where n is the speed at which the horse will automatically (autogait) trot.  The default is 20.  The Smart Horse checks the gallop speed first and then if the speed not greater than gallop speed it checks the trot speed. 
• Ext: randomon- turns on the random sounds in the Smart Horse.  This is the default
• Ext: randomoff- turns off the randome sounds in the Smart Horse.
• Ext: randommax - Ext: randommax n - where n is the maximum number of seconds to wait for a random sound.  For a tour this should probably be short.  If you leave the smart horse out so people can just jump on and tour, then at the end of the tour you may want to set this to longer like 2 - 5 minutes.  The formula that is used to determin if a sound should be made is time to wait is (max - random(max - min)), max has to be greater than min.
• Ext: randommin - Ext: randommin n - where n is the minimum number of seconds to wait for a random sound.  For a tour this should probably be short.  If you leave the smart horse out so people can just jump on and tour, then at the end of the tour you may want to set this to longer like 2 - 5 minutes.
• Ext: play - Ext: play name, volume - where name is the name of the sound to play (it must be included in the contents of the Smart Horse or a UUID of the sound from your inventory).  The voulume is how loud you want it to be and is between 0 and 1.00.  It takes time to load a sound to the visitors client, so this should be a low bit rate sound sample.  If you don't want have the sound played randomly either use the UUID of the sound or preceed it with a "nr_".  nr stands for nonrandom.  When the "Touring carraige main script" is reset (which is done by opening it (you will not se the code) and pushing the reset button it will initialize the script to the default values, and reload all the sounds in the contents of the AKK Smart Horse.  Thus you can add any sounds you want to have.  If the sound name starts with nr_, then it will not be included in the random sound list.  For example, you would not want a voice description of a spot to be included in random sounds, so "welcome message" would be saved in the contents of the AKK Smart Horse as "nr_welcome message".  Or even better right click on the sound when it is in your inventory and select Copy Asset UUID and then paste that into the Ext: play command.  (example, Ext: play e0d2d1e0-2486-2d33-755c-45f2aa3c62ad

On Demand Mode Instructions:

Once you have programmed Smart Horse Carriage with tours, you may want to more than one carriage available for touring.  This is done by:

1. Take the programmed carriage into inventory
2. Rez a Smart Horse Caller Post
3. Edit it and go to the contents tab (if the contents tab is not showing, press the more button
4. Delete any objects, but no the script from the contents
5. Drag the newly programmed carriage from your inventory into the Caller Post. 
6. You can then take the post into inventory or move it to its final location.