Skip to content

V
Vgdpro Scripts
Commit 0a8cef49 authored by I-linmeng-I's avatar I-linmeng-I Committed by GitHub
Browse files
Options

Update README.md

parent e164f5ae
Hide whitespace changes
Inline Side-by-side
Showing with 26 additions and 122 deletions
README.md
View file @ 0a8cef49
# vgdpro-scripts写卡说明 # vgdpro的卡片脚本编写文档
* 调用库： 本游戏的脚本基于lua。使用自定义库：`VgD.lua`,`VgDefinition.Lua`,`VgFuncLib.lua`来涵括大部分需要的内容。
大家写脚本基本只需要一些基础的逻辑整理和调用对应的库就能完成编写。以下是一些最基础的教程
* VgD.Lua（完整效果的封装，适用于正常进行vg游戏对局的基础效果库） 如果还有不懂可以加群：721095458
## 默认白板卡片脚本（即默认脚本）
* VgFuncLib.lua（散装效果的封装，因vg的效果、费用具有高重复度，适用于vg卡片效果的快捷调用）
```lua
* VgDefinition.Lua（适用于与内核对接，遗留大量的ygopro原版注释）
* 函数写在哪？
* [[
local cm,m,o=GetID() local cm,m,o=GetID()
function cm.initial_effect(c) function cm.initial_effect(c)--这个函数下面用于注册效果
vgf.VgCard(c)
vgf.VgCard(c) --在这之后插入自定义函数或者代码块
cm.sample(x)
xxx.function(x)
end end
* ]] --可以在这之后自定义函数来调用（函数必须是cm.函数名）
function cm.sample(x)
* cm.initial_effect函数下用于注册效果 --代码
end
* 可以在所需位置填写匿名函数 ```
## 关于vgd的效果分类
* 或在此函数后写所需函数 vg常见的效果类型
- **【起】启动效果**
* 调用函数 - 这就是最基本的手动开启的效果（类似游戏王里的茉莉②效果那样的主动效果）
- **【自】诱发效果**
* 写在前面 - 有费用的自能力为诱发选发效果而无费用的为诱发必发效果（类似游戏王里xxx的效果）
- **【永】永续效果**
* vg的效果类型 - 类似于游戏王里肿头龙的持续类效果
- **以及指令能力**
* 【起】启动效果 - 等价于游戏王中的魔法卡的发动
* 【自】诱发效果（有费用的自能力为诱发选发效果而无费用的为诱发必发效果）
* 【永】永续效果
* 以及指令能力（等价于游戏王中的魔法卡的发动）
* vg的效果是允许空发的，所以vgdpro的脚本大多不需要为效果注册Target函数（效果的预处理对象函数）
* VgD库
* VgD.SpellActivate(c,m,执行函数,条件函数,特殊的费用标识（填写卡号否则为0，适用于存在对于一下参数均适用的费用）,将手牌中的x张卡舍弃,能量爆发x,灵魂爆发x,灵魂填充x,计数爆发x)
————因为魔合成的不向下兼容而生的函数，用于通常指令的注册，对于后5个参数均填写对应数量，如果没有可以填写“nil（无）”、“false（错误）”、“0”，推荐优先填写“0”。
* VgD.BeRidedByCard(c,m,卡号（被指定卡RIDE的情况下填写对应卡号否则填0）,执行函数,费用函数,条件函数,效果的预处理对象函数)
————用于效果“这个单位被RIDE时，xxxx”的注册
* VgD.EffectTypeTrigger(c,m,发动的区域（vg的描述中会在效果类型后描述这个效果在哪些区域适用）,自身状态变化触发/场上所以卡状态变化触发 *下见①,对应的时点,执行函数,费用函数,条件函数,效果的预处理对象函数,效果的次数限制,效果的性质 *下见②)
* VgD.EffectTypeIgnition(c,m,发动的区域,执行函数,费用函数,条件函数,效果的预处理对象函数,效果的次数限制,效果的性质 *下见②)
* VgFunction库
* VgF.VgCard(c)
————VgD库内的函数装封，每张可入卡组的卡必须注册
* VgF.Stringid(卡号,行数)
————挂钩于cdb中对应卡号的卡右下角脚本提示文字第(参数二+1)行
* VgF.AddCodeList(c,... *下见③)
————原本ygopro用于添加卡名记述，在vgdpro用于某些指定卡名的效果（比如【超限舞装】的指定卡名）
* VgF.VMonsterFilter(Card c)/VgF.VMonsterCondition(e) VgF.RMonsterFilter(Card c)/VgF.RMonsterCondition(e)
————前者“V”为先导者的判断，后者“R”为后防者的判断,"Condition"为适用于“这张卡在V位/R位”的condition函数（条件函数）的装封，“Filter”为直接对参数Card c进行判断的装封
* VgF.LvCondition(e)
————用于条件函数，因为vg的某些效果的发动需要先导者的等级>=这张卡本身的等级，所以在前端库中封装此函数，用于直接判断
* VgF.IsSequence(Card c,... *下见③)
————等价于c:GetSequence()==（参数数值），用于判断Card c的位置序号（前列为0、4、5，前列为1、2、3）
* VgF.IsLevel(Card c,... *下见③)
————因为vg存在等级0，而实际上等级0的卡vgdpro以原本的“level 1”来储存，所以在前端库中封装此函数，用于直接判断
* VgF.DisCardCost(数量) VgF.EnegyCost(数量) VgF.OverlayCost(数量) VgF.OverlayFillCostOrOperation(数量) VgF.DamageCost(数量)
————除灵魂填充外均用于费用函数，依次为：将手牌中的x张卡舍弃/能量爆发x/灵魂爆发x/灵魂填充x/计数爆发x，参数为其数量
* VgF.SearchCard(区域,检测函数) VgF.SearchCardSpecialSummon(区域,检测函数)
————均用于执行函数，前者为从“区域”把符合“检测函数”的卡加入手卡，后者为从“区域”把符合“检测函数”的卡Call到R位圆阵
* VgF.AtkUp(c,Group g/Card c,上升数值,重置条件)/VgF.StarUp(c,Group g/Card c,上升数值,重置条件)
————用于上升Group g或Card c的攻击力/暴击值，重置条件默认为直到回合结束，如果只需要到卡离场时重置则填0
* 实战
* 案例：【起】【R】：通过【费用】[灵魂爆发2]，这个回合中，这个单位的力量+5000。
* [[
local cm,m,o=GetID()
function cm.initial_effect(c)
vgf.VgCard(c)
--在这个地方注册一个起动效果
vgd.EffectTypeIgnition(c,m,LOCATION_MZONE --[[怪兽区域的效果]] ,cm.operation --[[对下文同名函数调用]] ,vgf.OverlayCost(2) --[[调用VgFunction库中[灵魂爆发]的封装函数]] ,vgf.RMonsterCondition --[[检测这张卡在R位]] ,tg,count,property --[[往后的参数都没了，可以直接不填，也可以填写“nil（无）”、“false（错误）”或原本参数名“tg”、“count”、“property”]] )
end
function cm.operation(e,tp,eg,ep,ev,re,r,rp) --[[8位参数由内核固定传入，费用函数会多传1位“chk”]]
local c=e:GetHandler() --[[得到卡片自身]]
vgf.AtkUp(c,c,5000) --[[调用函数上升自身攻击力]]
end
* ]]
* 注释
①：填写“EFFECT_TYPE_SINGLE（自身状态变化触发）”或者“EFFECT_TYPE_FIELD（场上所以卡状态变化触发）”，不需要填写诱发选发/诱发必发，库里已经写好了。
②：效果的性质内容较为特殊，可能不需要填写
③：从这个参数开始可以填写任意数量（至少1个）的参数
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment