This book contains all of the base materials you can use when building objects.

readall book of materials to see them all

Use materials this way:

create a box made of metal the material called metal will be used to colour and code the box.

This way all metal objects will have similar properties without having to hand code them.

NOTE: Not much time has gone into thinking about what these base materials should be like so all suggestions are welcome.

Please address all suggestions to wolis like this:
create a suggestion for wolis
edit it
post it

Thanks

giant earthworm

This is a pretty ordinary giant earthworm.

material called aberration

Creature Material

Hmm, this one is really hard to explain. This will be done later.

I.E. mindflayers (illithids), aboleths, neogi, grick, phantasmal slayer

material called adamantine

Object/Construct Material


An extremely rare metal. Very, very hard. Adept at breaking other weapons when in weapon form. Adept at blocking and protecting against blows as an armor.

material called animal

Creature Material


Animals are defined as creatures without the intelligence to be considered sentient.

I.E. dogs, horses, birds, bulette

material called beastiary

This material is placed on those little white buttons you find in each zone object in the beastiary. You simply push it after creating your creature and setting it up with a weapons and treasure.

material called candle

The candle material reacts to the light and blow commands.

When lit, it will light the location, but shorten over time until health is gone.

The rate of shortening depends on the worth of a single candle. If you create 10 candles worth 100 then light the candles, each candle is worth 10 pennies and will shorten by 1 health every 1 out of 10 ticks until it burns out. The total worth is reduced by the worth of 1 at that time.

If you create some candles, the singular class becomes 'candl'. This material detects and fixes it to 'candle' when lit.

If there are more than 1 candles (using the more command), then each time it burns out, qty will be reduced and health will go back to healthmax.

material called construct

Creature Material


These are creatures that are technically not living. Inanimate objects given the semblance of life by magic.

I.E. golems, animated objects

material called decaymeat

This material causes an object to be infested with vermin and gradually decay until it erases itself and is gone forever.

Works with tickloc, so decay is arrested when no one is around to see it.

Blocks: tickloc,ticked,decay,zero,slightly,partly,mostly,fully,byebye,kicked,dropcoins

Note: if the corpse has some worth, and someone kicks it, then it will create a pennies object that is worth a random part of the original object's worth, while deducting its own worth. Even if there is no worth, it makes a disgusting squishy sound.

Coders: Note the use of matvals to keep a counter. If we do it this way instead of using the counter field then you can have multiple materials that don't walk over each other's counters.

Customizing
On the final decay phase, just before erasing the object, the block deathbydecay is called. Create this block in an object with this material on it to do something appropriate.

An example: read the material called leadquest

material called demon

Creature Material


Demons are evil and chaos personified. They do what they want, how they want.

I.E. balor, demogorgon (demon prince), succubus, babau

material called devil

Creature Material


Devils are evil and order personified. They do what they want, with planned, careful tactics.

I.E. pit fiend, bone devil, erinyes

material called difficult

This material can be used to make things a bit harder to do.

It requires some preparation.

Commands that currently work with this material: use, go

Step 1. Create the object, or choose one you already created.

Step 2. Put this material on the object

material it as _difficult_

Step 3. Script the object.

Make a difficultdata block that sets the following variables: $dcommand, $dlevel, $dskill, $dskillcap, and $dskilltip.

Then script something for failure under a fail* block (where * is the command name you put in $dcommand).

If you don't do that, then the following scripts will happen by default:

##difficultdata:
$dcommand = 'use';
$dlevel = 5;
$dreq = 0;
$dskill = 'problem solving';
$dskillcap = 10;
$dskilltip = 69106;

##failuse:
''[$init_obj] has trouble figuring out [$target]'';

Note: double-quotes appear as '', so if you copy/paste the above you will need to change them back.

The settings:
$dcommand - The command that will be difficult when this object is the target (or second).
$dlevel - The value used for the skillcheck.
$dreq - The minimum skill required to even attempt this.
$dskill - The skill to be compared with the command.
$dskillcap - If the player doesn't have this skill, cap it at this value.
$dskilltip - if the player doen't have the skill, this is the object id of what tips the player on how to increase their 1st cap. 69106 to see how the above example is set up.

failuse - This block is called whenever the player tries to use the object but fails the skill-check. Other block names could be failpush, failpull, failgo, failget, etc.

Skill checks
Skill checks are only performed if the player meets the minimum $dreq. This is the basis for the spell system, where spells can only be cast if one trains 1st within the appropriate school, and some trainers refuse to train those who have used skills they are strongly against.

To pass a skill check, the system generates a random number between 0 and the sum of the player's skill value with the $dlevel value. If the number is higher than the $dlevel value, then they pass the test. If the number is less, then the player is awared a point towards the next level of that skill.

Step 4. Prepare the object

init it

The material will read the values in the difficultdata block and assign them to the material's values. Then it will report back with all of the difficulties placed on the object (uhh... when Thorn gets that report done).

Step 5. Repeat step 3 and 4 for each additional command.

Change the script in the difficultdata block and prepare again via the init command to make it difficult for more commands.

For example, let's say you have a trumpet that is hard to play. You could require a skill like 'music' for the use and play, and blow commands. Since the commands are synonymous, just edit the $dcommand to each command then prepare the object with init to add it.

And finally...
If you ever decide you don't want the object to be difficult, simply remove the _difficult_ material.

Or perhaps you messed up and want to start over, simply material it as _easy_, then init it. The easy material will remove the settings prepared previously with the _difficult_ material. Now replace _easy_ with _difficult_ and go to step 3.

think I could even make myself difficult

material called door

This door material checks the linkstate of the acting door to work out if its open or closed and displays messages accoringly.

Reactions:
say

Materials:
{none}

material called dragon

Creature Material


Ah, this one is rather self explanatory.
Varieties: chromatic, metallic, gem, epic, extraplanar

material called easy

This material is designed to make life easier.

Let's say you created an enigma and gave it the material called difficult. Now let's say you customized it and used the command called init to set up the difficulties for various commands and such. Then what if you goofed? You can erase the material values by replacing the material with this one and using the init command.

Hey... it beats erasing it and having to redo all the scripting

think doesnt Thorn know about basic computer skills like CUT and PASTE?

material called eitr

This is a rather special material.

material called elemental

Creature Material


Elementals are the incarnation of their particular elemtent. Due to current lack of knowledge, how to implement each elemental type is currently not individually added.

I.E. fire, water, air, earth, paraelementals (combos)

material called encounter

This material is placed on an encountered creature by the zone material.

read the material called zone
read the command called setzone

If you want to set up a creature for random encounters. Place them in the beastiary in the appropriate zone objects. Create a new zone object if there isn't one that matches your zone name.

Reactions:

It will attack any player who arrives in the location.

It will also attack the person the zone material tells it to (via the wakes reaction).

When dead, it will unlock and drop all items wielded, worn, carried, and in inventory, setting ownership to the player that it attacked.

material called exitoutside

Put this material on an exit from a dark room to the outside world.

darken location
build a door to the yard
material the door to _exitoutside_

When open, the exit is set to the material called sky, which means it will light up the room during the day. The exit also takes on the colour of the sky.

When closed, the exit removes _sky_ and _light_ (just in case it was day when last opened). It also changes colour to brown.

You can also put this material on other objects besides exits.

darken location
create a window
material the window to _exitoutside_
open the window

Note, even though you can't go through the window, it still changes to the sky colour when open (lights the room as long as there is daylight).

Customizing
If you want it to be a different colour than brown while closed, then script the exit with the following (substituting 'blue'
of course)...

##getcolour:
$colour = 'blue';

If you want different open and close messages, script something like this:

##getopentext:
$opentext = 'Toxic fumes begin to enter [$loc] from [$actor]'';

##getclosetext:
$closetext = ''[$init_obj]'s hands felt something slimy on [$actor]'s handle'';

material called fey

Creature Material


Fey are the creatures closest to nature and have varying alignments and devotions.

I.E. pixies, nymphs, sylphs, faeries, dryads

material called fortified

This material works with the command called fortify.

Fortify creates objects with this material set. It also sets up the material values. One should not add this material without also doing everything fortify does.

Reactions:
Second of ram: reduces health of the fortification, and drops its exit when health reaches 0.

Second of repair: takes its exit and adds to health

material called friend

This material allows players to keep a list of friends, enemies, and arch-enemies

Reactions:

wakes - if waking object is set as enemy or kos then show the appropriate warning.

sleeps - if sleeping object is set as enemy or kos then show the appropriate warning.

arrives - if arriving object is set as kos then attack it

Customizing your attack
if you want to, you can script yourself with a whyattack block, where you can say something and set a delay (in seconds) before you automatically attack someone you set as kos.

Example:

##whyattack:
print ''[$actor] glares at [$init_obj] and says, 'You have angered me too many times, prepare to die!''';
$attackdelay = 10;

note: in the above code double quotes appear as '' so you will have to adjust your code as needed.

Also think what would happen if I called roam within my whyattack block?...

Related:

read the command called setfriend

material called healingloc

Reactions
hit, say, think, wish

and heals everything in the room by 1 point up to their healthmax

classes
none

Intended use
Give this material to an object in a location where activity happens and they get healed.. the more activity in the room, the faster the healing.

material called humanoid

Creature Material


The category you should be most familiar with.

I.E. humans, elves, dwarves, halflings, orcs, goblins

material called incorporeal

Creature Material


Incorporeal creatues have no physical form. Or they may be physical creatures temporarily becoming incorporeal. Basically they can pass through wall or can't be affected by non-magical means.

I.E. ghosts being example numero uno

material called killquest

This material can be used to manage a 'killquest'. This is a simple quest that involves finding and killing the object and receiving its treasure. Once killed, the quest is over and the object will decay and be erased forever.

Please don't put this material on a wimpy object worth 1 penny or with no weapon or items. Also, since the victor gets all that is wielded, worn, carried, or given, be sure the items supplied are hosted in the right way. Also remember to gender the object before you use it (which sets up the quest).

Example:
spawn robber from passive4
material it as _killquest_
gender it as him

Then work on making some decent items. For example, create a dagger and visit the blacksmith called Stan at the Smithy so you can put it on the forge to make it more deadly. Visit the Talisman of Cold (or Heat) to give it some enchanted attacks. Then force your killquest object to wield it. If you can code, then consider creating something unique and interesting as treasure. And if it is really worth the trouble, then consider setting the healthmax of your killquest object to something formidable, perhaps with the ability to gradually heal. Don't make it impossible. There's no fun in that. You can hint of the unique treasure by customizing the rumor and news (see below).

Reactions:
use: This does a number of things.
- a newsflash is created and published in the daily cow
- a rumour is created and recorded in the book of rumours
- the material's killquest values (qname, rumour, and lasthit) are set
Note: be sure to gender your object before you use it.

arrives: As long as the object is alive, this sets the lasthit value to whomever arrived. If the killquest object is alive it will also attack.

tickloc: This detects when health reaches 0 (or less) and does a number of things:
- Any object hosted to the killquest object with hosthow of 'wielded', 'worn', or 'carried' is unhosted and locked and owned to lasthit object.
- Same with anything in the inventory.
- The worth of the killquest object is transfered to the victor.
- The initial rumour is removed from the book of rumours and erased.
- An obituary is created and published in the daily cow, declaring lasthit as the victor.
- _killquest_ is removed and _decaymeat_ is added, which causes it to rot away and erase itself. read the material called decaymeat

Customizing the quest name and story
We tried to make the default name and story work well enough, but you may want something better. Some simple scripting can be used to customize the setup of your quest. Just script the object that has _killquest_ material on it, add a block named killquestdata. This will override the killquestdata block defined in the material object. The purpose of this block is to set up $questname which becomes part of some rumour and news object names, as well as $queststory which becomes the info of those objects. Don't put things like [$init_obj] in $queststory since it is not sent as a message but put in the info.

Note: you must do this before you use your killquest object, since this sets up the news and rumour.

Some variables are already available:
$myclass = The class of the killquest object.
$locclass = The class of the killquest object's location.
$heshe, $himher, $hisher = Make sure you gender {object} so these will hold something besides 'it'.
$myworth = How much your killquest object is worth (especially if you create {objectclass} worth {numberofpennies}.

Example:
##killquestdata:
$questname = ''A robber runs loose'';
$queststory = ''A robber has been spotted roaming about the old town. The $myclass was last seen lurking at $locclass and has stolen at least $myworth pennies. $heshe is armed and dangerous. We just want $himher killed, so you may take whatever $heshe carries.'';

note: double quotes appear as '' when you examine this, so you will need to fix the above example in your code

Customizing the attack
You can also use simple scripting to add something to the object's behavior before it attacks a player who arrives at its location. Just script the killquest object and make a block called whyattack where you can have it say something before attacking and even set a delay (in seconds) before it strikes.

Some variables available:
$init_obj = the object id of the player that just arrived.
$actor = the object id of the killquest object.

Example:

##whyattack:
print ''[$init_obj] recognizes [$actor] and exclaims, 'So you are the robber that has been looting this town!''';
print ''[$actor] glares at [$initobj] and fumes, 'So I am, but you will never escape to tell! Prepare to die!''';
$attackdelay = 10;

note: double quotes appear as '' when you examine this, so you will need to fix the above example in your code

material called leadquest

This material can be used to manage a 'leadquest'. This is a quest that involves finding and escorting the object to some destination, protecting it along the way, and receiving its treasure.

There are two ways this quest can end:
Failure- The leadquest object dies along the way and is left to rot away.
Success- The leadquest object is escorted safely to the destination.

Consider putting this material on a weak object, so that protecting it becomes a challenge. Also, since the successful escort will receive all items that are given to your object, be sure to give the leadquest object something as treasure that is worth the quest.

Setting up the quest requires the following steps:
1. Bring the object to the destination, then use it. The object will record the destination and begin following you.
2. Lead the object down a path that leads to the starting location. You must stop in each room and wait for the object to memorize it.
3. Once you are at the destination, use the object one more time and it will finish the set-up.
4. Now the fun part. Sprinkle some dangers along the path. For example: spawn a few passive creatures, forcing them to guard exits. Then put a couple of spawned aggro creatures in the same room. If you are a coder, then consider exploding or mechanical trap objects along the way, or perhaps something that triggers ambush.

Reactions:
first use: This does a couple of things:
- records the location as the destination in the material's leadquest values
- begins following you
second use: This does a number of things:
- a newsflash is created and published in the daily cow
- a rumour is created and recorded in the book of rumours
- additional leadquest values (qname, rumour, and lastloc) are set
Note: be sure you've gendered your object before using it the second time.

examine: This simply gives a hint that the leadquest object wants to talk (only shown if they are not hosted).

talk: This does a few things:
- records the player as the leader
- issues a conversation to start the quest with the player
- points at the 1st exit
- follows the player
However, talking to a dead leadquest object won't get you anywhere.

tickloc: This depends on whether the object is alive or dead, and whether set-up is complete or not:

tickloc during set-up (record path):
- determines if the location has changed since last recording
- if location is new, then search exits for one that leads back to the previous location
- If exit found then record the location and exit
- If exit not found, then transport you and it back to the last recorded location.

tickloc while alive (play path):
- determines if the location has changed since last recording
- if location is new, see if we are at the destination and complete the quest successfully
- else read it from the path memory
- if the location is in path memory, then point at the correct exit
- if the location is not in path memory, then abandon the escort and run back to the last known location

success:
- give the escort whatever is in the inventory
- issue a news article declaring the successful end of the quest
- remove the rumour from the rumour book
- remove leadquest from the object's materials

Note: for now, the quest object is just left at the destination, unable to do much from that point on. Thorn is contemplating it committing suicide once the winning player leaves the room.

tickloc while dead
- check and see if _decaymeat_ is in the material list
- if not then put it there and make a death throe

The decaymeat material will cause a deathbydecay message just before erasing the leadquest object that was left for dead. Players can avoid this by reviving it with the cpr command.

deathbydecay
- The initial rumour is removed from the book of rumours and erased.
- An obituary is created and published in the daily cow, indicating the escort being sought for questioning by the authorities.

Customizing the quest name and story
We tried to make the default name and story work well enough, but you may want something better. Some simple scripting can be used to customize the setup of your quest. Just script the object that has _leadquest_ material on it, add a block named leadquestdata. This will override the leadquestdata block defined in the material object. The purpose of this block is to set up $questname which becomes part of some rumour and news object names, as well as $queststory which becomes the info of those objects. Don't put things like [$init_obj] in $queststory since it is not sent as a message but put in the info.

Note: you must do this before you use your leadquest object the 2nd time, since this sets up the news and rumour.

Some variables are already available:
$myclass = The class of the leadquest object.
$locclass = The class of the leadquest object's location.
$heshe, $himher, $hisher = Make sure you gender {object} so these will hold something besides 'it'.
$destclass = the class of the destination (probably best not to reveal this, though).

Example:
##leadquestdata:
$questname = ''the frightened merchant'';
$queststory = ''A merchant is waiting at $locclass for someone to escort $himher on a dangerous journey. if taken safely, $heshe is prepared to award you with a reward.'';

note: double quotes appear as '' when you examine this, so you will need to fix the above example in your code

Customizing conversation
You can also use simple scripting to add something to the object's behavior when the player talks to it, before it follows the player. Just script the leadquest object and make a block called explanation where you can have it say something before following, and even set a delay (in seconds) before it strikes.

Some variables available:
$init_obj = the object id of the player that just arrived.
$actor = the object id of the leadquest object.

Example:

##explanation:
print ''[$init_obj] recognizes [$actor] and says, 'I heard you are looking for escort. How can I help?''';
print ''[$actor] grins at [$initobj] and replies, 'Ah yes, I would truly appreciate it. Now I shall show you which way to go as I follow.''';
$followdelay = 10;

note: double quotes appear as '' when you examine this, so you will need to fix the above example in your code

material called liquor

This material reacts to drink, putting a drunkenness modifier on both the aim and dodge skills for 60 ticks.

material called living

All objects with material = 'living' will do whatever this objects is coded to do.

Reactions:
push - says Oi
ask - says time (out of order)

Materials:
{none}

material called magicalbeast

Creature Material


Magical Beasts are similar to animals, although they have magical properties and some are sentient.

I.E. displacer beast, blink dog

material called meditation

This material is set on you when you use the meditate command and lasts until your mana is full or you are no longer sitting and meditating.

material called mithral

Object/Construct Material


Silvery, magical and rare metal. Is as hard as iron, but much lighter.

material called monstrous

Creature Material


Explanation forthcoming.

material called ooze

Creature Material


The oozes are essentially the creature that are well....ooze. Swarms of insects (and other things) are considered oozes due to the lack of a difinitive shape.


I.E. gelatenous cube, swarm of locusts (would also be vermin)

material called outsider

Creature Material


Outsider creatures do not hail from our plane of existance. They come from separate planes. On those separate planes they are no longer outsiders, but everything else not native to the plane would be.


I.E. anything not in its home plane

material called pet

For the moment it just serves to summon the object to you if it is evicted.

material called phazon

Reactions:
players by irradiating them

Materials:
viscous
toxic

material called plant

Any plant based material wil respond with 'grows a bit' whenever it is watered:

water the plant with the bucket

Every tickday runs 'growme' which does nothing as yet.

Reactions:
waters

Materials:
{none}

material called private

This material allows the object to restrict access via the go and goto commands.

Related:

read the command called setprivate

material called shapechanger

Creature Material


Shapechanger are creatures either without a 'normal' form, or changing form is a magor part of their life.

I.E. dopplegangers, hagunemnon (no normal form)

material called showspecials

Put this material on your weapon and you will be able to check out its damage and any special attacks it contains just by examining it. If there are enchantments, it will show the number of charges left.

material called sky

This material reacts to arrivals, adding or removing _light_ from the actor's material list.

Therefore, if you put an object with sky material in a dark room, it will light up the room from 6am to 6pm (adelaide time).

material called spellcasting

This material is set by the cast spell and remains until you are successful at casting the desired spell.

material called spookyforest

Put this material on something within a forest location to give it an occasional environmental sound. It should trigger once every 20 ticks or so if a player is present.

Some examples of random messages:

From to the south, a falling branch disturbs the quiet under the canopy.

From somewhere hidden, a howl spooks the silence of the trees.

From just out of sight, the cry of a young animal breaks the peace of the forest.

material called torch

The candle material reacts to the light and blow commands.

When lit, it will light the location, but shorten over time until health is gone.

If you create some candles, the singular class becomes 'candl'. This material detects and fixes it to 'candle' when lit.

If there are more than 1 candles (using the more command), then each time it burns out, qty will be reduced and health will go back to healthmax.

material called undead

Creature Material


Most people should be familiar with this one. Includes all the creatures that should be dead, but have been magically given ''life''.

I.E. ghouls, ghasts, ghosts, vampires, liches, zombies, morhgs, bodak, shades

material called vermin

Creature Material


Pests,insects, rats

material called zone

This works with roaming critters.

The setzone command places the zone material on an object while setting a zonename into the material's value.

If the object then calls roam, then it will only choose an exit if the room it links to is in the same zone.

see also:
read the command called setzone
read the command called roam

Scripting example:
//This causes an object to roam once every 10 or so ticks as long as it is alive;
##tickloc:runsub mayberoam;
##mayberoam:runsub roamaround/10;
##roamaround:
if $actor's health > 0 then roamaround2;
##roamaround2:
call ''roam'';