Races(Builder)

CoffeeMUD
Administrator                                                  Builder                                                              Player

=CoffeeMUD Builder Information=
Basics	Praetor     Player Support     Commands     Zapper Masks	Advanced	Races     Classes     Abilities     Socials     Scripting
Building	Behaviors     Properties     Areas     Rooms     Exits     Items     Mobs	Systems	Achievements     Crafting     Help Info     Ships     Planes of Existence     Quests     Triumphs

This page is intended for the discussion of HOW to build a race, not a listing of the races themselves (which should be available in the player RACES page).

Racial Fields

Meta Data

Race ID

This field is the codebase unique name for the race. It should not include spaces.

Name

This is the player-friendly name for the race and may include spaces and hyphens.

Racial Category

This is the racial grouping of the race.

• To create a new Racial Category; Edit a race from the command line, and change their racial category to: NEW NewRaceCatName.

Availability

This determines who can all become a member of that race. Fantasy/Heroic/Technical settings mean starting players in a mud with that type of setting may become that race. A "Skills Only" setting means that it is not available to a starting player of that type of setting, but may be accessed via specific skills (like polymorph).

Disabled Flags

This is a set of flags that can be applied to a race to prevent certain affects.

• CLASSLESS - Race cannot benefit from a class
• LEVELLESS - Race does not benefit from levels
• EXPLESS - Race cannot earn experience
• CHARMLESS - Race cannot be charmed
• CHILDLESS - Race cannot produce offspring
• INFATIGUEABLE - Race does not get sleepy

Never Create Corpse

This flag, when checked true, will result in no corpse for the given race. This is ideal for spirits and other non-corporeal creatures.

Rideable Player

This flag, when checked true, will allow other races to MOUNT this player. Weight restrictions may apply for mounting.

Physical Characteristics

Base Weight

This is the minimum weight of an adult member of the race.

Weight Variance

This is a number between 0 and the max value that will be added to the base weight to determine the MOB's actual weight.

Base Male Height

This is the base height of an adult male in your MUD's measurement system. We generally consider this to be inches, but it could just as easily be centimeters or geberdomins. It is generally measured from ground to highest point on the MOB, but it could be measured as a length for certain races, if desired.

Base Female Height

This is the base height of an adult female in your MUD's measurement system. We generally consider this to be inches, but it could just as easily be centimeters or geberdomins.

Height Variance

This is a number between 0 and the max value that will be added to the base height to determine the MOB's actual height.

Breathables

This is a list of material types that the race can breath, with AIR and WATER being the most common types of atmospheres breathable. Note: excluding air from the list will mean the creature will suffocate in normal rooms.

Body Parts

This field denotes the number and type of body parts available for amputation, body piercing, or making called strikes on.

• Antennea
• Eye - At least one is required for normal sight. Creatures with no eyes are considered blind. Each pair (2) of eyes provides 1 EYES wear location.
• Ear - At least one is required to hear. Creatures with no ears are considered deaf. Each pair (2) of ears provides 1 EARS wear location.
• Head - Each head provides one HEAD wear location.
• Neck - Each neck provides one NECK wear location.
• Arm - Each pair (2) of arms enables one ARMS wear location (shoulders/sleeves). Required for the WEAR command.
• Hand - Required for manipulating items, including GET and OPEN commands. Each Hand provides 1 WRIST location and 1 FINGER location (either RIGHT or LEFT). Each pair (2) of hands provides one HANDS wear location. The first hand provides a WIELD location, while all subsequent hands provide a HELD location.
• Torso - Each torso provides 1 TORSO wear location.
• Leg - Each pair (2) of legs provides one LEGS wear location.
• Foot - Each pair (2) of feet provides one FEET wear location.
• Nose - NOT required to use the SNIFF command.
• Gill - Basically a NOSE alternative. Does not confer water breathing automatically.
• Mouth - Required to eat, drink and talk. Each mouth provides one MOUTH wear location.
• Waist - Each waist provides one WAIST wear location.
• Tail
• Wing - Required for the Winged Flying ability.

Unwearable Locs

Not all body parts are tied to wear locations (Anetennea, tails, nose, gills and wings, for example). Not all wear locations are tied to a body part (BODY, FLOATING NEARBY, and BACK). Races may have further restrictions on which body parts may actually be equipped with items, which can further be overriden with Prop_WearOverride.

Resources

This is a listing of items generated when the race's body is butchered. In general, these items should be some sort of resource, like GenFoodResource, GenLiquidResource or GenResource, used for crafting. This may be a subset of body parts, meat/flesh, bones, blood, hair, organs or other components.

Stats and Abilities

XP Adjustment

This adjustment determines how much experience a player of that race will earn, and is applied to all forms of experience. A negative adjustment means the race earns less experience. Races that have a lot of innate bonuses (or potentially, long-lived races) should have a negative XP Adjustment. Providing a positive bonus on XP Adjustment is NOT advised, as players will run around polymorphed as that race as often as possible (although, if you want a particular race in your MUD to be dominant, providing a 10% XP bonus to that race will do it!).

Racial Abilities

These are a listing of abilities that every creature of that race may use. Racial abilities are qualified or gained at the designated level. Once gained, they remain at a static proficiency level defined by the race. Racial abilities should be the sort of ability that defines the race, like a fish that swims, a bird with winged-flying, or a monkey flinging poo.

Cultural Abilities

Cultural abilities are abilities that are qualified or gained at defined levels by mobs that are that race at the time of gaining that level. These abilities are generally social skills that are handed down from one generation to the next, such as languages or a particular gathering skill. Cultural abilities start at a designated proficiency, but may increase with practice or use.

Ambiance

Leave Text

This is the text shown to other viewers when the race leaves a room in the form of:

• MOBNAME -leave text- DIRECTION.

Arrive Text

This is the text shown to other viewers when the race leaves a room in the form of:

• MOBNAME -arrive text- from the DIRECTION.

Health Race

The name of a standard race which will be used as a source of health descriptions during combat. In short, enter here the name of a race that looks the most like the one you are creating. If you are creating a generic race on top of an existing standard one, you will need to use the fully qualified class name of the form: com.planet_ink.coffee_mud.Races.<racename> in order to access the standard version.

Event Race

The name of a standard race which will be used as a source of special race-specific java-coded events, such as the way Chickens lay eggs. Leaving this blank is the usual correct answer. If you are creating a generic race on top of an existing standard one, you will need to use the fully qualified class name of the form: com.planet_ink.coffee_mud.Races.<racename>in order to access the standard version

Outfit

This listing of items that will be generated when a player uses the OUTFIT command. It is a good idea to make sure the items are size 0 when you save it to a race, to make sure it will adjust to the player regardless of their height. It is also recommended that these items be essentially worthless and cosmetic in nature. The MOB's Class may provide more items, which should be a class-appropriate weapon and/or item required by the class.

Weapons Race

The name of a standard race which will be used as a source of random racial unarmed weapons. Enter here the name of a race that looks the most like the one you are creating. If you are create a generic race on top of an existing standard one, you will need to use the fully qualified class name of the form: com.planet_ink.coffee_mud.Races.<racename> in order to access the standard version.

• This field will overwrite any Natural Weapons listed in the above field. Set to NONE to use a customized natural weapon.

Notes

• Dont give races a shapeshift-type ability as a RACIAL ability. Once they shapeshift to a new race, they will lose the ability to shapeshift.
• Crossbred races will receive the 4 four abilities from its two parent races.
• Setting a racial/cultural ability to level 0 will make the cost to use that ability not decrease as the race levels (to be verified).