GenAbility - Revision history

Loki: /* Type, Domain */

2021-04-13T16:44:57Z

Type, Domain

← Older revision		Revision as of 16:44, 13 April 2021
Line 26:		Line 26:
	*The domain name should not have any spaces. Typically, an underscore is used between domains with multiple words, like nature_lore.		*The domain name should not have any spaces. Typically, an underscore is used between domains with multiple words, like nature_lore.
	*Do not attempt to create new domains with this field. It does not work.		*Do not attempt to create new domains with this field. It does not work.

			Most Ability Types generate some sort of non-priority moving-type message, except Proprety and Language. This means that the MOB must be able to move in some fashion in order to use these abilities.

	==Command Words==		==Command Words==

Loki: /* Post-Cast Message */

2020-04-03T01:06:15Z

Post-Cast Message

← Older revision		Revision as of 01:06, 3 April 2020
Line 112:		Line 112:
	==Post-Cast Message==		==Post-Cast Message==
	The message shown after the skill is invoked, if the target did not make a saving throw against it. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Post-Cast Message.		The message shown after the skill is invoked, if the target did not make a saving throw against it. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Post-Cast Message.

			; Post Cast Message Examples : <T-NAME> clutch(es) at <T-HIS-HER chest, a look of horror comes over <T-HIS-HER> face.

	==Uninvoke Message==		==Uninvoke Message==

Loki: /* Normal-Cast Message */

2020-04-03T00:34:59Z

Normal-Cast Message

← Older revision		Revision as of 00:34, 3 April 2020
Line 107:		Line 107:
	==Normal-Cast Message==		==Normal-Cast Message==
	The message shown when the skill successfully invoked. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Normal-Cast Message.		The message shown when the skill successfully invoked. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Normal-Cast Message.

			; Normal Cast Message Examples : <S-NAME> ball(s) <S-HIS-HER> hand in to a tight fist and drive(s) it towards <T-NAME> with tremendous speed, delivering a crushing blow to <T-HIS-HER> chest.

	==Post-Cast Message==		==Post-Cast Message==

Loki: /* Fizzle Message */

2020-04-03T00:34:00Z

Fizzle Message

← Older revision		Revision as of 00:34, 3 April 2020
Line 99:		Line 99:
	==Fizzle Message==		==Fizzle Message==
	The message shown when the mob or player fails their proficiency check for this skill. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Fizzle Message.		The message shown when the mob or player fails their proficiency check for this skill. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Fizzle Message.

			; Fizzle Message Examples : <S-NAME> ball(s) <S-HIS-HER> hand in to a tight fist and drive(s) it towards <T-NAME> with tremendous speed, but fails to connect to <T-NAME>.

	==Auto-Cast Message==		==Auto-Cast Message==

Loki: /* Scriptable Parm */

2020-04-03T00:16:35Z

Scriptable Parm

← Older revision		Revision as of 00:16, 3 April 2020
Line 92:		Line 92:
	A Scriptable-behavior parameter denoting the script that is active during invocation of this skill and during its tenure as an affect. See the Scriptable Guide for detailed information on how to use mobprog scripts. Enter ? for some short help on acceptable parameters here. *special note: during successful invocation of this ability, a special trigger event will occur that can be handled by an IMASK_PROG p <ability id>. Such a script trigger would, for example, be the appropriate place to put damage commands for skills that do damage. Periodic actions can be placed in RAND_PROG triggers.		A Scriptable-behavior parameter denoting the script that is active during invocation of this skill and during its tenure as an affect. See the Scriptable Guide for detailed information on how to use mobprog scripts. Enter ? for some short help on acceptable parameters here. *special note: during successful invocation of this ability, a special trigger event will occur that can be handled by an IMASK_PROG p <ability id>. Such a script trigger would, for example, be the appropriate place to put damage commands for skills that do damage. Periodic actions can be placed in RAND_PROG triggers.

	~~===~~Examples~~===~~		; Scriptable Examples : IMASK_PROG P heartpunch;MPECHOAT $t Your heart has stopped, you haven't long to live!;~;DELAY_PROG 14 14;MPECHOAROUND $t $t grab(s) at $M chest before collapsing to the ground.;MPECHOAT $t You grab at your chest before collapsing to the ground.;MPDAMAGE $i 999999999 999999999 kill;~;

	*: IMASK_PROG P heartpunch;MPECHOAT $t Your heart has stopped, you haven't long to live!;~;DELAY_PROG 14 14;MPECHOAROUND $t $t grab(s) at $M chest before collapsing to the ground.;MPECHOAT $t You grab at your chest before collapsing to the ground.;MPDAMAGE $i 999999999 999999999 kill;~;

	==Target Mask==		==Target Mask==

Loki: /* Scriptable Parm */

2020-04-03T00:15:06Z

Scriptable Parm

← Older revision		Revision as of 00:15, 3 April 2020
Line 91:		Line 91:
	==Scriptable Parm==		==Scriptable Parm==
	A Scriptable-behavior parameter denoting the script that is active during invocation of this skill and during its tenure as an affect. See the Scriptable Guide for detailed information on how to use mobprog scripts. Enter ? for some short help on acceptable parameters here. *special note: during successful invocation of this ability, a special trigger event will occur that can be handled by an IMASK_PROG p <ability id>. Such a script trigger would, for example, be the appropriate place to put damage commands for skills that do damage. Periodic actions can be placed in RAND_PROG triggers.		A Scriptable-behavior parameter denoting the script that is active during invocation of this skill and during its tenure as an affect. See the Scriptable Guide for detailed information on how to use mobprog scripts. Enter ? for some short help on acceptable parameters here. *special note: during successful invocation of this ability, a special trigger event will occur that can be handled by an IMASK_PROG p <ability id>. Such a script trigger would, for example, be the appropriate place to put damage commands for skills that do damage. Periodic actions can be placed in RAND_PROG triggers.

			===Examples===

			*: IMASK_PROG P heartpunch;MPECHOAT $t Your heart has stopped, you haven't long to live!;~;DELAY_PROG 14 14;MPECHOAROUND $t $t grab(s) at $M chest before collapsing to the ground.;MPECHOAT $t You grab at your chest before collapsing to the ground.;MPDAMAGE $i 999999999 999999999 kill;~;

	==Target Mask==		==Target Mask==

Loki at 01:39, 5 January 2020

2020-01-05T01:39:47Z

@@ Line 133: / Line 133: @@
 ; MUDGrinder Example : <ABILITY>Usage    : RAKE [TARGET NAME]<br />Example   : rake orc<br />:        : rake bob<br />Using his powerful hind-claws, a wolf may rake flesh from his opponent.<br />
 =Notes=
+.

Loki at 01:05, 5 January 2020

2020-01-05T01:05:45Z

← Older revision		Revision as of 01:05, 5 January 2020
Line 72:		Line 72:

	==Can Affect==		==Can Affect==
			This field determines what types of targets are eligible for affect by the ability. Options include: Rooms, Mobs, Items, Exits, Areas. Multiple target types can be selected via a comma-delimited list. This list should be a subset of the [[#Can Target]] field.

			==Can Target==
			This field determines what types of targets are eligible for using the ability on. Options include: Rooms, Mobs, Items, Exits, Areas. Multiple target types can be selected via a comma-delimited list.

	==Tick/Periodic Affects==		==Tick/Periodic Affects==
	~~==Can Target==~~		The standard damage/healing and Extra Castings will apply at skill invocation time. However, if your skill is set to affect the target over time, AND this is set to true, then those things will happen every tick until the effect expires.

	==Quality Code==		==Quality Code==
			Whether this skill is malicious (hurts the target), beneficial to self or others (always gives a combat benefit), ok to self or others (sometimes gives a combat benefit under certain circumstances), or indifferent (usually for role-playing skills).

	==Affect Adjustments==		==Affect Adjustments==
			For skills that affect their targets (see Can Affect), this is the list of affects and their values. It is modeled on the same syntax and format of the property [[Prop_HereAdjuster]].

	==Caster Mask==		==Caster Mask==
			A [[ZapperMasks\|zappermask]] to determine if the invoker is allowed, under the circumstances, to use this skill.

	==Scriptable Parm==		==Scriptable Parm==
			A Scriptable-behavior parameter denoting the script that is active during invocation of this skill and during its tenure as an affect. See the Scriptable Guide for detailed information on how to use mobprog scripts. Enter ? for some short help on acceptable parameters here. *special note: during successful invocation of this ability, a special trigger event will occur that can be handled by an IMASK_PROG p <ability id>. Such a script trigger would, for example, be the appropriate place to put damage commands for skills that do damage. Periodic actions can be placed in RAND_PROG triggers.

	==Target Mask==		==Target Mask==
			A [[ZapperMasks\|zappermask]] to determine if the target is allowed, under the circumstances, to be targeted by this skill.

	==Fizzle Message==		==Fizzle Message==
			The message shown when the mob or player fails their proficiency check for this skill. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Fizzle Message.

	==Auto-Cast Message==		==Auto-Cast Message==
			The message shown when the skill is invoked from a wand, scroll or other automatic means. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Auto-Cast Message.

	==Normal-Cast Message==		==Normal-Cast Message==
			The message shown when the skill successfully invoked. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Normal-Cast Message.

	==Post-Cast Message==		==Post-Cast Message==
			The message shown after the skill is invoked, if the target did not make a saving throw against it. Use <S-NAME> as a substitute for the invoker, and <T-NAME> as a substitute for the name of the target. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Post-Cast Message.

	==Uninvoke Message==		==Uninvoke Message==
			The message shown after this skill is uninvoked. If the target is a mob, or an item held by a mob, then the message will be seen only by the mob. If the target is an item in a room, then the whole room will see the message. Use [[ScriptableTags\|Scriptable Tags]] to control grammatical correctness of your Uninvoke Message.

	==Attack-Type==		==Attack-Type==
	An optional field for malicious skills. This is the [[Secondary Attack Type]] of the attack being made, where the [[Primary Attack Type]] is determined by the skill type (magic for spells, chants, prayers, etc). For instance, for a flame-shooting spell, FIRE would be an appropriate value.		An optional field for malicious skills. This is the [[Secondary Attack Type]] of the attack being made, where the [[Primary Attack Type]] is determined by the skill type (magic for spells, chants, prayers, etc). For instance, for a flame-shooting spell, FIRE would be an appropriate value.

Loki at 20:40, 4 January 2020

2020-01-04T20:40:15Z

← Older revision		Revision as of 20:40, 4 January 2020
Line 58:		Line 58:

	==Skill Flags==		==Skill Flags==
	0 or more comma-delimited flags that describe the affects of your skill to the rest of the mud engine.		0 or more comma-delimited [[:Category:ABILITYFLAGS\|ability flags]] that describe the affects of your skill to the rest of the mud engine.

	==Override Cost==		==Override Cost==
Line 85:		Line 85:
	==Uninvoke Message==		==Uninvoke Message==
	==Attack-Type==		==Attack-Type==
			An optional field for malicious skills. This is the [[Secondary Attack Type]] of the attack being made, where the [[Primary Attack Type]] is determined by the skill type (magic for spells, chants, prayers, etc). For instance, for a flame-shooting spell, FIRE would be an appropriate value.

	==Quiet Effect ID==		==Quiet Effect ID==
	This field can be used to provide the entire affect of an existing ability to this new ability, with all of the costs, messages, domains, etc determined by this ability instead of the Quiet Effect ID. In this fashion, you can rebrand an existing ability's affect. None of the messages from the Quiet Effect ID will be applied, including the ~~AFFECT message~~.		This field can be used to provide the entire affect of an existing ability to this new ability, with all of the costs, messages, domains, etc determined by this ability instead of the Quiet Effect ID. In this fashion, you can rebrand an existing ability's affect. None of the messages from the Quiet Effect ID will be applied, including the [[#Affect String]] of the Quiet Effect ID (but this ability's affect string will apply).

	==Public Effects==		==Public Effects==
	This field allows you to add a semi-colon delimited list of ability affects to the new ability. All messages and affects will be displayed as if the Public Effects were each cast independently from the new ability.		This field allows you to add a semi-colon delimited list of ability affects to the new ability. All messages and affects will be displayed as if the Public Effects were each cast independently from the new ability.

	==Extra Castings==		==Extra Castings==
			An optional semicolon delimited list of miscellanous skills or spells which will be invoked upon the target of this skill after all of the other above things have occurred. Enter ? or help on Prop_SpellAdder for more information on the syntax for this field.

	==Damage/Healing Formula==		==Damage/Healing Formula==
			An optional formula describing either a range of damage or a range of healing which will be inflicted upon the target of this skill at invocation time. The syntax of this field is a formula. Use +-*/()?. @x1=caster level, @x2=target level. Formula evaluates >0 for damage, <0 for healing. Requires Can Target above! See help on [[MATH_FORMULA]] for more information on how to use this formula field.

	==Help Text==		==Help Text==
	This field provides additional information from the HELP (ability_name) command to players. It should always start with the tag <ABILITY> and does not require a closing tag.		This field provides additional information from the HELP (ability_name) command to players. It should always start with the tag <ABILITY> and does not require a closing tag.

Loki at 15:05, 2 January 2020

2020-01-02T15:05:54Z

← Older revision		Revision as of 15:05, 2 January 2020
Line 2:		Line 2:
	{{CoffeeMUDMUDGrinderTOC}}		{{CoffeeMUDMUDGrinderTOC}}

	GenAbilities are abilities that are created virtually within CoffeeMUD.		GenAbilities are abilities that are created virtually within CoffeeMUD. Before creating GenAbilities, you should be familiar with the [[http://coffeemud.net:27777/pub/guides/GameBuildersGuide.html\|Game Builder's Guide]] and the [[http://coffeemud.net:27777/pub/guides/ArchonGuide.html\|Archon's Guide]].

	=Creating GenAbilities=		=Creating GenAbilities=
Line 50:		Line 50:
	==Duration Override==		==Duration Override==
	This field will override an ability's duration. Normally, abilities will last for a [[Ability(StandardDuration\|Standard Duration]].		This field will override an ability's duration. Normally, abilities will last for a [[Ability(StandardDuration\|Standard Duration]].

	==Affect String==		==Affect String==
	This is the display players will see when using the AFFECTS or SCORE command for abilities that persist. Generally, the affect string should be enclosed in parentheses. This may be left blank if you do not desire a player to be able to detect the affect. Obvious affects (like paralysis, losing a limb, or having a horrid stench) should have an affect string. If the [[#Can Affect]] is not set properly, this field will not be used.		This is the display players will see when using the AFFECTS or SCORE command for abilities that persist. Generally, the affect string should be enclosed in parentheses. This may be left blank if you do not desire a player to be able to detect the affect. Obvious affects (like paralysis, losing a limb, or having a horrid stench) should have an affect string. If the [[#Can Affect]] is not set properly, this field will not be used.

	==Is Auto-invoking==		==Is Auto-invoking==
			Whether this skill is automatically applied to a player as an affect when they learn the skill. If true, the ability will show no casting message, and proceed directly to affecthood.

	==Skill Flags==		==Skill Flags==
			0 or more comma-delimited flags that describe the affects of your skill to the rest of the mud engine.

	==Override Cost==		==Override Cost==
			Designate the cost of using this skill in mana/movement/etc.
			*A value of -1 means to use the default system as defined in your coffeemud.ini file.
			*A value of 0 means its free.
			*A value from 0-99999 means to always use that amount.
			*A value of 2147483647 means to always use all of the mobs mana/move points.
			*A value of 2147483647-100 to 2147483647 means to use that percentage of the mobs mana/move points.

	==Cost Type==		==Cost Type==
			This field allows you to determine what resource(s) are used to activate the ability for the assigned cost from the previous field. Mana is the default, but Movement, Hit Points or any combination of the three may be selected.

	==Can Affect==		==Can Affect==
	==Tick/Periodic Affects==		==Tick/Periodic Affects==
Line 71:		Line 86:
	==Attack-Type==		==Attack-Type==
	==Quiet Effect ID==		==Quiet Effect ID==
			This field can be used to provide the entire affect of an existing ability to this new ability, with all of the costs, messages, domains, etc determined by this ability instead of the Quiet Effect ID. In this fashion, you can rebrand an existing ability's affect. None of the messages from the Quiet Effect ID will be applied, including the AFFECT message.
	==Public Effects==		==Public Effects==
			This field allows you to add a semi-colon delimited list of ability affects to the new ability. All messages and affects will be displayed as if the Public Effects were each cast independently from the new ability.
	==Extra Castings==		==Extra Castings==
	==Damage/Healing Formula==		==Damage/Healing Formula==