ItemGenerator

From CoffeeMud Wiki
Jump to: navigation, search
CoffeeMUD
Administrator                                                  Builder                                                              Player
=CoffeeMUD Builder Information=
Praetor     Player Support     Scripting     Races     Commands    Classes     Abilities     Socials     Achievements     Behaviors     Properties     Areas     Rooms     Exits     Items     Mobs     Crafting     Ships     Quests     Zapper Masks
===ItemGenerator===
Targets: Areas, Rooms, Containers, Mobs
Parameters: "min/max ticks" "% chance" "min/max items/dups" "enchanted=%""mobs" "locale mask"; "mask"
Examples: min=10 max=20 chance=75 minitems=1 maxitems=10 maxdups=0;-LEVELS +>10

minitems=10 maxitems=20 MOBS -ALL +CITY;-MATERIAL +IRON +BRONZE

minitems=10 maxitems=20 enchanted=20;-NAME "+Short Sword"

Description: This behavior will generate a list of items from the standard common skills. It will also add random enchantments and curses to items a percentage of the time dictated by the echanted parameter (default=10). Items are selected from the list on a pseudo-random basis, with the chance weighted in favor of the least valuable items in favor of the most valuable. This is to decrease the chances of a plethora of Spidersteel swords.

The parameters before the semicolon describe the rate and amount of items generated. The room or area will attempt to generate an item every (min) to (max) ticks, assuming the percent chance (chance) is made. It will then generate at least the minimum (minitems) number of items from the list, but never more than the maximum (maxitems) number of monsters. Duplicates are allowed unless (maxdups) is set to some value. Items taken away will be replaced by this behavior, even if they are looted. If the behavior is on a room, all items will be generated in that room. If on an area, a random room in the area will be picked for the item. The TYPE of room in that area which will be selected for population may also be specified. -ALL to disallow all locales, followed by +AIR +CITY +JUNGLE (etc) to reallow certain locales. -CITY -UNDERWATER and others may be used to restrict certain locales. If no locale types are specified, then all rooms in an area will be populatable. Valid locates include: "STONE", "WOODEN", "CAVE", "MAGIC", "UNDERWATER", "AIR", "WATERSURFACE", "METAL", "CITY", "WOODS", "ROCKY", "PLAINS", "UNDERWATER", "AIR", "WATERSURFACE", "JUNGLE", "SWAMP", "DESERT", "HILLS", "MOUNTAINS". If the behavior is on a mob, or the MOBS flag is given in the parameters, then the item will be placed on a mob IF POSSIBLE (if the behavior is on an area, and a room with no mobs is randomly selected, it may not happen). Items places on mobs will be automatically worn if possible.

The parameters after the semicolon are a mask to help select what kind of items are generated for the several rooms or whatever. The mask uses the following flags:

+SYSOP (allow archons to bypass the rules), -SYSOP (disallow archons)

+SUBOP (allow local area staff to bypass the rules), -SUBOP (disallow)

-PLAYER (disallow all players), -MOB (disallow all mobs/npcs)

-CHANCE 50 (disallow the given % of the time)

-JAVACLASS "+GENMOB" etc.. (disallow only objects of +java class)

+JAVACLASS "-GENITEM" etc.. (Do not disallow objs of -classes)

-CLASS +thief +mage +ranger (disallow all but excepted char classes)

+CLASS -thief -mage -ranger (disallow only listed classes)

-BASECLASS +thief +mage (disallow all but excepted base char classes)

+BASECLASS -thief -mage -ranger (disallow only listed base char classes)

-RACE +elf +dwarf (disallow all but excepted races)

+RACE -elf -dwarf -human -half -gnome (disallow only listed races)

-RACECAT +elf +insect +humanoid (disallow all but listed racial categories)

+RACECAT -elf -humanoid (disallow only listed racial categories)

-ALIGNMENT +evil +neutral +good (disallow all but excepted alignments)

+ALIGNMENT -evil -good -neutral (disallow only listed alignments)

-GENDER (disallow genders), -GENDER +male +neuter (create exceptions)

+GENDER -male -female -neuter (disallow only listed genders)

-FACTION (disallow all faction and values, even a lack of faction)

-FACTION +myfactionrange +faction.rangecode (create exceptions)

+FACTION -rangecode -faction.rangecode (disallow only faction range code)

-NAMES +bob "+my name" (disallow all except those with given names)

+NAMES -bob "-my name" (disallow only those with one of the given names)

-SUBNAMES +*ending +*inside* (disallow all except those with partial name)

+SUBNAMES -*ending -*insid* (disallow only those with partial name mask)

-TATTOOS +mytatto +thistattoo (disallow all but those with excepted tatts)

+TATTOOS -mytatt -anytattoo, (disallow only those with a listed tattoo)

-EXPERTISES +myedu +thisedu (disallow all but those with listed expertise)

+EXPERTISES -myedu -anyedu (disallow those with a listed expertise)

-LEVEL +=1 +)5 +)=7 +(13 +(=20 (disallow all but those player level ranges)

-=1 -)5 -)=7 -(13 -(=20 (disallow only listed levels range)

-CLASSLEVEL +=1 +)5 +(=20 (disallow all except those with current class lvl)

-MAXCLASSLEVEL +=1 +(13 (disallow only those with current class level range)

+ANYCLASS -thief -mage (disallow only those with a listed multi-class)

-ANYCLASSLEVEL +thief +)5 +mage +(10 (disallow all except multi-class lvl)

+ANYCLASSLEVEL -thief -)5 -mage -(10 (disallow only these multi-class lvls)

-SECURITY +cmdrooms +area cmditems (disallow all but listed security flags)

+SECURITY -cmdrooms +area cmditems,(disallow only those with listed flags)

-MOOD +grumpy +normal (disallow all except those with given moods)

+MOOD -grumpy -normal (disallow only those with subtracted moods)

-CLAN +Killers "+The Avengers" (disallow all except those in listed clan)

+CLAN -Killers "-Avengers" (disallow only those in a listed clan)

-DEITY +Apollo "+Grothon" (disallow all except worshippers of listed deity)

+DEITY -God "-Rothon 1" (disallow only worshippers of a listed deity)

-ANYCLASS +thief +ranger (disallow all except those with a multi-class)

-STR X (disallow those with strength greater than X)

+STR X (disallow those with strength less than X)

-INT, -WIS, -CON, -CHA, -DEX (Same as -STR, for other current stats)

+INT, +WIS, +CON, +CHA, +DEX (Same as +STR, for other current stats)

+-ADJSTR...ADJCON (Same as above, but uses current values)

-GROUPSIZE X (disallow those in groups larger than X)

+GROUPSIZE X (disallow those in groups smaller than X)

-AREA +thatarea "+my areaname" (disallow all except those in listed area)

+AREA -thatarea "-my areaname" (disallow only those in listed area)

-HOME "+area name" (disallow all except those from listed home/beacon area)

+HOME "-my areaname" (disallow only those from listed home/beacon area)

-ISHOME (disallow all npcs not currently in their home/beacon areas)

+ISHOME (disallow all npcs unless they are in their home/beacon areas)

-ITEM "+item name" etc... (disallow only those with an item name)

-WORN "+item name" etc... (disallow only those wearing item name)

-MATERIAL "+WOODEN" etc.. (disallow only items of added materials)

+MATERIAL "-WOODEN" etc.. (Do not disallow items of -materials)

-RESOURCES "+OAK" etc.. (disallow only items of added resources)

+RESOURCES "-OAK" etc.. (Do not disallow items of -resources)

-IF (CONDITION) (disallow, unless they meet Scriptable conditions)

+IF (CONDITION) (never disallow anyone who meets Scriptable cond)

-IFSTAT +STAT=VALUE +STAT=VALUE (disallow, unless a stat value is true)

+IF -STAT=VALUE -STAT=VALUE (disallow those with a stat value)

-VALUE X (disallow those with value or money less than X)

+VALUE X (disallow those with value or money greater than X)

-WEIGHT X (disallow those weighing less than X)

+WEIGHT X (disallow those weighing more than X)

-ARMOR/-DAMAGE/-ATTACK X (disallow armor/damage/attack bonus less than X)

+ARMOR/+DAMAGE/+ATTACK X (disallow armor/damage/attack bonus more than X)

+-WEAPONTYPE, +-WEAPONCLASS, and +-WEAPONAMMO for wielded weaponchecks

-WORNON "+TORSO" etc.. (disallow only items wearable on +locations)

+WORNON "-NECK" etc.. (Do not disallow items wearable on -locations)

-DISPOSITION "+ISHIDDEN" etc.. (disallow only with +dispositions)

+DISPOSITION "-ISHIDDEN" etc.. (Do not disallow only with sub disp)

-SENSES "+CANSEEDARK" etc.. (disallow only those with +senses)

+SENSES "-CANSEEDARK" etc.. (Do not disallow those with -senses)

-ABILITY X (disallow those with magical ability less than X)

+ABILITY X (disallow those with magical ability greater than X)

-HOUR/-MONTH/-DAY +X (disallow always, unless the hour/month/day is X)

+HOUR/+MONTH/+DAY -X (disallow those only when the hour/month/day is X)

-SEASON +FALL (disallow those only when season is FALL)

+SEASON -SPRING (disallow those whenever the season is SPRING)

-WEATHER +DROUGHT (disallow those only when weather is DROUGHT)

+WEATHER -BLIZZARD (disallow those whenever the weather is BLIZZARD)

-QUESTWIN "+MY QUEST" (disallow those who have not my MY QUEST)

+QUESTWIN "-MY QUEST" (disallow those who have won MY QUEST)

-EFFECTS +Sleep "+Wood Chopping" (disallow all except those with effects)

+EFFECTS -Sleep "-Wood Chopping" (disallow only those with listed effect)

-SKILLS +Spell_Sleep(75) (disallow all except those with skill proficiency)

+SKILLS -Spell_Sleep(75) (disallow only those with skill proficiency)

-SKILLFLAG +ENCHANTMENT etc.. (disallow all except those with skillflag)

+SKILLFLAG -ENCHANTMENT etc.. (disallow only those with listed skillflag)

-ACCCHIEVES +mytatto etc.. (disallow all except those with achievements)

+ACCCHIEVES -mytattoo etc.. (disallow only those with listed achievements)

Notes

.