Cornucopia V3.0 for Creatures 3 and Docking Station 
-- hm_cornucopia3.txt - October 15, 2001

Version 3.0
   Fixes a bug in the Bubble Remover Agent

Version 2.0
   This version limits the number of bubble toys in the world, 
   to keep from slowing the game. Bubbles are also more likely
   to pop, and the dispenser can now be activated with a push
   or a pull.

_______________________________________________________________
_______________________________________________________________

                 --- DISTRIBUTION ---
Do not place this agent on your webpage without receiving
permission from the author first. Please use the contact info 
supplied below to ask for permission.

E-mail:    Hausmouse1@aol.com
Webpage:   http://members.aol.com/hausmouse4/index.htm
_______________________________________________________________
_______________________________________________________________

                 --- Installation ---

If you have C3, to use this agent you must have the C3 update 
two!

To see if you have the update press ctrl-shift-enter to put 
Creatures 3 into windowed mode. The window should say 
'Creatures 3 - Engine 1.162'. You must start a new world for 
the update to take effect. Worlds created prior to the update 
will not inject agents correctly, even if you have installed 
the C3 update. Press ctrl-shift-enter to get back to 
full-screen mode.

If you are using Docking Station, don't worry, everything 
should work fine.

_______________________________________________________________

                 --- Attention! ---
Please remove the older version(s), hm_cornucopia.agent or
hm_cornucopia2.agent from your Docking Station and (if you have 
it) Creatures 3 My Agents folders before injecting this agent. 
If you don't do this step, the new version may not show up 
correctly. 


For C3 standalone:

Put hm_cornucopia3.agent into your My Agents folder. Start 
Creatures 3 and go to the Agent Creator Machine. Make sure you 
have gotten the Creator Efficiency power-ups and have at least 
500 units of Bioenergy. Click the arrows until you find the 
Cornucopia v2 for C3, then click the round create button. 

To remove this agent from your world you must use the 'remove 
agent' function of the Agent Creator Machine. The Cornucopia 
can also be recycled!
_______________________________________________________________

For Docking Station:
(Capillata only or docked with C3)

Put hm_cornucopia3.agent into your Docking Station\My Agents 
folder. Go to the Comms center and click the Agent Injector 
Button. The Cornucopia for Docking Station should appear in 
the available agents list. Select it by clicking its name, then
press the check mark to inject it into your world. Injecting 
the Cornucopia will also place an icon for my website on your 
Websites screen.

If you click the 'C3' tab on the Agent Injector, you will see 
the Cornucopia for C3 listed as well. It's okay to inject this 
agent too, there won't be any errors.

If you have a Docking Station capillata that has been docked 
with C3, you can use the Creator Machine in Engineering to 
create the Cornucopia, just as you would in C3 by itself.


Please let me know if you have a problem with this agent.


Bugs and Known problems:
The last version had a bug in the accompanying bubble-remover
agent. This has now been fixed. (I hope.) 

A number of people have complained of too many bubbles in their
worlds, so this version limits the total number of bubbles 
in a world to 250.


DESCRIPTION:
_______________________________________________________________
In Greek mythology, the Cornucopia was a magnificent horn that 
filled itself with with whatever meat or drink its owner 
requested. In modern times it has become the symbol of plenty.

Some legends say the god Zeus fashioned the Corucopia from the 
horn of the she-goat Amalthaea, who nursed him as an infant. 
Zeus also set Amalthaea's image among the stars as the star 
Capella in the constellation Capricorn.

When pushed either by a creature or by the hand, the Cornucopia
creates a little bit of everything good: food, fruit, seeds, 
and toys.

Actually the Cornucopia produces *lots* of everything good --
it *is* the symbol of plenty! However, to keep from burying
your creatures under mountains of goodies, the Cornucopia
is programmed not to dispense more than 50 of each food
type into the world. That's still a lot of things to eat!

The food and seeds are simple edible objects, except for the
bright colors!

Cornucopia toys come in the form of bubbles. They give 
creatures the appropriate toy stim when pushed or pulled, and 
can also be hit, which does not give a toy stim. Like real 
bubbles, the Cornucopia bubbles are short-lived, having a 
random chance of popping whenever they come into contact with 
a wall or are played with. Hitting a bubble has the greatest 
chance of popping it.

In this new version there can be no more than 250 bubbles in 
a world at one time. Also, bubbles are now twice as likely to 
pop as they were in the first version. 

Cornucopia fruit can be a bit strange. Each type of fruit has
its own set of beneficial chemicals it injects, in addition
to giving the Norn an 'eaten fruit' stim. All chemicals are
injected in moderate amounts. Also, the fruits themselves
appear in a random but weighted order.

FRUIT:
Purple Striped Melon
  -- Prostaglandin, Arnica, EDTA
     probability: 5%
Pink Striped Melon
  -- Prostaglandin, antihistamine, sodium thiosulphate
     probability: 5%
White Striped Melon
  -- Prostaglandin, Medicine one, Anti-Oxidant
     probability: 5%
Squash
  -- Builds muscle tissue (anabolic steroid, protein)
     probability: 7.5%
Watermelon
  -- Vitamin E and Vitamin C
     probability: 5%
Artichoke  
  -- Builds muscle tissue (anabolic steroid, protein)
     probability: 10%
Pear
  -- Vitamin E and Vitamin C
     probability: 10%
Surprise Mystery Fruit
  -- no extra chemicals added
     probability: 2.5%
Chromatic Foxfire berry
  -- removes all antigens and toxins, slightly extends Lifespan
     probability: 2.5%
Apple
  -- Increases fertility (arousal potential, sex drive)
     probability: 12.5%
Peach
  -- Increases fertility (arousal potential, sex drive)
     probability: 12.5%
Orange
  -- Same as DS lemon (antihistamine, antibodies)
     probability: 12.5%
Lemon 
  -- Same as DS lemon (antihistamine, antibodies)
     probability: 10%

_______________________________________________________________

Files added by agent:
hm_cornucopia.c16
hm_logo.c16
hm_cornucopia.catalogue
crnu.wav - a new sound
clak.wav - native to C3, do not delete from ..\Creatures 3\Sounds
eat1.wav - native to C3, do not delete from ..\Creatures 3\Sounds
pop1.wav - native to C3, do not delete from ..\Creatures 3\Sounds
dr64.wav - native to DS, do not delete from ..\Docking Station\Sounds

The Cornucopia will not extract files that are already present
in the appropriate folders. In fact, if you have C3 installed,
it seems not to extract the sounds into the Docking Station 
Sounds folders at all. Very strange.

SCRIPT NUMBERS:

Cornucopia (dispenser)
2 23 54003 1
2 23 54003 6

Bubbles (toy)
2 21 54004 1
2 21 54004 2
2 21 54004 3
2 21 54004 6

Cornucopia Food (food)
2 11 54003 6
2 11 54003 12

Cornucopia Fruit (fruit)
2 8 54003 6
2 8 54003 12

Cornucopia Seeds 
2 3 54004 6
2 3 54004 12

_______________________________________________________________
If you have any problems installing the Cornucopia, or if you
would like permission to post this agent to your website,
please contact me at: Hausmouse1@aol.com

