common object

汎用演出Objectの召喚例

各例はmcfunction内で使用する。召喚位置・向きはapi:object/summonの実行位置・向きで指定する。

2001 custom_effect

CustomModelDataをフレームごとに切り替えて、アニメーションを表示する。

FramesにCustomModelDataを再生順で指定し、1tickにつき1要素ずつ再生する。同じ値を繰り返すと、そのフレームの表示時間を延ばせる。再生終了後は自動で消滅する。

設定	内容
Item	表示に使うアイテム。モデルに対応する種類を指定
Color	染色対応モデルの色。10進数RGBで、16777215が白
Scale	大きさを[X,Y,Z]で指定。既定[5f,5f,0.1f]
Frames	再生順に並べたCustomModelDataのリスト
LockRotation	falseで召喚時の実行向きに合わせる。既定false
Transformation	必要に応じて表示の回転・位置などを指定

斬撃演出1

# objectを召喚
data modify storage api: Argument.ID set value 2001
data modify storage api: Argument.FieldOverride.Item set value {id:"minecraft:leather_boots",Count:1b}
data modify storage api: Argument.FieldOverride.Color set value 16777215
data modify storage api: Argument.FieldOverride.Scale set value [4f,4f,0.1f]
data modify storage api: Argument.FieldOverride.Frames set value [20335,20336,20337]
function api:object/summon

斬撃演出2

# 既存の使用例: Mob0372 tutankhamen、Mob0391 axia_first、Mob0393 labyria_firstなど
data modify storage api: Argument.ID set value 2001
data modify storage api: Argument.FieldOverride.Item set value {id:"minecraft:leather_horse_armor",Count:1b}
data modify storage api: Argument.FieldOverride.Color set value 16777215
data modify storage api: Argument.FieldOverride.Scale set value [7f,7f,0.1f]
data modify storage api: Argument.FieldOverride.Frames set value [20353,20354,20355]
function api:object/summon

ソニックブーム

# 既存の使用例: Mob0391 axia_first、Object2002 lighting_fast、Object2015 axia_shock_wave
data modify storage api: Argument.ID set value 2001
data modify storage api: Argument.FieldOverride.Item set value {id:"minecraft:leather_horse_armor",Count:1b}
data modify storage api: Argument.FieldOverride.Color set value 16777215
data modify storage api: Argument.FieldOverride.Scale set value [6f,6f,0.1f]
data modify storage api: Argument.FieldOverride.Frames set value [20356,20357,20358,20359,20360,20361,20362]
function api:object/summon

2168 レーザー

召喚時の向きに沿ってレーザーを表示する。以下は実行者の目の前に水色のレーザーを出す例となる。

data modify storage api: Argument.ID set value 2168
data modify storage api: Argument.FieldOverride.Color set value 65535
data modify storage api: Argument.FieldOverride.Scale set value [0.5f,20f,0.5f]
data modify storage api: Argument.FieldOverride.AppearInterpolation set value 5
data modify storage api: Argument.FieldOverride.DisappearTick set value 40
data modify storage api: Argument.FieldOverride.DisappearInterpolation set value 10
data modify storage api: Argument.FieldOverride.LifeTime set value 55
execute anchored eyes positioned ^ ^ ^1 run function api:object/summon

設定	内容	既定値
Color	10進数RGB	16777215
Scale	[横の太さ,長さ,縦の太さ]	[3f,40f,3f]
AppearInterpolation	出現時の拡大にかけるtick数	2
DisappearTick	出現開始から縮小開始までのtick数	2
DisappearInterpolation	縮小にかけるtick数	2
LifeTime	消滅を判定する経過tick数	20
CustomModelData	レーザー用モデル	20381

出現開始はObjectの2tick目、縮小開始はDisappearTick + 2tick目となる。LifeTimeを超えると消滅するため、縮小が終わる時間まで残るよう設定する。

向きは召喚時に決まり、生成後の旋回には追従しない。CustomModelDataを変更する場合は、このObjectの変形に対応するモデルを指定する必要がある。

2256 水柱

指定位置に水柱のアニメーションを表示する。

data modify storage api: Argument.ID set value 2256
data modify storage api: Argument.FieldOverride.Scale set value 4f
function api:object/summon

設定	内容	既定値
Scale	水柱全体の大きさ。単一の数値で指定	4f

フレームは設定済みで、再生終了後に自動で消滅する。2001と異なり、Scaleは配列ではなく単一の数値となる。

2257 雷

指定位置に短い雷のアニメーションを表示する。

data modify storage api: Argument.ID set value 2257
data modify storage api: Argument.FieldOverride.Scale set value 3f
function api:object/summon

設定	内容	既定値
Scale	雷の表示サイズ。単一の数値で指定	3f

表示は見る側に対して水平方向に向き合う。途中のフレームをランダムで飛ばすため、再生時間にはわずかな差があり、終了後は自動で消滅する。

2279 汎用魔法陣object

召喚時の向きに合わせて、両面の魔法陣を表示する。出現・回転・消失をまとめて設定できる。

data modify storage api: Argument.ID set value 2279
data modify storage api: Argument.FieldOverride.Char set value "0"
data modify storage api: Argument.FieldOverride.Font set value "object/2279"
data modify storage api: Argument.FieldOverride.Color set value "#00FFBB"
data modify storage api: Argument.FieldOverride.LeftRotate set value false
data modify storage api: Argument.FieldOverride.AppearScale set value [5f,5f,0f]
data modify storage api: Argument.FieldOverride.DisappearScale set value [0f,0f,0f]
data modify storage api: Argument.FieldOverride.AppearDuration set value 12
data modify storage api: Argument.FieldOverride.SpinDuration set value 16
data modify storage api: Argument.FieldOverride.DisappearDuration set value 12
data modify storage api: Argument.FieldOverride.Tick set value 59
function api:object/summon

設定	内容	既定値
Char	表面に表示する文字	"0"
BackChar	裏面の文字	未指定ならCharと同じ
Font	魔法陣画像を提供するフォント	"object/2279"
Color	色名または"#RRGGBB"	未指定
LeftRotate	左回転にするか	false
AppearScale	出現後の大きさ	[5f,5f,0f]
DisappearScale	消失時の大きさ	[0f,0f,0f]
AppearDuration	出現にかけるtick数	12
SpinDuration	90度の通常回転にかけるtick数	16
DisappearDuration	消失にかけるtick数	12
Tick	初回待機・出現・消失を含む寿命	59

各Durationは1以上、Tickは3 + AppearDuration + DisappearDuration以上にする。通常回転の区切りに合わせる場合は、次の式で指定できる。

Tick = 3 + AppearDuration + SpinDuration × 通常回転回数 + DisappearDuration

例の59は、初回待機3tick・出現12tick・通常回転2回32tick・消失12tickとなる。

CharとBackCharには、指定したフォントが提供する画像に対応した文字を指定する。BackCharを空文字列にすると、表面の文字はコピーされない。

Mob専用

以下の2つはMobの攻撃予告用として扱う。予告完了に合わせた攻撃の実行は呼出側で管理する。

2063 damage_area

外円の内側を徐々に満たす円形予告を表示する。

data modify storage api: Argument.ID set value 2063
data modify storage api: Argument.FieldOverride.Color set value 16711680
data modify storage api: Argument.FieldOverride.Scale set value [5f,5f,0.01f]
data modify storage api: Argument.FieldOverride.Tick set value 40
execute positioned ~ ~0.01 ~ run function api:object/summon

設定	内容	既定値
Color	10進数RGB	0
Scale	表示サイズを[X,Y,Z]で指定	[5f,5f,0.01f]
Tick	内円が満ちるまでのtick数	20

Tickは正の整数にする。内円の拡大はScale[0]を基準とするため、通常はX・Yを同じ値にする。予告完了の2tick後に消滅する。

例では地面との表示の重なりを避けるため、召喚位置を0.01ブロック上げている。

2113 rectangle_announce

実行向きの水平角に合わせて、地面に長方形の予告を表示する。

data modify storage api: Argument.ID set value 2113
data modify storage api: Argument.FieldOverride.Color set value 16711680
data modify storage api: Argument.FieldOverride.Scale set value [5f,20f]
data modify storage api: Argument.FieldOverride.ToForward set value true
data modify storage api: Argument.FieldOverride.Interpolation set value 10
data modify storage api: Argument.FieldOverride.Tick set value 50
execute positioned ~ ~0.01 ~ run function api:object/summon

設定	内容	既定値
Color	10進数RGB	10000
Scale	[幅,長さ]	[5f,10f]
ToForward	trueで召喚位置から前方へ伸ばす。falseで召喚位置を中心に伸ばす	true
Interpolation	長方形が伸びる変化にかけるtick数	0
Tick	消滅を判定する経過tick数	50

3tick目から指定した長さへ伸び、Tickを超えると消滅する。縦方向の視線角は使わず、水平面に表示する。

例では地面との表示の重なりを避けるため、召喚位置を0.01ブロック上げている。