Difference between revisions of "Sc start"

From Hercules Wiki
Jump to: navigation, search
(Created page with "Category:Script_Command ==Syntax== * sc_start <effect type>,<ticks>,<extra argument>{,<target ID number>}; * sc_start2 <effect type>,<ticks>,<extra argument>,<pe...")
 
(Description)
 
(5 intermediate revisions by 3 users not shown)
Line 9: Line 9:
 
used a lot in the item scripts.
 
used a lot in the item scripts.
  
Effect type is a number of effect, {{git|db/const.txt}} lists the common (mostly  
+
Effect type is a number of effect, {{git|db/constants.conf}} lists the common (mostly  
 
negative) status effect types as constants, starting with 'SC_'. You can also  
 
negative) status effect types as constants, starting with 'SC_'. You can also  
 
use this to give someone an effect of a player-cast spell.
 
use this to give someone an effect of a player-cast spell.
Line 33: Line 33:
 
- val1 is the first element, val2 is the resistance to the element val1.
 
- val1 is the first element, val2 is the resistance to the element val1.
 
- val3 is the second element, val4 is the resistance to said element.
 
- val3 is the second element, val4 is the resistance to said element.
eg: [[sc_start4]] SC_DefEle,60000,Ele_Fire,20,Ele_Water,-15;
+
eg: [[sc_start4]] SC_ARMOR_ELEMENT,60000,Ele_Fire,20,Ele_Water,-15;
  
 
'[[sc_end]]' will remove a specified status effect. If SC_All is used (-1), it will
 
'[[sc_end]]' will remove a specified status effect. If SC_All is used (-1), it will
Line 39: Line 39:
  
 
You can see the full list of status effects caused by skills in  
 
You can see the full list of status effects caused by skills in  
{{svn|trunk/src/map/status.h}} - they are currently not fully documented, but most of that  
+
{{git|src/map/status.h}} - they are currently not fully documented, but most of that  
 
should be rather obvious.
 
should be rather obvious.
 +
 
==Examples==
 
==Examples==
 
<pre>
 
<pre>
     // This would poison them for 10 min
+
     // This would poison them for 10 minutes
     sc_start SC_Poison,600000,0;
+
     sc_start SC_POISON,600000,0;
  
 
     // This will bless someone as if with Bless 10:
 
     // This will bless someone as if with Bless 10:
 
     sc_start 10,240000,10;
 
     sc_start 10,240000,10;
 
</pre>
 
</pre>

Latest revision as of 19:27, 5 May 2016

Syntax

  • sc_start <effect type>,<ticks>,<extra argument>{,<target ID number>};
  • sc_start2 <effect type>,<ticks>,<extra argument>,<percent chance>{,<target ID number>};
  • sc_start4 <effect type>,<ticks>,<value 1>,<value 2>,<value 3>,<value 4>{,<target ID number>};
  • sc_end <effect type>{,<target ID number>};

Description

These command bestow a status effect on the invoking character. This command is used a lot in the item scripts.

Effect type is a number of effect, db/constants.conf lists the common (mostly negative) status effect types as constants, starting with 'SC_'. You can also use this to give someone an effect of a player-cast spell.

Extra argument's meaning differs depending on the effect type, for most effects caused by a player skill the extra argument means the level of the skill that would have been used to create that effect, for others it might have no meaning whatsoever. You can actually bless someone with a 0 bless spell level this way, which is fun, but weird.

The target ID number, if given, will cause the status effect to appear on a specified character, instead of the one attached to the running script. This has not been properly tested.

'sc_start2' is perfectly equivalent, but unlike 'sc_start', a status change effect will only occur with a specified percentage chance. 10000 given as the chance is equivalent to a 100% chance, 0 is a zero.

'sc_start4' is just like 'sc_start', however it takes four parameters for the status change instead of one. What these values are depends on the status change in question. For example, elemental armor defense takes the following four values: - val1 is the first element, val2 is the resistance to the element val1. - val3 is the second element, val4 is the resistance to said element. eg: sc_start4 SC_ARMOR_ELEMENT,60000,Ele_Fire,20,Ele_Water,-15;

'sc_end' will remove a specified status effect. If SC_All is used (-1), it will do a complete removal of all statuses (although permanent ones will re-apply).

You can see the full list of status effects caused by skills in src/map/status.h - they are currently not fully documented, but most of that should be rather obvious.

Examples

    // This would poison them for 10 minutes
    sc_start SC_POISON,600000,0;

    // This will bless someone as if with Bless 10:
    sc_start 10,240000,10;