- Joined
- Jul 20, 2004
- Messages
- 2,760
Introduction
This tutorial is for both those who are making spells and those who want to import them. Why for spellmakers too? Because if they make importing efficient, their spells will be more appreciated and of course, implemented in custom maps.
1. Main issues
What exactly do you have to know about importing spells from a map into another? It’s good to understand what must be imported in order to make the map work. It’s not enough to simply copy-paste the main spell and the trigger. Complicated spells will involve units, other spells, buffs and perhaps even custom models or items. So... how do you know which to download? It’s pretty complicated because you don’t really know what exactly to import. Objects needed to be imported differ from one spell to another. Simplest case: non GUI/JASS-enhanced spell. If they use a single spell, just use sub point a) and if they are summoning spells, copy the summoned units as well. But what if they are JASS/Trigger enhanced?
2. Importing Part
Let's take each type of object (spells, buffs, units, items) and discuss their importing.
a) importing the major spell
How do you know which spell to import? Well, into the map you’ve seen the spell you want to import for your hero. Go to Object Editor – Abilities and search for it under custom spells. Once you’ve found it Click with your mouse on it into the left panel and then go up into the menu at Edit – Copy Ability (or press ctrl+C). Then open your map, go again to Object Editor – Abilities, into the upper menu at Edit – Paste Ability (ctrl+V).
Note: The following objects, triggers and models are not always easy to find. If you can’t find any information into the map or you can’t figure out which are needed for the spell, PM the author of the spell and ask him/her about them.
Warning: Make sure to check that any object-editing links between multiple abilities are correct. For example, if the field of an object involves other custom objects, make sure that those links appear into your map too. For example, if your spell requires a custom "Spellbook" ability which contains into its Data field the custom spell called "Fire Flare", if "Fire Flare" does not appear after you've imported all the custom data into your map, make sure to change that field to "Fire Flare".
b) Importing dummy units
Read the FAQ first to find out what dummy units are. Not all enchanced spells have dummy units but if it has, o the same copy-paste method for each of them, but this time in the Object Editor – Units section. Now into your map look at the abilities of the dummy units in the Abilities – Normal field. If it’s different from the original map, make sure to add the custom micro or normal abilities (non-custom) needed.
c) Importing buffs
If the map contains any custom buffs, make sure to check if any of them belongs to the spell you want to import. If it does, use the technique as before to copy-paste the buffs necessary. After that go into the original map and look at the spells’ (micro or major) Stats – Buffs for any buffs. If there are, change those fields accordingly into your map as well.
Warning! Even though the micro spells/buffs are in your map, other buffs/spells might show up into the unit’s/spell’s stats. This is because of the raw code for buffs/spells is different from a map to another. They are numbered in the order in which they are created and if that order is different into your map, then things mix up. We’ll return to the raw code chapter later.
d) Importing items
Check for custom items which might used by the spell. If there are any, copy-paste them into your map as well.
e) Importing custom models
There might be custom models used for the dummies, items, buffs, effects etc. If there are you will need to go into the import manager, export each of them, import them into your map, and put the correct paths.
f) Importing scripts
And here we get to the hard part. If the spell is enchanced it will obviously contain scripts, either in GUI or JASS triggers. We will go separately for GUI and JASS because the methods of implementation are obviously different as well.
I. GUI implementation
These are just normal triggers, with events/conditions/actions. Copy-paste all the spell-related triggers into your map. Now most of you will say: “Ok, we’ve copy-pasted the triggers, things will work out, end of story” but it isn’t so simple. Why? Because we might have raw codes involved as well. And so, how do you solve this problem? Well, let’s take a simple example.
We have the following condition into the original map:
In this case you will have to go and change this condition. In this case we change the Strafe with Mass Sleep and problem is solved. But how do you know in how many places you need to do this change? Usually they will appear when you refer to custom abilities/units/doodads/items/buffs/models. You will have to check the trigger event by event, condition by condition and action by action and change these accordingly so they look like into the original map.
Keep in mind that you have to refer to this when you are talking about a general unit type, doodad type, item type, unit type, buff, ability. So problems cannot appear to constants like Casting Unit, Ability Being Cast, Item Being Manipulated and so on. Also, the problems do not appear when you refer to these objects with variables. They will usually appear when you Create Units (and you refer to a certain unit type), add an ability, remove an ability, create an item or even creating a special effect (it if involves custom models).
II. JASS Implementation
This time, we are talking about a custom script. It means that in the lower right panel of the trigger editor there won’t be the general events/conditions/actions but instead, some writings. And for those who don’t understand JASS, it is very hard to implement spells. We are having the same rawcode problem and this time it will be very hard to scan for the rawcodes themselves since you will problem not get a thing. But I will try to guide you the best I can.
If you are lucky, the spellmaker made the JASS easier but allowing you to change the raw code in a single place and with that, problem solved. I (and many other spellmakers) use the following structure at the beginning of the script. This is just an example:
Note: “x” can be anything else as well as ‘A001’. The script can also differ but usually that’s how it looks.
You will notice more one such structure since JASS spellmakers who care for implementation include one script/rawcode. In this case, I’ve made a raw code for an ability since it begins with A. If into your map the ability has a different raw code you can replace A001 with anything else. Just watch out to leave the ‘ ’ alone.
Now, how can you see the rawcode? Go to your Object Editor, and then View – Display Values As Raw Data. Instead of the name of the objects you will see a raw code. Then replace that raw code into the script.
WARNING: The raw code is case sensitive.
But what if the spellmaker either is lazy, doesn’t know or simply doesn’t care to add these functions then things will be tougher. But don’t worry. Again I will try to guide you. Switch between the spell’s map and your map so you can see the raw code of the objects you imported. I suggest you to take a piece of paper and write on it something like this:
This is a pure example but it will probably give you an idea about what I mean. A001 and A004 are the same ability (Mass Sleep) but in the spell’s map it has the rawcode A001 and in your map it has the rawcode A004. In the case of the sleep dummy spell you need to change the script
Do the same sketch with your own spells. Things will be very easy after that. Now, we’ll still continue to work on this example but in your case, make sure to work with your own rawcodes.
We are going to take the following script. It doesn’t matter what it does, you just need learn how to work on rawcodes. Nothing else!
Freaky, eh? Don’t worry, things are easier than they seem. Now, let’s have a look at the sketch before the script. We have to search for ‘A001’ rawcode first and change it with ‘A004’. Where do you see it first?
Going further, you will see on the list the dummy unit. But it has the same rawcode so we don’t have to bother about it.
Last but not least the ability ‘A002’. Search for it. Where do you see it?
NOTE: In some cases the author may also include custom scripts that apply to all the functions. In this case, you will need to copy-paste that script as well into the head of your map. Go into the trigger editor and look at the picture down.
Note: If two maps have different codes you will need to paste the second code in the tail of the first one and so on.
I hope this clarified the problem of rawcodes and I hope you will no longer be afraid of JASS, atleast when you must import it..
3. Making Importing Easier
This chapter involves spellmakers. Hopefully this will make your spells easier to import. There are a couple of important steps you should follow.
a) Mention for each spell which objects must be imported
b) Try to avoid rawcode problem in triggers through instructions (comments) or through variable if your spell is not multi-instanceable.
c) Assure that usually your events involve general units.
Pro Example:
And this concludes our tutorial. If you have any other questions or are still confused, state your problem.
~Daelin
This tutorial is for both those who are making spells and those who want to import them. Why for spellmakers too? Because if they make importing efficient, their spells will be more appreciated and of course, implemented in custom maps.
1. Main issues
What exactly do you have to know about importing spells from a map into another? It’s good to understand what must be imported in order to make the map work. It’s not enough to simply copy-paste the main spell and the trigger. Complicated spells will involve units, other spells, buffs and perhaps even custom models or items. So... how do you know which to download? It’s pretty complicated because you don’t really know what exactly to import. Objects needed to be imported differ from one spell to another. Simplest case: non GUI/JASS-enhanced spell. If they use a single spell, just use sub point a) and if they are summoning spells, copy the summoned units as well. But what if they are JASS/Trigger enhanced?
2. Importing Part
Let's take each type of object (spells, buffs, units, items) and discuss their importing.
a) importing the major spell
How do you know which spell to import? Well, into the map you’ve seen the spell you want to import for your hero. Go to Object Editor – Abilities and search for it under custom spells. Once you’ve found it Click with your mouse on it into the left panel and then go up into the menu at Edit – Copy Ability (or press ctrl+C). Then open your map, go again to Object Editor – Abilities, into the upper menu at Edit – Paste Ability (ctrl+V).
Note: The following objects, triggers and models are not always easy to find. If you can’t find any information into the map or you can’t figure out which are needed for the spell, PM the author of the spell and ask him/her about them.
Warning: Make sure to check that any object-editing links between multiple abilities are correct. For example, if the field of an object involves other custom objects, make sure that those links appear into your map too. For example, if your spell requires a custom "Spellbook" ability which contains into its Data field the custom spell called "Fire Flare", if "Fire Flare" does not appear after you've imported all the custom data into your map, make sure to change that field to "Fire Flare".
b) Importing dummy units
Read the FAQ first to find out what dummy units are. Not all enchanced spells have dummy units but if it has, o the same copy-paste method for each of them, but this time in the Object Editor – Units section. Now into your map look at the abilities of the dummy units in the Abilities – Normal field. If it’s different from the original map, make sure to add the custom micro or normal abilities (non-custom) needed.
c) Importing buffs
If the map contains any custom buffs, make sure to check if any of them belongs to the spell you want to import. If it does, use the technique as before to copy-paste the buffs necessary. After that go into the original map and look at the spells’ (micro or major) Stats – Buffs for any buffs. If there are, change those fields accordingly into your map as well.
Warning! Even though the micro spells/buffs are in your map, other buffs/spells might show up into the unit’s/spell’s stats. This is because of the raw code for buffs/spells is different from a map to another. They are numbered in the order in which they are created and if that order is different into your map, then things mix up. We’ll return to the raw code chapter later.
d) Importing items
Check for custom items which might used by the spell. If there are any, copy-paste them into your map as well.
e) Importing custom models
There might be custom models used for the dummies, items, buffs, effects etc. If there are you will need to go into the import manager, export each of them, import them into your map, and put the correct paths.
f) Importing scripts
And here we get to the hard part. If the spell is enchanced it will obviously contain scripts, either in GUI or JASS triggers. We will go separately for GUI and JASS because the methods of implementation are obviously different as well.
I. GUI implementation
These are just normal triggers, with events/conditions/actions. Copy-paste all the spell-related triggers into your map. Now most of you will say: “Ok, we’ve copy-pasted the triggers, things will work out, end of story” but it isn’t so simple. Why? Because we might have raw codes involved as well. And so, how do you solve this problem? Well, let’s take a simple example.
We have the following condition into the original map:
but which in your map will look like this:
In this case you will have to go and change this condition. In this case we change the Strafe with Mass Sleep and problem is solved. But how do you know in how many places you need to do this change? Usually they will appear when you refer to custom abilities/units/doodads/items/buffs/models. You will have to check the trigger event by event, condition by condition and action by action and change these accordingly so they look like into the original map.
Keep in mind that you have to refer to this when you are talking about a general unit type, doodad type, item type, unit type, buff, ability. So problems cannot appear to constants like Casting Unit, Ability Being Cast, Item Being Manipulated and so on. Also, the problems do not appear when you refer to these objects with variables. They will usually appear when you Create Units (and you refer to a certain unit type), add an ability, remove an ability, create an item or even creating a special effect (it if involves custom models).
II. JASS Implementation
This time, we are talking about a custom script. It means that in the lower right panel of the trigger editor there won’t be the general events/conditions/actions but instead, some writings. And for those who don’t understand JASS, it is very hard to implement spells. We are having the same rawcode problem and this time it will be very hard to scan for the rawcodes themselves since you will problem not get a thing. But I will try to guide you the best I can.
If you are lucky, the spellmaker made the JASS easier but allowing you to change the raw code in a single place and with that, problem solved. I (and many other spellmakers) use the following structure at the beginning of the script. This is just an example:
JASS:
function x takes nothing returns integer
return ‘A001’
endfunctionNote: “x” can be anything else as well as ‘A001’. The script can also differ but usually that’s how it looks.
You will notice more one such structure since JASS spellmakers who care for implementation include one script/rawcode. In this case, I’ve made a raw code for an ability since it begins with A. If into your map the ability has a different raw code you can replace A001 with anything else. Just watch out to leave the ‘ ’ alone.
Now, how can you see the rawcode? Go to your Object Editor, and then View – Display Values As Raw Data. Instead of the name of the objects you will see a raw code. Then replace that raw code into the script.
WARNING: The raw code is case sensitive.
But what if the spellmaker either is lazy, doesn’t know or simply doesn’t care to add these functions then things will be tougher. But don’t worry. Again I will try to guide you. Switch between the spell’s map and your map so you can see the raw code of the objects you imported. I suggest you to take a piece of paper and write on it something like this:
This is a pure example but it will probably give you an idea about what I mean. A001 and A004 are the same ability (Mass Sleep) but in the spell’s map it has the rawcode A001 and in your map it has the rawcode A004. In the case of the sleep dummy spell you need to change the script
Do the same sketch with your own spells. Things will be very easy after that. Now, we’ll still continue to work on this example but in your case, make sure to work with your own rawcodes.
We are going to take the following script. It doesn’t matter what it does, you just need learn how to work on rawcodes. Nothing else!
JASS:
function Trig_Mass_Sleep_Conditions takes nothing returns boolean
return GetSpellAbilityId() == 'A001'
endfunction
function Trig_Mass_Sleep_Actions takes nothing returns nothing
local unit cast
local location p
local group g
local unit u
local unit dumb
set cast = GetTriggerUnit()
set g = GetUnitsInRangeOfLocAll(600.00, GetSpellTargetLoc())
set u = FirstOfGroup(g)
loop
exitwhen u==null
set u = FirstOfGroup(g)
call GroupRemoveUnit(g,u)
set dumb = CreateUnitAtLoc(GetOwningPlayer(cast), 'h000', GetUnitLoc(u), 0.00)
call UnitAddAbilityBJ( 'A002', GetTriggerUnit() )
call UnitApplyTimedLifeBJ( 1, 'BTLF', dumb )
call IssueTargetOrderBJ( dumb, "sleep", u )
endloop
set g = null
set dumb= null
set cast = null
set p = null
endfunction
//===========================================================================
function InitTrig_Mass_Sleep takes nothing returns nothing
set gg_trg_Mass_Sleep = CreateTrigger( )
call TriggerRegisterAnyUnitEventBJ( gg_trg_Mass_Sleep, EVENT_PLAYER_UNIT_SPELL_EFFECT )
call TriggerAddCondition( gg_trg_Mass_Sleep, Condition( function Trig_Mass_Sleep_Conditions ) )
call TriggerAddAction( gg_trg_Mass_Sleep, function Trig_Mass_Sleep_Actions )
endfunctionFreaky, eh? Don’t worry, things are easier than they seem. Now, let’s have a look at the sketch before the script. We have to search for ‘A001’ rawcode first and change it with ‘A004’. Where do you see it first?
You simply change the ‘A001’ with ‘A004’. Search for it into the rest of the script. None others? Excellent, then you are done with.
Going further, you will see on the list the dummy unit. But it has the same rawcode so we don’t have to bother about it.
Last but not least the ability ‘A002’. Search for it. Where do you see it?
And this time you replace the ‘A002’ with ‘A005’. You don’t find it anywhere else so that’s kinda all. Do we have other rawcodes to modify? No… problem solved.
NOTE: In some cases the author may also include custom scripts that apply to all the functions. In this case, you will need to copy-paste that script as well into the head of your map. Go into the trigger editor and look at the picture down.
Note: If two maps have different codes you will need to paste the second code in the tail of the first one and so on.
I hope this clarified the problem of rawcodes and I hope you will no longer be afraid of JASS, atleast when you must import it..
3. Making Importing Easier
This chapter involves spellmakers. Hopefully this will make your spells easier to import. There are a couple of important steps you should follow.
a) Mention for each spell which objects must be imported
b) Try to avoid rawcode problem in triggers through instructions (comments) or through variable if your spell is not multi-instanceable.
c) Assure that usually your events involve general units.
Pro Example:
-
Events – A Unit Starts the Effect of an Ability
-
Conditions – Ability Being Cast Equal to Mass Sleep
-
Actions - …
-
Events – Unit – Knight 0001 <gen> Starts the Effect of an Ability
-
Conditions – Ability Being Cast Equal to Mass Sleep
-
Actions - …
-
Events – A Unit Owned By Player 1 (Red) Starts the Effect of an Ability
-
Conditions – Ability Being Cast Equal to Mass Sleep
-
Actions - …
And this concludes our tutorial. If you have any other questions or are still confused, state your problem.
~Daelin
Last edited:
