1. 事前に済ませてね

2. テンプレートを作成する

3. 神器の基本情報の設定

#> asset:artifact/<神器名>/give/2.give
#
# 神器の作成部 ここでID等を定義する
#
# @user
# @within function asset:artifact/<神器名>/give/1.trigger
# 神器の説明や消費MPなどをここで設定する。
# 最後にasset:artifact/common/giveを実行することで入手可能。
# 神器のID (int) スプレッドシートの値を入れる
 data modify storage asset:artifact ID set value <神器ID>
# 神器のベースアイテム
 data modify storage asset:artifact Item set value 
# 神器の名前 (TextComponentString)
 data modify storage asset:artifact Name set value 
# 神器の説明文 (TextComponentString[])
 data modify storage asset:artifact Lore set value []
# 消費アイテム ({Item: TextComponent, Count: int, Extra?: TextComponent}) (オプション)
 # data modify storage asset:artifact ConsumeItem.Item set value '{"translate":"item.minecraft.stick"}'
 # data modify storage asset:artifact ConsumeItem.Count set value 1
 # data modify storage asset:artifact ConsumeItem.Extra set value 
# 使用回数 (int) (オプション)
 # data modify storage asset:artifact RemainingCount set value 
# 神器を発動できるスロット (string) Wikiを参照
 data modify storage asset:artifact Slot set value "<slot>"
# 神器のトリガー (string) Wikiを参照
 data modify storage asset:artifact Trigger set value 
# 神器の発動条件 (TextComponentString) (オプション)
 # data modify storage asset:artifact Condition set value 
# 攻撃に関する情報 -Damage量 (literal[]/literal) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.Damage set value [0,0]
# 攻撃に関する情報 -攻撃タイプ (string[]) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.AttackType set value [Physical,Magic]
# 攻撃に関する情報 -攻撃属性 (string[]) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.ElementType set value [Fire,Water,Thunder,None]
# 攻撃に関する情報 -防御無視 (boolean) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.BypassResist set value 
# 攻撃に関する情報 -範囲攻撃 (string) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.IsRangeAttack set value 
# 攻撃に関する情報 -攻撃範囲 (literal) Wikiを参照 (オプション)
 # data modify storage asset:artifact AttackInfo.AttackRange set value 
# MP消費量 (int) 
 # data modify storage asset:artifact MPCost set value 
# MP必要量 (int) (オプション)
 # data modify storage asset:artifact MPRequire set value 
# MP回復量 (int) 
 # data modify storage asset:artifact MPHealWhenHit set value 
# 神器のクールダウン (int) (オプション)
 # data modify storage asset:artifact LocalCooldown set value 
# 種別クールダウン ({Type: string, Duration: int}) (オプション)
 # data modify storage asset:artifact TypeCooldown.Type set value 
 # data modify storage asset:artifact TypeCooldown.Duration set value
# グローバルクールダウン (int) (オプション)
 # data modify storage asset:artifact SpecialCooldown set value 
# 扱える神 (string[]) Wikiを参照
 data modify storage asset:artifact CanUsedGod set value []
# カスタムNBT (NBTCompound) 追加で指定したいNBT (オプション)
 # data modify storage asset:artifact CustomNBT set value {}
# 神器の入手用function
 function asset:artifact/common/give

SlotID について

slot: auto について

トリガーのリスト

信仰のリスト

消費アイテムに関する説明の形式

攻撃情報の書式

data modify storage asset:artifact AttackInfo.Damage set value 100.0
data modify storage asset:artifact AttackInfo.AttackType set value [Magic]
data modify storage asset:artifact AttackInfo.ElementType set value [Fire]
data modify storage asset:artifact AttackInfo.BypassResist set value 0b

data modify storage asset:artifact AttackInfo.Damage set value [12.31,31.27]
data modify storage asset:artifact AttackInfo.AttackType set value [Magic]
data modify storage asset:artifact AttackInfo.ElementType set value [Fire,Water]
data modify storage asset:artifact AttackInfo.BypassResist set value 1b

data modify storage asset:artifact AttackInfo.Damage set value ["5","∞"]
data modify storage asset:artifact AttackInfo.AttackType set value [Physical]
data modify storage asset:artifact AttackInfo.ElementType set value [Fire,Thunder]
data modify storage asset:artifact AttackInfo.BypassResist set value 1b

CoolDown の種類

AttributeModifiers の UUID の形式

Equipment.Effects / Equipment.Modifiers (装備時効果)

Equipment.Effects

data modify storage asset:artifact Equipment.Effects set value [{ID:233,Visible:true,IsSetEffect:true}]

Equipment.Modifiers

data modify storage asset:artifact Equipment.Modifiers set value []
data modify storage asset:artifact Equipment.Modifiers append value {Type:"attack/thunder",Amount:0.01d,Operation:"multiply_base"}
data modify storage asset:artifact Equipment.Modifiers append value {Type:"defense/thunder",Amount:0.02d,Operation:"multiply_base"}

DisabledFlag (各種チェックの無効化)

data modify storage asset:artifact DisabledFlag set value {Check:{Believe:true,BelieveMessage:true},Use:{ItemUpdate:true}}

Check 側 (DisabledFlag.Check)

Use 側 (DisabledFlag.Use)

よくある使い方

4. 神器の処理の記述

4.1. トリガーのイベントを受け取る

#> asset:artifact/<神器名>/trigger/1.trigger
#
# 指定したイベントタイミングで実行されるfunction
#
# @within tag/function asset:artifact/**
# storage asset:contextの<slot>に装備している神器のIDが入っているので比較し、~/2.check_condition.mcfunctionを実行する
 execute if data storage asset:context id{<slot>:<神器ID>} run function asset:artifact/<神器名>/trigger/2.check_condition

手動編集が必要になるケース

4.2. 発動条件をチェックする

#> asset:artifact/<神器名>/trigger/2.check_condition
#
# 神器の発動条件をチェックします
#
# @within function asset:artifact/<神器名>/trigger/1.trigger
# 神器の基本的な条件の確認を行うfunction、成功している場合CanUsedタグが付く
 function asset:artifact/common/check_condition/<slot>
# 他にアイテム等確認する場合はここに書く
 
# CanUsedタグをチェックして3.main.mcfunctionを実行する
 execute if entity @s[tag=CanUsed] run function asset:artifact/<神器名>/trigger/3.main

自動チェックの流れ

追加のチェックを書きたい時

# 基本チェック (信仰・CD・MP)
 function asset:artifact/common/check_condition/mainhand
# 追加チェック: 雨が降ってないなら CanUsed をはがす
 execute if entity @s[tag=CanUsed] unless predicate lib:weather/is_raining run tag @s remove CanUsed
# CanUsedが残っていれば3.mainへ
 execute if entity @s[tag=CanUsed] run function asset:artifact/<神器名>/trigger/3.main

自動チェックを部分的にスキップしたい時

# このトリガーに限り信仰チェックだけスキップしたい
 data modify storage asset:artifact DisabledCheckFlag set value {Believe:true}
 function asset:artifact/common/check_condition/mainhand

4.3. 神器の効果を作る

#> asset:artifact/<神器名>/trigger/3.main
#
# 神器のメイン処理部
#
# @within function asset:artifact/<神器名>/trigger/2.check_condition
# 基本的な使用時の処理(MP消費や使用回数の処理など)を行う
 function asset:artifact/common/use/<slot>
# ここから先は神器側の効果の処理を書く
 say test: <神器名>

common/use/<slot>がやってくれること

制作者が書くのは「ここから下」

重要な注意点

5. 基本的な情報

tick をまたぐ処理の実装の仕方

#> asset:artifact/example/trigger/3.main
#
# 神器のメイン処理部
#
# @within function asset:artifact/example/trigger/2.check_condition
# 基本的な使用時の処理(MP消費や使用回数の処理など)を行う
 function asset:artifact/common/use/auto
# ここから先は神器側の効果の処理を書く
 summon falling_block ~ ~ ~ {Tags:["example"],BlockState:{Name:"minecraft:smoker",Properties:{lit:"true"}},Time:1}
# 煙を吐く
 function asset:artifact/example/trigger/3.1.smoke

#> asset:artifact/example/trigger/3.1.smoke
#
# 煙を吐く
#
# @within function
# asset:artifact/example/trigger/3.main
# asset:artifact/example/trigger/3.1.smoke
# 喫煙者から煙を吐く
 execute as @e[type=falling_block,tag=example] at @s run particle smoke ~ ~ ~ 1 1 1 0.5 50
# 次tickの予約 //limit=1を付けることでif entityは軽量化が可能
 execute if entity @e[type=falling_block,tag=example,limit=1] run schedule function asset:artifact/example/trigger/3.1.smoke 1t

storage: asset:contextに入っている情報

全トリガー共通

asset:context
├ id
│ ├ auto : int | null
│ ├ mainhand : int | null
│ ├ offhand : int | null
│ ├ head : int | null
│ ├ chest : int | null
│ ├ legs : int | null
│ ├ feet : int | null
│ └ all (trigger equip/dis_equip限定)
│ ├ auto : int | null
│ ├ mainhand : int | null
│ ├ offhand : int | null
│ ├ head : int | null
│ ├ chest : int | null
│ ├ legs : int | null
│ └ feet : int | null
│
├ Items
│ ├ AutoSlot : string('mainhand' | 'offhand' | 'head' | 'chest' | 'legs' | 'feet') | null
│ ├ mainhand : Item | null
│ ├ offhand : Item | null
│ ├ head : Item | null
│ ├ chest : Item | null
│ ├ legs : Item | null
│ └ feet : Item | null
│
└ Inventory : Readonly Item[]

トリガー別の追加情報

attack/* トリガー

asset:context Attack : {
 From : int | null, # 攻撃者の MobUUID (プレイヤーの時は null)
 To : int[], # 攻撃対象の MobUUID 配列
 Amounts : double[], # 各対象に与えるダメージ
 Amount : double, # Amountsの最大値 (foreachで自動計算される)
 Type : string, # "vanilla_melee" / "vanilla_projectile" / "vanilla_explosion"
 IsDoT : boolean # 継続ダメージ判定 (詳細は IsDoT / IsHoT のルール節参照)
}

damage/* トリガー

asset:context Damage : {
 From : int | null, # 攻撃元の MobUUID (奈落・落下等は null)
 Type : string, # "vanilla_melee" / "vanilla_drowning" / "vanilla_projectile"
 # "vanilla_explosion" / "vanilla_fire" / "vanilla_freezing"
 # "vanilla_lightning" / "vanilla_other"
 Amount : double, # 受けたダメージ量
 Blocked : boolean, # シールド等でブロックしたか
 IsDoT : boolean
}

heal トリガー

asset:context Heal : {
 From : int, # 回復元のUserID
 To : int[], # 回復対象のUserID配列
 Amounts : double[],
 Amount : double, # Amountsの最大値
 IsHoT : boolean
}

receive_heal トリガー

asset:context ReceiveHeal : {
 From : int | null, # 回復元のUserID (環境効果等はnull)
 Amount : double,
 IsHoT : boolean
}

killed/* トリガー

asset:context Killed : {
 Target : Entity関連の情報 (詳細は実装側で参照)
}

shot トリガー

asset:context Shot : {
 Arrow : Entity関連の情報
}

テスト方法

対象に〜する

いろいろ作りたくない! core になんかないの?

6. 装備系神器・フルセット防具の作り方

6.1. 単発の装備神器

例: 雷の腕輪 (head 装備、雷属性攻防+1%)

# 神器のID
 data modify storage asset:artifact ID set value 632
# 元アイテム
 data modify storage asset:artifact Item set value "minecraft:leather_helmet"
# 名前
 data modify storage asset:artifact Name set value '{"text":"雷の腕輪","color":"yellow"}'
# Lore
 data modify storage asset:artifact Lore set value []
# スロット & トリガー
 data modify storage asset:artifact Slot set value "head"
 data modify storage asset:artifact Trigger set value "equipping"
# MP (装備時のコストは0でOK)
 data modify storage asset:artifact MPCost set value 0
# 装備時効果 (EffectAssetを付与)
 data modify storage asset:artifact Equipment.Effects set value [{ID:235,Visible:true,IsSetEffect:false}]
# 装備時補正 (与雷ダメージ+1%、被雷ダメージ-2%)
 data modify storage asset:artifact Equipment.Modifiers set value []
 data modify storage asset:artifact Equipment.Modifiers append value {Type:"attack/thunder",Amount:0.01d,Operation:"multiply_base"}
 data modify storage asset:artifact Equipment.Modifiers append value {Type:"defense/thunder",Amount:0.02d,Operation:"multiply_base"}
# 信仰
 data modify storage asset:artifact CanUsedGod set value "ALL"
# 防具系はAttributeModifiersでarmor値も指定する
 data modify storage asset:artifact CustomNBT set value {Unbreakable:1b,AttributeModifiers:[{AttributeName:"generic.armor",Name:"generic.armor",Amount:2,Operation:0,UUID:[I;1,1,632,6],Slot:"head"}]}
 function asset:artifact/common/give

equipping時の 3.main の書き方

#> asset:artifact/0632.elec_helm/trigger/3.main
#
# @within function asset:artifact/0632.elec_helm/trigger/2.check_condition
# 装着SE
 playsound block.beacon.activate player @s ~ ~ ~ 0.5 1.5

6.2. フルセット防具

仕組みの概要

例: フレイムアーマーセット (EffectAsset ID 233 / 神器 624,625,626,627)

4 部位の神器側 (asset:artifact/0624.flame_helm 〜 0627.flame_boots)

# head側 (0624.flame_helm)
 data modify storage asset:artifact Slot set value "head"
 data modify storage asset:artifact Trigger set value "equipping"
 data modify storage asset:artifact Equipment.Effects set value [{ID:233,Visible:true,IsSetEffect:true}]
 data modify storage asset:artifact Equipment.Modifiers set value []
 data modify storage asset:artifact Equipment.Modifiers append value {Type:"defense/fire",Amount:0.075d,Operation:"multiply_base"}
 # ... 4部位とも同じ ID:233 を使う

# chest側 (0625.flame_armor)
 data modify storage asset:artifact Slot set value "chest"
 data modify storage asset:artifact Equipment.Effects set value [{ID:233,Visible:true,IsSetEffect:true}]
 data modify storage asset:artifact Equipment.Modifiers set value []
 data modify storage asset:artifact Equipment.Modifiers append value {Type:"defense/fire",Amount:0.075d,Operation:"multiply_base"}

EffectAsset 側 (asset:effect/0233.flame_armor)

#> asset:effect/0233.flame_armor/register
data modify storage asset:effect ID set value 233
data modify storage asset:effect Name set value '{"text":"フレイムアーマー","color":"red"}'
data modify storage asset:effect Description set value ['{"text":"火属性ダメージカット"}']
data modify storage asset:effect Duration set value -1
data modify storage asset:effect MaxStack set value 4
data modify storage asset:effect IsBadEffect set value false
data modify storage asset:effect RequireClearLv set value 4

EffectAsset のgiven/.mcfunction でフルセット判定

#> asset:effect/0233.flame_armor/given/
# Stack=4 のとき = 4部位全装備済み のときのみフルセット効果発動
 execute if data storage asset:context {Stack:4} run function asset:effect/0233.flame_armor/fullset/equip

re-given/.mcfunction で監視

#> asset:effect/0233.flame_armor/re-given/
 execute if data storage asset:context {Stack:4} run function asset:effect/0233.flame_armor/fullset/equip
 execute unless data storage asset:context {Stack:4} run function asset:effect/0233.flame_armor/fullset/dis_equip

fullset/equip.mcfunction / fullset/dis_equip.mcfunction

#> asset:effect/0233.flame_armor/fullset/equip
# 追加で 火耐性+20% を付与
 data modify storage api: Argument.UUID set value [I;0,233,0,1]
 data modify storage api: Argument.Amount set value 0.2d
 data modify storage api: Argument.Operation set value "multiply_base"
 function api:modifier/defense/fire/add
# 演出
 playsound minecraft:block.fire.ambient player @s ~ ~ ~ 0.5 1.2

#> asset:effect/0233.flame_armor/fullset/dis_equip
# 追加補正の削除
 data modify storage api: Argument.UUID set value [I;0,233,0,1]
 function api:modifier/defense/fire/remove

既存のフルセット実装の例

6.3. Modifier の注意点

Operation の使い分け

フルセット時の重複加算に注意

7. 高度なトピック

7.1. マルチトリガー神器の作り方

大事なこと

例: 渇望の剣 (0292.craving_sword)

ディレクトリ構成

asset/functions/artifact/0292.craving_sword/
 register.mcfunction
 give/
 1.trigger.mcfunction
 2.give.mcfunction # Trigger:"onAttackByMelee" (主、表示用)
 melee/ # 近接攻撃時の処理
 1.trigger.mcfunction # → tags/.../attack/melee.json に登録
 2.check_condition.mcfunction
 3.main.mcfunction # MP消費 + ダメージ加算 + 演出
 kill/ # キル時の処理 (副)
 1.trigger.mcfunction # → tags/.../killed.json に登録
 2.check_condition.mcfunction
 3.main.mcfunction # 副なのでMP/CDは消費しない、 HP回復のみ

副トリガーの1.trigger.mcfunction

#> asset:artifact/0292.craving_sword/kill/1.trigger
#
# @within tag/function asset:artifact/killed
 execute if data storage asset:context id{mainhand:292} run function asset:artifact/0292.craving_sword/kill/2.check_condition

副トリガーの3.main.mcfunction (MP 消費なし ver)

#> asset:artifact/0292.craving_sword/kill/3.main
#
# @within function asset:artifact/0292.craving_sword/kill/2.check_condition
# common/use/<slot> を呼ばない (主側でCD/MP消費済み)
# 演出
 particle minecraft:composter ~ ~1 ~ 0.5 0.5 0.5 1 20 force @s
 playsound minecraft:entity.arrow.hit_player player @s ~ ~ ~ 1 1
# HP回復
 data modify storage api: Argument.Heal set value 5f
 function api:heal/modifier
 function api:heal/
 function api:heal/reset

関数 tag への登録

// data/asset/tags/functions/artifact/attack/melee.json
{
 "values": [
 "asset:artifact/0292.craving_sword/melee/1.trigger"
 ]
}
// data/asset/tags/functions/artifact/killed.json
{
 "values": [
 "asset:artifact/0292.craving_sword/kill/1.trigger"
 ]
}

ディレクトリ名の付け方

7.2. トリガーで使えるタグ (Victim/Attacker/Healer/Receiver)

使い方

#> asset:artifact/<name>/melee/3.main
 function asset:artifact/common/use/mainhand
# 攻撃したEntity (Victimタグ持ち) に追加ダメージ
 execute as @e[tag=Victim,distance=..8] at @s run function <追加ダメージfunction>

#> asset:artifact/<name>/damage/3.main
 function asset:artifact/common/use/<slot>
# 攻撃元 (Attackerタグ持ち) にカウンター
 execute as @e[tag=Attacker,distance=..150] at @s run function <カウンターfunction>

#> asset:artifact/<name>/receive_heal/3.main
# 回復元 (Healerタグ持ち) にお返しのバフ
 execute as @a[tag=Healer] run function <バフ付与function>

注意点

7.3. IsDoT / IsHoT のルール

仕組み

# DoT扱いのダメージを与える側
 data modify storage api: Argument.Damage set value 2.0f
 data modify storage api: Argument.AttackType set value "Magic"
 data modify storage api: Argument.ApplyTrigger set value false # ← これがDoTの宣言
 function api:damage/
 function api:damage/reset

神器側で除外する書き方

#> asset:artifact/<name>/melee/2.check_condition
 function asset:artifact/common/check_condition/mainhand
# 通常チェックは通っても、DoTダメージのときはキャンセル
 execute if entity @s[tag=CanUsed] if data storage asset:context Attack{IsDoT:true} run tag @s remove CanUsed
 execute if entity @s[tag=CanUsed] run function asset:artifact/<name>/melee/3.main

制作者がApplyTrigger:falseを指定する場面

Vanilla ダメージの扱い

8. Q & A

Q. 神器が動かないんだけど:anger:

Q. GitEmoji の使い方わからない><

Q. この音だけ Playsound で鳴らないんだけど?

Q. 情報が足りないんだけど:anger: