ygopro：卡片腳本製作（基礎篇）

以下是如何製作卡片腳本的一些基礎教學。

ygopro的卡片腳本是用Lua撰寫，目前採用Lua5.3，會用到的特性大致上有：

由於乘除的優先順序高於加減，實數的四則運算有「先乘除後加減」的規則。

例如：

2+5*4 = 2+20 = 22

Lua的and和or也有類似的特性，也就是說：

A or B and C

會先計算(B and C)再計算A or (B and C)。

邏輯運算時如果已經能夠算出結果，就不會繼續計算後半段的語句 。

例如：

A or B and C

如果A為true，or的性質是其中一邊為true就可以確定整句是true，因此計算到此結束，程式會直接跳過B和C寫的內容。

 

Lua的真假值定義為：

假：false、nil

真：其餘語句都是真

和C/C++系列的語言最大的差異在於0為真，在邏輯運算時要特別注意。

 

+, -, *, /：四則運算

<, >, <=, >=：小於、大於、小於等於、大於等於

==, ~=：邏輯運算的等於、不等於

not, and, or：邏輯運算not、and、or

~, &, |：位元運算not、and、or

true, false：代表邏輯真假值的常數

nil：NULL，通常代表空值

=：指定運算子，和邏輯運算的==不同

--：註解，這列會被當作一般文字而非程式碼

以下用「影依の巫女 エリアル」為例：

function c97518132.initial_effect(c)
    --flip
    local e1=Effect.CreateEffect(c)
    e1:SetDescription(aux.Stringid(97518132,0))
    e1:SetCategory(CATEGORY_SPECIAL_SUMMON)
    e1:SetType(EFFECT_TYPE_SINGLE+EFFECT_TYPE_FLIP+EFFECT_TYPE_TRIGGER_O)
    e1:SetProperty(EFFECT_FLAG_CARD_TARGET+EFFECT_FLAG_DELAY)
    e1:SetCountLimit(1,97518132)
    e1:SetTarget(c97518132.target)
    e1:SetOperation(c97518132.operation)
    c:RegisterEffect(e1)
    --remove
    local e2=Effect.CreateEffect(c)
    e2:SetDescription(aux.Stringid(97518132,1))
    e2:SetCategory(CATEGORY_REMOVE)
    e2:SetType(EFFECT_TYPE_SINGLE+EFFECT_TYPE_TRIGGER_O)
    e2:SetProperty(EFFECT_FLAG_CARD_TARGET+EFFECT_FLAG_DELAY)
    e2:SetCode(EVENT_TO_GRAVE)
    e2:SetCountLimit(1,97518132)
    e2:SetCondition(c97518132.rmcon)
    e2:SetTarget(c97518132.rmtg)
    e2:SetOperation(c97518132.rmop)
    c:RegisterEffect(e2)
end

function c97518132.initial_effect(c)
end

腳本開頭的函數，定義這張卡有哪些效果，c後面的數字為卡片的id。
實體卡的id都位於10000~99999999這個範圍，自創卡片請盡可能避開這個範圍以免混淆。

 

local e1=Effect.CreateEffect(c)

宣告第一個效果e1。

 

SetDescription(aux.Stringid(97518132,0))

設定e1的提示文字，用於效果發動時的選單。

aux.Stringid(97518132,0)

卡片資料庫中97518132的第一個字串（str1為序號0）。

e1:SetCategory(CATEGORY_SPECIAL_SUMMON)

標記這是「包含～的效果」。
完整定義請參考constant.lua的Category。

Ex.

灰流麗可以對應的效果：
CATEGORY_DECKDES, CATEGORY_DRAW, CATEGORY_SEARCH。

 

SetType()

設定效果類別，定義如下：

EFFECT_TYPE_IGNITION

SetCode()：無。

SetRange()：發動的位置。

 

反轉怪獸在反轉時發動的效果。

SetCode()：無。

SetRange()：無。

選發：
EFFECT_TYPE_SINGLE+EFFECT_TYPE_FLIP+EFFECT_TYPE_TRIGGER_O

必發：
EFFECT_TYPE_SINGLE+EFFECT_TYPE_FLIP+EFFECT_TYPE_TRIGGER_F

 

SetCode()：觸發效果的事件，定義請參考constant.lua。

類別分成X+Y兩個部分：

X：EFFECT_TYPE_SINGLE、EFFECT_TYPE_FIELD

EFFECT_TYPE_SINGLE：

發動條件為「此卡～」 。

SetRange()：無。

EFFECT_TYPE_FIELD：

發動條件為「任何卡～」 。

SetRange()：發動的位置。

以e2為例：

e2:SetType(EFFECT_TYPE_SINGLE+EFFECT_TYPE_TRIGGER_O)
e2:SetCode(EVENT_TO_GRAVE)

EFFECT_TYPE_SINGLE, EVENT_TO_GRAVE

此卡送去墓地

EFFECT_TYPE_FIELD, EVENT_TO_GRAVE

任何卡送去墓地

Y： EFFECT_TYPE_TRIGGER_O、EFFECT_TYPE_TRIGGER_F

決定這是選發還是必發，前者為選發，後者為必發。
選發還可以再分成「時」、「場合」兩種。

時：預設為時。

場合：在SetProperty()加入EFFECT_FLAG_DELAY。

EFFECT_TYPE_QUICK_O、EFFECT_TYPE_QUICK_F

分別為選發以及必發的誘發即時效果。

SetCode()：發動時機，任何時機都能發動為EVENT_FREE_CHAIN。

SetRange()：發動的位置。

 

通常是只有改變卡片的數值或狀態的效果。

SetCode()：效果的內容。

類別依照作用範圍分成EFFECT_TYPE_SINGLE、EFFECT_TYPE_FIELD。

只影響自己：

EFFECT_TYPE_SINGLE，SetProperty()加入EFFECT_FLAG_SINGLE_RANGE。

SetRange()：效果生效的位置。

SetTargetRange()：無。

影響其他卡：

EFFECT_TYPE_FIELD

SetRange()：效果生效的位置。

SetTargetRange(A, B)：影響的區域，A為控制者，B為控制者的對手。

 

改變攻擊力、守備力的效果有更複雜的規則，請先參考規則專欄：計算攻擊力與守備力確認遊戲王計算攻守的完整規則再設定。

 

X+EFFECT_TYPE_CONTINUOUS

某些永續效果會移動卡片或改變玩家狀態，類似不排連鎖直接適用的必發誘發效果。

X：EFFECT_TYPE_SINGLE、EFFECT_TYPE_FIELD

其餘定義與誘發效果相同。

EFFECT_TYPE_ACTIVATE

SetCode()：發動時機，任何時機都能發動為EVENT_FREE_CHAIN。

SetRange()：無。

 

魔法卡：

魔法卡（包含速攻魔法）在墓地發動的效果都是速度1，因此類別為EFFECT_TYPE_IGNITION。

SetCode()：無。

SetRange()：發動的位置。

 

陷阱卡：

陷阱卡在墓地發動的效果都是速度2，因此類別為EFFECT_TYPE_QUICK_O。

SetCode()：EVENT_FREE_CHAIN。

SetRange()：發動的位置。

 

比照怪獸的誘發效果。

 

比照怪獸的一般永續效果。

 

(5) 裝備卡的效果

裝備卡裝備時的效果，類別為EFFECT_TYPE_EQUIP。

SetCode()：效果的內容。

SetRange()：無。

 

 

SetProperty()

設定效果的特性，完整定義請參考constant.lua。

常用特性：

EFFECT_FLAG_CARD_TARGET：指定對象的效果

EFFECT_FLAG_BOTH_SIDE：雙方都能發動的效果

EFFECT_FLAG_DAMAGE_STEP：可以在傷害步驟發動，要檢查aux.dscon()

EFFECT_FLAG_DAMAGE_CAL：可以在傷害計算時發動

EFFECT_FLAG_DELAY：場合型選發

EFFECT_FLAG_PLAYER_TARGET：以玩家為對象，精靈之鏡會用到

 

SetCondition()

指定Condition函數，判斷效果發動條件的函數。

 

SetCost()

指定Cost函數，效果支付代價時執行這個函數。

SetTarget()

指定Target函數，檢查以及選取效果的目標時執行這個函數。

SetOperation()

指定Operation函數，效果處理時執行這個函數。

 

SetValue()

指定Value函數，可以指定數值（固定）或是函數（隨時變化）。
這是永續型效果使用的數值。

c:RegisterEffect(e1)

e1定義完畢之後，讓卡片c裝上效果e1。