模式文档初版
This commit is contained in:
MrZ626
144
document/mode.txt
Normal file
144
document/mode.txt
Normal file
@@ -0,0 +1,144 @@
|
||||
一个正确的模式文件应是一个合法lua程序，其必须立刻返回一个table，里面的内容包括：
|
||||
color:模式的颜色，用于点击地图图标后显示的提示文本
|
||||
env:
|
||||
必选
|
||||
模式环境变量，决定了关卡的各项属性
|
||||
table值:
|
||||
drop:下落延迟(帧，支持自然数和2的整数次幂)
|
||||
lock:锁定延迟(帧)
|
||||
wait:出块延迟(帧)
|
||||
fall:下落延迟(帧)
|
||||
bone:是否开启骨块模式
|
||||
nextCount:显示next个数
|
||||
nextStartPos:next从第几个开始显示
|
||||
holdCount:hold个数,
|
||||
infHold:是否能无限hold
|
||||
ospin=是否能O-spin
|
||||
RS:旋转系统名
|
||||
|
||||
das:DAS
|
||||
arr:ARR
|
||||
sddas:软降DAS
|
||||
sdarr:软降ARR
|
||||
mindas:允许的最小DAS
|
||||
minarr:允许的最小ARR
|
||||
minsdarr:允许的最小软降ARR
|
||||
ihs:提前Hold
|
||||
irs:提前旋转
|
||||
ims:提前移动
|
||||
maxNext:最大next数
|
||||
|
||||
skin:方块颜色,包含25个整数(1~16)的table
|
||||
face:方块朝向,包含25个整数(0~3)的table
|
||||
|
||||
block:是否显示方块
|
||||
ghost:影子透明度(0~1)
|
||||
center:旋转中心透明度(0~1)
|
||||
smooth:是否平滑下落
|
||||
grid:是否显示网格
|
||||
bagLine:是否显示包分界线
|
||||
lockFX:特效等级(0,5)
|
||||
dropFX:特效等级(0,5)
|
||||
moveFX:特效等级(0,5)
|
||||
clearFX:特效等级(0,5)
|
||||
splashFX:特效等级(0,5)
|
||||
shakeFX:特效等级(0,5)
|
||||
atkFX:特效等级(0,5)
|
||||
|
||||
text:是否显示消行文本
|
||||
score:是否显示落块分数
|
||||
warn:是否开启死亡预警
|
||||
highCam:是否开启超屏视野
|
||||
nextPos:是否开启生成预览
|
||||
|
||||
sequence:序列模式，可以使用默认的几个函数用字符串表示，也可以自己写
|
||||
freshMethod=放一块后对next序列的刷新函数，不使用默认sequence的话就要自己写
|
||||
bag:一包的方块(本质是基准序列,不一定是包)
|
||||
mission:包含任务的table,说明暂时略
|
||||
|
||||
life:生命数,
|
||||
pushSpeed:上涨速度
|
||||
noTele:是否禁止10个高级按键,
|
||||
visible:方块可见性，填写固定的几个字符串
|
||||
freshLimit:锁延刷新次数限制
|
||||
easyFresh:是否使用简单锁延刷新规则
|
||||
|
||||
Fkey:按下功能键后执行的函数
|
||||
keyCancel:包含禁止使用的按键的id们的table
|
||||
fineKill:是否开启非极简即死
|
||||
b2bKill:是否开启断b2b即死
|
||||
missionKill:是否开启强制任务
|
||||
target:目标行数，如果dropPiece使用了默认的几个通用通关函数或者自己有一个目标数字就要写
|
||||
dropPiece:放一块后要执行的函数，输入玩家对象
|
||||
|
||||
bg:背景，只能填写默认背景的名字
|
||||
bgm:背景音乐，只能填写默认音乐库的音乐名
|
||||
noMod:是否禁用玩家开启mod
|
||||
load:
|
||||
必选
|
||||
模式初始化函数，一般创建一个玩家即可
|
||||
无输入和输出
|
||||
mesDisp:
|
||||
必选
|
||||
模式显示信息，是一个绘图函数，坐标系原点是玩家对象最左上角
|
||||
输入玩家对象
|
||||
无输出
|
||||
|
||||
score:
|
||||
可选（不填就没有分数保存和计算）
|
||||
一局打完后要存储的数据
|
||||
输入玩家对象
|
||||
输出游戏结束瞬间返回一个包含直接决定该模式成绩的数据table（会被强制加上date标签）
|
||||
|
||||
scoreDisp:
|
||||
可选（当模式不出现在地图上的时候）
|
||||
是把score()存起来的table转换为字符串显示出来的函数
|
||||
输入一个成绩table
|
||||
输出一个字符串
|
||||
|
||||
comp:
|
||||
可选（当没有score函数的时候）
|
||||
是成绩table之间对比并排序的规则
|
||||
输入两个成绩table
|
||||
输出[第一个是不是排在第二个前面]的布尔值(可以类比"小于"运算)
|
||||
|
||||
getRank:
|
||||
可选，模式评级函数
|
||||
是用于评价玩家表现的函数
|
||||
输入玩家对象
|
||||
返回0~5，0表示除了记录到排行榜外什么都不做；1/2/3/4/5表示D/C/B/A/S级，能解锁连接的模式，还会让模式图标在地图上显示不同的颜色
|
||||
|
||||
以下是40行的模式文件内容:
|
||||
//sprint_40.lua
|
||||
return{--返回一个table，你也可以在之前定义一些常量或者函数什么的
|
||||
color=COLOR.green,--颜色
|
||||
env={--模式环境变量
|
||||
drop=60,lock=60,
|
||||
target=40,dropPiece=PLY.check_lineReach,
|
||||
bg="bg2",bgm="race",
|
||||
},
|
||||
load=function()--生成玩家
|
||||
PLY.newPlayer(1,340,15)
|
||||
end,
|
||||
mesDisp=function(P)--40行模式需要显示的信息
|
||||
setFont(55)
|
||||
local r=40-P.stat.row
|
||||
if r<0 then r=0 end
|
||||
mStr(r,69,335)--把计算出来的剩余行数r显示出来
|
||||
PLY.draw.drawTargetLine(P,r)--使用自带的境界高度线绘制函数
|
||||
end,
|
||||
score=function(P)return{P.stat.time,P.stat.piece}end,--游戏结束时需要保存的本局关键信息
|
||||
scoreDisp=function(D)return toTime(D[1]).." "..D[2].." Pieces"end,--把score返回的数据显示出来的方法
|
||||
comp=function(a,b)return a[1]<b[1]or a[1]==b[1]and a[2]<b[2]end,--按照时间排序，时间一样就看块数
|
||||
getRank=function(P)--计算评级
|
||||
if P.stat.row<40 then return end--你总得打完40行对吧，否则直接return空掉，成绩都不记录
|
||||
local T=P.stat.time
|
||||
return
|
||||
T<=26 and 5 or--时间小于等于26秒，S级要求，至于为什么是26秒不解释
|
||||
T<=32.6 and 4 or--A级要求
|
||||
T<=52.6 and 3 or--B级要求
|
||||
T<=92.9 and 2 or--C级要求
|
||||
T<=183 and 1 or--D级要求，是解锁别的模式的最低标准
|
||||
0--打完了40行那成绩就给你记一下
|
||||
end,
|
||||
}
|
||||
Reference in New Issue
Block a user