SKILL - Revision history

Wuffel: /* Properties */

2014-03-26T01:18:35Z

‎Properties

RanXerox: /* Triggers */

2011-09-13T00:28:08Z

‎Triggers

RanXerox: /* Triggers */ Added missing @wait trigger from revision date 20-12-2009

2011-09-13T00:27:51Z

‎Triggers: Added missing @wait trigger from revision date 20-12-2009

Sirius: Added languagemenue

2010-11-26T20:33:58Z

Added languagemenue

RanXerox: /* Properties */ Added flags from a relatively recent build

2010-10-23T17:10:10Z

‎Properties: Added flags from a relatively recent build

RanXerox: /* Properties */ clarification of GAINRADIUS (from revision notes.)

2010-10-23T17:01:32Z

‎Properties: clarification of GAINRADIUS (from revision notes.)

MrSugarCube at 18:51, 9 June 2009

2009-06-09T18:51:59Z

MrSugarCube at 18:36, 9 June 2009

2009-06-09T18:36:35Z

MrSugarCube at 23:08, 8 June 2009

2009-06-08T23:08:29Z

MrSugarCube: Created page with 'A skill block defines the basic properties and behaviours of a skill. ==Properties== The following properties are available when defining a skill: {| border="1" cellspacing="4...'

2009-06-08T23:07:34Z

Created page with 'A skill block defines the basic properties and behaviours of a skill. ==Properties== The following properties are available when defining a skill: {| border="1" cellspacing="4...'

New page

A skill block defines the basic properties and behaviours of a skill.

==Properties==
The following properties are available when defining a skill:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Read/Write''' || '''Description'''
|-
| [[ADV_RATE]] || RW || Gets or sets the skill's advance rate. Accepts multiple values to adjust based on skill level.
|-
| [[BONUS_DEX]] || RW || Gets or sets a multiplier for how much dexterity affects a character's non-real skill amount, and affects stat gain.
|-
| [[BONUS_INT]] || RW || Gets or sets a multiplier for how much intelligence affects a character's non-real skill amount, and affects stat gain.
|-
| [[BONUS_STATS]] || RW || Gets or sets a modifier for gaining stats when using the skill.
|-
| [[BONUS_STR]] || RW || Gets or sets a multiplier for how much strength affects a character's non-real skill amount, and affects stat gain.
|-
| [[DELAY]] || RW || Gets or sets how long it takes to attempt to complete the skill, in tenths of a second. Accepts multiple values to adjust based on skill level.
|-
| [[EFFECT]] || RW || Gets or sets a value which effects skills in different ways. (Crafting = Resource Loss % on Fail, Healing = Amount Healed). Accepts multiple values to adjust based on skill level.
|-
| [[FLAGS]] || RW || Gets or sets skill attributes.
|-
| [[GAINRADIUS]] || RW || Gets or sets a difficulty radius to prevent characters from gaining from easy actions.
|-
| [[GROUP]] || RW || Get or sets the name of the group that the skill belongs to.
|-
| [[KEY]] || RW || Gets or sets the skill's defname.
|-
| [[NAME]] || RW || Gets or sets the name of the skill.
|-
| [[STAT_DEX]] || RW || Gets or sets the maximum dexterity a character can gain up to when using this skill.
|-
| [[STAT_INT]] || RW || Gets or sets the maximum intelligence a character can gain up to when using this skill.
|-
| [[STAT_STR]] || RW || Gets or sets the maximum strength a character can gain up to when using this skill.
|-
| [[TARGET_PROMPT]] || RW || Gets or sets the message shown when the character selects the skill, and also forces characters to select a target when non-empty.
|-
| [[TITLE]] || RW || Gets or sets the professional title for the skill.
|-
| [[VALUES]] || RW || Gets or sets a modifier for the value of items that are created using the skill. Accepts multiple values to adjust based on skill level.
|}

==Triggers==
The following table lists all of the triggers that can be placed under a skill definition. All of the triggers here have an equivalent @Skill trigger on the [[Characters|character]] object.

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[@Abort]] || Fires when a character aborts an attempt at using the skill.
|-
| [[@Fail]] || Fires when a character fails an attempt at using the skill.
|-
| [[@Gain]] || Fires when a character is given the chance to gain in the skill.
|-
| [[@PreStart]] || Fires when a character starts to use the skill, before any hardcoded behaviour takes place.
|-
| [[@Select]] || Fires when a character selects the skill from their skill menu.
|-
| [[@Start]] || Fires when a character starts to use the skill.
|-
| [[@Success]] || Fires when a character succeeds an attempt at using the skill.
|-
| [[@UseQuick]] || Fires when a character quickly uses the skill, without changing their [[ACTION]].
|}

==Examples==

<spherescript>
//
// Alchemy skill from the default script pack.
//
[SKILL 0]
DEFNAME=SKILL_ALCHEMY
KEY=Alchemy
TITLE=Alchemist
DELAY=3.0,1.0
ADV_RATE=10.0,200.0,800.0
VALUES=1,20,100

BONUS_STATS=10
BONUS_STR=0
BONUS_DEX=20
BONUS_INT=80

STAT_STR=5
STAT_INT=75
STAT_DEX=40

ON=@Fail
SRC.SYSMESSAGE You toss the failed mixture from the mortar, unable to create a potion from it.

ON=@Abort
SRC.SYSMESSAGE You fail to complete the potion.
</spherescript>

@@ Line 91: / Line 91: @@
 | [[@UseQuick]] || Fires when a character quickly uses the skill, without changing their [[ACTION]].
 |-
-| [[@wait]] || This is called whenever Sphere wants to check if a character must wait before starting a skill. Normally this will be when a skill is selected from the skill menu (before [[@Select]]), but also when snooping a container or using a musical instrument.
+| [[@Wait]] || This is called whenever Sphere wants to check if a character must wait before starting a skill. Normally this will be when a skill is selected from the skill menu (before [[@Select]]), but also when snooping a container or using a musical instrument.
 |}

← Older revision		Revision as of 20:33, 26 November 2010
Line 1:		Line 1:
		+	{{Languages\|SKILL}}
		+
	__FORCETOC__		__FORCETOC__
	A skill block defines the basic properties and behaviours of a skill.		A skill block defines the basic properties and behaviours of a skill.

← Older revision		Revision as of 18:36, 9 June 2009
Line 1:		Line 1:
		+	__FORCETOC__
	A skill block defines the basic properties and behaviours of a skill.		A skill block defines the basic properties and behaviours of a skill.

← Older revision		Revision as of 23:08, 8 June 2009
Line 100:		Line 100:
	SRC.SYSMESSAGE You fail to complete the potion.		SRC.SYSMESSAGE You fail to complete the potion.
	</spherescript>		</spherescript>
		+
		+	[[Category: Reference Compendium]]
		+	[[Category: Definitions]]

@@ Line 62: / Line 62: @@
 | [[STAT_STR]] || RW || Gets or sets the maximum strength a character can gain up to when using this skill.
 |-
-| [[TARGET_PROMPT]] || RW || Gets or sets the message shown when the character selects the skill, and also forces characters to select a target when non-empty.
+| [[PROMPT_MSG]] || RW || Gets or sets the message shown when the character selects the skill, and also forces characters to select a target when non-empty.
 |-
 | [[TITLE]] || RW || Gets or sets the professional title for the skill.

@@ Line 90: / Line 90: @@
 |-
 | [[@UseQuick]] || Fires when a character quickly uses the skill, without changing their [[ACTION]].
 |}
 ==Examples==

@@ Line 23: / Line 23: @@
 | [[EFFECT]] || RW || Gets or sets a value which effects skills in different ways. (Crafting = Resource Loss % on Fail, Healing = Amount Healed). Accepts multiple values to adjust based on skill level.
 |-
-| [[FLAGS]] || RW || Gets or sets skill attributes.
+| [[FLAGS]] || RW || Gets or sets skill attributes.  The available flags are defined in the sphere_defs.scp file:
 |-
 | [[GAINRADIUS]] || RW || Gets or sets a difficulty "radius" that prevents characters from gaining skill when performing "easy" actions.  Skillgain will only be calculated if the current skill is less than the actual difficulty + GAINRADIUS.  If skillgain is aborted due to GAINRADIUS not met, a message will only be displayed if TAG.NOSKILLMSG=1 on character.

@@ Line 25: / Line 25: @@
 | [[FLAGS]] || RW || Gets or sets skill attributes.
 |-
-| [[GAINRADIUS]] || RW || Gets or sets a difficulty radius to prevent characters from gaining from easy actions.
+| [[GAINRADIUS]] || RW || Gets or sets a difficulty "radius" that prevents characters from gaining skill when performing "easy" actions.  Skillgain will only be calculated if the current skill is less than the actual difficulty + GAINRADIUS.  If skillgain is aborted due to GAINRADIUS not met, a message will only be displayed if TAG.NOSKILLMSG=1 on character.
 |-
 | [[GROUP]] || RW || Get or sets the skill's group flags.
@@ Line 45: / Line 45: @@
 | [[VALUES]] || RW || Gets or sets a modifier for the value of items that are created using the skill. Accepts multiple values to adjust based on skill level.
 |}
 ==Triggers==

@@ Line 27: / Line 27: @@
 | [[GAINRADIUS]] || RW || Gets or sets a difficulty radius to prevent characters from gaining from easy actions.
 |-
-| [[GROUP]] || RW || Get or sets the name of the group that the skill belongs to.
+| [[GROUP]] || RW || Get or sets the skill's group flags.
 |-
 | [[KEY]] || RW || Gets or sets the skill's defname.