AMDS脚本指令说明书v16修正版.docx
《AMDS脚本指令说明书v16修正版.docx》由会员分享，可在线阅读，更多相关《AMDS脚本指令说明书v16修正版.docx（29页珍藏版）》请在冰豆网上搜索。
AMDS脚本指令说明书v16修正版
（c）AVGMAKERDS
–ByHewenxie
脚本指令说明书
V1.6
修正版BY雨里小生
目录
一.对话文字显示指令5
1.@say5
2.@boxText5
3.@SetFontColor6
4.@FontShadowOn@FontShadowOff6
5.@FontShadowColor6
二.画面相关操作指令7
1.@chara7
2.@clearChara7
3.@anim7
4.@bg8
5.@res_chara8
6.@res_bg9
7.@btbg9
8.@res_btbg10
9.@texton10
10.@textoff10
11.@erase11
12.@head11
13.@res_head11
14.@clearHead12
15.@quakex@quakey12
16.@lrchara12
17.@res_lrchara13
18.@fadein@fadeout13
19.@flash14
20.@wave14
21.@colorEffect14
22.@graybg15
三.脚本操作类指令16
1.@jump16
2.@if@endif16
3.@call16
4.@changeText17
5.@gameOver17
6.=17
7.@select18
8.@var_select18
9.@menusys_on@menusys_off19
10.@tbtrans_on@tbtrans_off19
11.@review19
12.@LoadImageButton20
13.@image_select20
14.@setMenuBg20
15.@setMenuBtn21
16.@txt_select21
17.@textBox21
四．系统操作类指令23
1.@set_var23
2.@unset_var23
3.@set_value23
4.@delay24
5.@save24
6.@load24
7.@var_save25
8.@var_load25
9.@SetGameName25
五.声音类指令26
1.@playSFX26
2.@res_playSFX26
3.@loopSFX26
4.@res_loopSFX27
5.@stopSFX27
6.@playBGM27
7.@stopBGM28
8.@res_playBGM28
无特殊说明每条指令均为@开头，以;（英语分号）结尾。
推荐一行只写一个指令。
编写过程中，请注意指令的大小写以及全半角。
指令的符号都应为英文符号。
指令前加//，即为注释掉该行，被注释掉的指令不会执行。
如//@say（.....）;
一.对话文字显示指令
前置说明：
1.对话显示内容支持更改字体颜色。
字体颜色默认为白色，如要对字体颜色操作，请使用%cX，X为0～9任意数字，默认对应颜色如下：
1-白色（white），2-红色（red），3-绿色（green），4-蓝色（blue），5-紫色（purple），
6-青色（cyan），7-黄色（yellow），8-淡灰色（lightgrey），9-深灰色（darkgrey），0-黑色（black）
2.如果希望在一句话中间出现换行，用\n符号。
需要停顿（继续则需要按键）效果，用\t符号。
1.@say
1.1功能：
人物对话显示功能，在对话框中进行显示。
1.2脚本指令原型：
@say（style,isAnimation,name,content）
1.3参数说明：
1.style：
0-普通模式1-有头像模式（会空出一块空间用于显示头像）
2.isAnimation：
人物说话是否有动画效果，具体效果与@anim（）有关。
1-有动画效果，0-无动画效果
3.name：
说话人物名字。
如果不需要名字，置空即可
4.content：
说话内容。
注意用英文模式下的""包含其内容，格式如"你好！
"，引号内部不再兼容英文双引号，中文双引号兼容。
1.4例：
@say（0,0,?
?
?
?
"你好！
我是%c2静%c1，初次见面！
请多多关照！
"）;
2.@boxText
2.1功能：
框文字显示功能，将文字在矩形框中进行显示。
2.2脚本指令原型：
@boxText（screen,basex,basey,maxx,maxy,verbatim,content）
2.3参数说明：
1.screen：
显示用屏幕，0-上屏，1-下屏
2.basex：
用于显示文字的矩形框左上角顶点的x坐标
3.basey：
用于显示文字的矩形框左上角顶点的y坐标
4.maxx：
用于显示文字的矩形框右下角顶点的x坐标
5.maxy：
用于显示文字的矩形框右下角顶点的y坐标
6.verbatim：
是否逐字显示。
0-否，1-逐字显示
7.content：
说话内容。
注意用英文模式下的""包含其内容，格式如"你好！
"，引号内部不再兼容英文双引号，中文双引号兼容。
2.4例：
@boxText（1,20,20,200,150,1,"你即将进入AVG的美妙世界！
"）;
3.@SetFontColor
3.1功能：
再设定0-9号中的颜色为自定义颜色。
3.2脚本指令原型：
@SetFontColor（screen,number,red,green,blue）
3.3参数说明：
1.screen：
0-上屏1-下屏
2.number：
0-9,对应%c中的号码，请参照开篇前置说明
3.red,green,blue：
即RGB,三个参数范围分别都为0-31
3.4例：
@SetFontColor（0,1,12,12,12）;
4.@FontShadowOn@FontShadowOff
4.1功能：
字体阴影效果打开/关闭。
4.2脚本指令原型：
@FontShadowOn（）
@FontShadowOff（）
4.3参数说明：
4.4例：
@FontShadowOn（）;@FontShadowOff（）;
5.@FontShadowColor
5.1功能：
设置字体阴影颜色。
5.2脚本指令原型：
@FontShadowColor（color_number）
5.3参数说明：
1.color_number：
0-9,对应%c中的号码，请参照开篇前置说明
5.4例：
@FontShadowColor（8）;
二.画面相关操作指令
1.@chara
1.1功能：
显示、变更人物立绘图像，支持渐变效果。
注：
AMDS现在直接支持256*192立绘，不需要切割。
1.2脚本指令原型：
@chara（path,isAlpha）
1.3参数说明：
1.path：
人物图象文件路径。
文件名后不写文件后缀。
2.isAlpha：
是否打开渐变进出效果。
0-不打开，1-打开
1.4例：
@chara（avgFiles/chara/chara1,1）;
2.@clearChara
2.1功能：
擦除人物图像。
2.2脚本指令原型：
@clearChara（）
2.3参数说明：
无参数
2.4例：
@clearChara（）;
3.@anim
3.1功能：
加载动画帧图像。
此动画帧在对话过程中实现说话动作。
注意：
由于此功能支持并不好，所以不建议使用。
要使用的话图像长宽最好不要超过16*16。
3.2脚本指令原型：
@anim（path,width,height,x,y）
3.3参数说明：
1.path：
图象文件路径。
文件名后不写文件后缀。
2.width：
图像宽度。
3.height：
图象高度。
4.x：
显示图像的x坐标。
5.y：
显示图像的y坐标。
3.4例：
@anim（avgFiles/chara/anim1,16,16,128,50）;
4.@bg
4.1功能：
显示、变更背景。
4.2脚本指令原型：
@bg（path,type）
4.3参数说明：
1.path：
背景图象文件路径。
文件名后不写文件后缀。
如果为null或NULL则为擦除背景
2.type：
是否打开渐变进出效果。
0-无效果，
1-白渐进，
2-黑渐进，
3-10黑色拉幕效果（具体请实机测试），
11-白渐进+灰化效果，
12-黑渐进+灰化效果
4.4例：
@bg（avgFiles/bg/bg1,1）;
5.@res_chara
5.1功能：
从打包后的资源中提取并显示、变更人物立绘图像，支持渐变效果。
注：
AMDS现在直接支持256*192立绘，不需要切割。
5.2脚本指令原型：
@res_chara（resource,filename,isAlpha）
5.3参数说明：
1.resource:
资源文件路径。
2.filename：
人物图像文件名字。
文件名后不写文件后缀。
3.isAlpha：
是否打开渐变进出效果。
0-不打开，1-打开
5.4例：
@res_chara（avgFiles/chara/img.res,chara1,1）;
6.@res_bg
6.1功能：
从打包后的资源中提取并显示、变更背景。
6.2脚本指令原型：
@res_bg（resource,filename,type）
6.3参数说明：
1.resource:
资源文件路径。
如果为null获NULL则为擦除背景
2.filename：
背景图象文件路径。
文件名后不写文件后缀。
如果为null或NULL则为擦除背景
3.type：
是否打开渐变进出效果。
0-无效果，
1-白渐进，
2-黑渐进，
3-10黑色拉幕效果（具体请实机测试）
11-白渐进+灰化效果
12-黑渐进+灰化效果
6.4例：
@res_bg（avgFiles/bg/bg.res,bg1,1）;
7.@btbg
7.1功能：
在下屏幕显示、变更背景。
7.2脚本指令原型：
@btbg（path,type）
7.3参数说明：
1.path：
背景图象文件路径。
文件名后不写文件后缀。
如果为null或NULL则为擦除背景
2.type：
是否打开渐变进出效果。
0-无效果，
1-白渐进，
2-黑渐进，
3-10黑色拉幕效果（具体请实机测试）
11-白渐进+灰化效果
12-黑渐进+灰化效果
7.4例：
@btbg（avgFiles/bg/bg1,1）;
8.@res_btbg
8.1功能：
在下屏幕显示、变更从打包后的资源中读取的背景。
8.2脚本指令原型：
@res_btbg（resource,filename,type）
8.3参数说明：
1.resource:
资源文件路径。
如果为null或NULL则为擦除背景
2.filename：
背景图象文件路径。
文件名后不写文件后缀。
如果为null或NULL则为擦除背景
3.type：
是否打开渐变进出效果。
0-无效果，
1-白渐进，
2-黑渐进，
3-10黑色拉幕效果（具体请实机测试）
11-白渐进+灰化效果，
12-黑渐进+灰化效果
8.4例：
@res_btbg（avgFiles/bg/bg.res,bg1,1）;
9.@texton
9.1功能：
上屏显示文字和文字框。
9.2脚本指令原型：
@texton（）;
9.3参数说明：
9.4例：
@texton（）;
10.@textoff
10.1功能：
上屏文字和文字框消失。
10.2脚本指令原型：
@textoff（）;
10.3参数说明：
10.4例：
@textoff（）;
11.@erase
11.1功能：
擦除指定屏幕上的文字。
11.2脚本指令原型：
@erase（screen）;
11.3参数说明：
screen：
0-上屏1-下屏
11.4例：
@erase
（1）;
12.@head
12.1功能：
加载头像。
12.2脚本指令原型：
@head（path）
12.3参数说明：
1.path：
头像文件路径。
文件名后不写文件后缀。
值为NULL或null时，指令变为擦除头像功能。
12.4例：
@head（avgFiles/chara/head1）;
@head（null）;
13.@res_head
13.1功能：
从打包资源读取，加载头像。
13.2脚本指令原型：
@res_head（resource,filename）
13.3参数说明：
1.resource:
资源文件路径。
2.filename：
头像文件名字。
文件名后不写文件后缀。
置为NULL或null时，指令变为擦除头像功能。
13.4例：
@res_head（avgFiles/chara/img.res,head1）;
@res_head（null,null）;
14.@clearHead
14.1功能：
擦除头像。
14.2脚本指令原型：
@clearHead（）
14.3参数说明：
无参数
14.4例：
@clearHead（）;
15.@quakex@quakey
15.1功能：
按x或y轴方向画面震动。
15.2脚本指令原型：
@quakex（times）（x方向）
@quakey（times）（y方向）
15.3参数说明：
times：
振动次数,不填则默认为5
15.4例：
@quakex
（1）;@quakey（5）;
16.@lrchara
16.1功能：
全屏分左半右半部分分别显示人物图像。
注：
AMDS现在直接支持双256*192立绘，不需要切割。
支持单边独立保留图像或清除图像。
16.2脚本指令原型：
@lrchara（lpath,rpath,isAlpha）
16.3参数说明：
1.lpath：
左边人物图象文件路径。
文件名后不写文件后缀。
为NULL（大写）时则为清除，
为KEEP（大写）时则为保留当前图像。
2.rpath：
右边人物图象文件路径。
文件名后不写文件后缀。
为NULL（大写）时则为清除，
为KEEP（大写）时则为保留当前图像。
3.isAlpha：
是否打开渐变进出效果。
0-不打开，1-打开
16.4例：
@lrchara（avgFiles/chara/chara1,avgFiles/chara/chara2,1）;
@lrchara（KEEP,avgFiles/chara/chara3,1）;
@lrchara（NULL,KEEP,1）;
17.@res_lrchara
17.1功能：
全屏分左半右半部分分别显示人物图像。
注：
AMDS现在直接支持双256*192立绘，不需要切割。
支持单边独立保留图像或清除图像。
17.2脚本指令原型：
@res_lrchara（resource,lpath,rpath,isAlpha）
17.3参数说明：
1.resource:
资源文件路径。
2.lpath：
左边人物图象文件路径。
文件名后不写文件后缀。
为NULL（大写）时则为清除，
为KEEP（大写）时则为保留当前图像。
3.rpath：
右边人物图象文件路径。
文件名后不写文件后缀。
为NULL（大写）时则为清除，
为KEEP（大写）时则为保留当前图像。
4.isAlpha：
是否打开渐变进出效果。
0-不打开，1-打开
17.4例：
@res_lrchara（avgFiles/chara/img.res,chara1,chara2,1）;
@res_lrchara（avgFiles/chara/img.res,KEEP,chara3,1）;
@res_lrchara（avgFiles/chara/img.res,NULL,KEEP,1）;
17.5小贴士：
左右两个立绘可以读取不同的资源包。
18.@fadein@fadeout
18.1功能：
屏幕亮度控制的淡入、淡出。
可用于对屏幕整屏操作，同时对背景层和立绘层作用。
注：
淡入指的是从黑色、白色显示恢复成正常显示，
淡出指的是变成黑色、白色屏显。
淡出后可以在后台将立绘、背景操作不留痕迹地做好，然后再一起淡入。
淡出后不淡入屏幕上任何操作都是不可见的。
18.2脚本指令原型：
@fadeout（screen,type,time）;
@fadein（screen,type,time）;
18.3参数说明：
1.screen：
屏幕0-上屏1-下屏2-双屏
2.type：
渐变类型0-白色渐变1-黑色渐变
3.time：
渐变时间，1代表半秒，2为一秒依次类推。
18.4例：
@fadeout（0,1,5）;
@fadein（0,2,5）;
19.@flash
19.1功能：
屏幕闪光效果
19.2脚本指令原型：
@flash（screen,type,times,length）;
19.3参数说明：
1.screen：
屏幕0-上屏1-下屏
2.type：
闪光类型0-白色闪光1-黑色闪光
3.times：
闪光次数
4.length：
闪光变化延时，该值越小，闪屏的速度就越快。
推荐值4
19.4例：
@flash（0,0,1,4）;
20.@wave
20.1功能：
画面波浪效果
20.2脚本指令原型：
@wave（time）;
20.3参数说明：
1.time：
时间单位ms
20.4例：
@wave（3000）;
21.@colorEffect
21.1功能：
背景底片效果
21.2脚本指令原型：
@colorEffect（）;
21.3参数说明：
无
21.4例：
@colorEffect（）;
22.@graybg
22.1功能：
背景灰化效果
22.2脚本指令原型：
@graybg（）;
22.3参数说明：
无
22.4例：
@graybg（）;
三.脚本操作类指令
1.@jump
1.1功能：
文本内无条件按行数上下跳转。
1.2脚本指令原型：
@jump（num）
1.3参数说明：
1.num：
跳转行数。
正数为向下跳转，负数为向上跳转，
0为死循环，不要使用。
1.4例：
@jump（18）;
@jump（-18）;
2.@if@endif
2.1功能：
条件执行体。
符合条件，则执行体内指令，一个@if对应一个@endif。
体内可以支持条件执行体嵌套（也就是再写一层条件执行体）。
2.2脚本指令原型：
@if（condition）
Body
@endif（）
2.3参数说明：
1.condition：
执行条件，支持判断类型：
==（相等）,>（大于）,<（小于）,>=（大于等于）,<=（小于等于）,!
=（不等于）；左操作数必须为变量，右操作数支持变量；
要注意的是每个执行体只支持一次逻辑判断。
2.4例：
1.@if（$（var）==100）;
……………
@endif（）;
2.@if（$（var1）==$（var2））;
……………
@endif（）;
3.@call
3.1功能：
带返回的脚本文件跳转。
目标脚本执行完毕后返回原脚本文件继续执行
3.2脚本指令原型：
@call（path）
3.3参数说明：
1.path：
脚本文件路径
3.4例：
@call（avgFiles/data/test1.spt）;
4.@changeText
4.1功能：
不带返回的脚本文件跳转。
直接更换脚本文件
4.2脚本指令原型：
@changeText（path）
4.3参数说明：
1.path：
脚本文件路径
4.4例：
@changeText（avgFiles/data/test1.spt）;
5.@gameOver
5.1功能：
游戏结束，游戏重新初始化
5.2脚本指令原型：
@gameOver（）
5.3参数说明：
无
5.4例：
@gameOver（）;
6.=
6.1功能：
文本结束标志，此标志前不加@，注意如带返回的脚本文件，末尾一定加上此结束标志。
6.2脚本指令原型：
=
6.3参数说明：
无
6.4例：
=;
7.@select
7.1功能：
出现按钮进行选择，执行相应操作。
7.2脚本指令原型：
@select#1button_text1$value1$@ins1@ins2@ins3~text1~#2$$@@@~~#3$1$@@@~~;
说明：
该指令设定较为复杂，设定为3个选择项。
每个选择项格式为#numbutton_text$value$@instruction1@instruction2@instruction3~text~，#号后数字为选项号，顺序固定为1-2-3，不可改动。
每个选项最大支持3条执行指令，判断后相应顺序执行。
7.3参数说明：
1.button_text：
按钮文字
2.value：
选项对应值，该功能预留，填该值无实际意义，所以每次写0即可
3.instruction：
脚本指令名。
4.text：
选择后显示在对话文本框中文字。
如不需要显示后续内容则不填写
7.4例：
升级会员 