incompatibility notice for m.u.g.e.n ver 2000.06.

27
===================================================
m.u.g.e.n, (c) elecbyte 2000

this document is meant for users who wish to update characters from
mugen version 2000.01.01 to work with 2000.06.27 and newer versions of
mugen.

the following is a list of changes that must be performed to bring

characters into compliance with the 2000.06.27 cns standard.

1. changed syntax for var, numprojid, ishelper, numhelper, numexplod

triggers.id numbers passed to these triggers must be enclosed
within parentheses (in older revisions of the cns standard, these
id numbers were suffixed to the trigger name). for instance, var8
should now be written var(8).

note: in a previous revision of this document, the projguarded,

projcancel, and projhit triggers were erroneously listed as having
syntax changes similar to the above. the correct syntax for these
triggers, as given in trigger.txt, is unchanged from earlier
versions.

2. changed syntax for helper, target redirection keywords.

as above, id numbers passed to these redirection keywords must be
enclosed within parentheses, whereas they were appended to the
keywords in previous versions.

3. changed syntax for animexist, selfanimexist triggers.

the action number to check with an animexist or selfanimexist
trigger must now be given in parentheses. for example,

(old) animexist = 5555

(new) animexist(5555)

(old) selfanimexist != 5555

(new) !selfanimexist(5555)

3. velocity, position triggers removed.

the alternate keywords velocity and position are no longer accepted
for the vel and pos triggers.

4. command names and player names must be enclosed in

double quotes.
basically, any user-defined string must be quoted. for instance,
trigger1 = command = kumquat, kiwi, and penguin
should become
trigger1 = command = "kumquat, kiwi, and penguin"
also, any definition of a player name (whether in the def file,
as a parameter to the helper state controller, or as an argument
to the p*name triggers) must also be given in quotes.

5. sloppy parsing versus strict parsing.

the parser is now much more exacting about the kinds of input it
will accept. this means that many syntax errors that would cause
silent failures or glitches under the old parser will now be
rejected outright. it is, of course, not possible to give a
 comprehensive list of possible syntax errors, but common errors
include the following:
*) typing => or =< instead of >= and <=
*) failing to escape comments with a semicolon
*) invalid use of strings as id numbers (numexplodmyexplodtype)
*) specification of a floating-point number where an integer is
expected
*) typing . instead of , or vice versa
*) listing more parameters than are expected by the state
controller (see sctrls.doc)

6. all spark references have been changed from 0,n (where n is the
animation number) to just n.
for example, in a hitdef,
sparkno = 0,6
would be:
sparkno = 6
in addition, most anim numbers in fightfx.air (formerly
staticfx.air) have been remapped. here is the new mapping:
standard effects
0 - light hit spark
1 - medium hit spark
2 - strong hit spark
3 - big super hit spark
10 - light blood hit spark
11 - medium blood hit spark
12 - strong blood hit spark
40 - light guard spark
41 - medium guard spark
42 - strong guard spark
60 - small ground shockwave
61 - medium ground shockwave
62 - big ground shockwave
70 - light wall-hit shockwave/spark
71 - medium wall-hit shockwave/spark
72 - strong wall-hit shockwave/spark
other effects
100 - lv1 super spark
101 - lv2 super spark
102 - lv3 super spark
120 - small dust
130 - power-up effect
to map old numbers to new ones, change accordingly:
old new
--- ---
0-4 0
5 1
6 12
7 2
15 60
20 40
30 100
31 102
50 120
100 130
after mapping the example given above would now be:
in a hitdef:
sparkno = 0,6
 should be:
sparkno = 12

7. some required anim numbers have been changed.

these are the changes since the 2000.01.01 version of mugen:
old changes
---- -------
5100 split into 5100, 5160
5101 split into 5101, 5161
5105 changed to 5170
5106 changed to 5171
5051 exchanged with 5060
5060 exchanged with 5051
5150 changed to 5140
5155 changed to 5150
how to fix older characters:
1. cut and paste the second element to the last element of action
5100 into a new action 5160. if there is only one element in
action 5100, just copy it.
2. action 5100 should now have exactly one element in it. set
the looptime of that element to 3.
3. repeat step 1 and 2 for action 5101, if your character has it.
instead of 5160, make an action 5161.
4. change action number 5105 to 5170. action 5105 is no longer
used.
5. repeat step 4 for action 5106 (if you character has it),
changing it to 5171.
6. change action number 5051 to 5060, and 5060 to 5051, if
they exist.
7. change action number 5150 to 5140, and 5155 to 5150, if
they exist.
8. check your character's .cns for references to any of the
affected actions, and modify the controllers accordingly.

8. there are 10 new required sprites, in addition to the old set.

refer to docs/spr.gif to see which new sprites your character
should have.

9. in the character's cns file, having a fall flag on a hitdef will

now force the opponent to fall in all cases. this is unlike
previous versions of mugen, where if p2 is standing and the
y-component of p1's ground.velocity is 0, then p2 does not fall.
check your hitdefs to make sure they produce correct behavior.

10. characters are no longer frozen during preintro.

preintro is the time at the beginning of a round, when the
screen is fading in.
character intro states will need to account for updates
during preintro. use the roundstate trigger to tell
when preintro is over.
for most cases, it is a simple matter of freezing the
animation while roundstate = 0. for example, you can add
a state that looks like this:
[state 191, x]
type = changeanim
trigger1 = roundstate = 0
value = 190
12. helpers no longer inherit state -2 controllers. unless they have
keyctrl=1, they no longer inherit state -1 controllers either.

13. there are new fields in the .def file to specify a character's
author, revision date, and minimum required version of mugen. see
kfm's .def file for details.

14. stage names in stage .def files must be enclosed in double quotes,
similarly to item 4.