Skip to content

✨ 神器の Field を、入口を呼ぶ間 asset:context this で読めるようにする - #2328

Open
EllaCoat wants to merge 4 commits into
dev/ella_artifact-dispatchfrom
dev/ella_artifact-field
Open

EllaCoat wants to merge 4 commits into
dev/ella_artifact-dispatchfrom
dev/ella_artifact-field

Conversation

@EllaCoat

@EllaCoat EllaCoat commented Nov 1, 2026 •

Copy link
Copy Markdown
Member

概要

神器の調整値を give で一度だけ宣言して使えるよう、give の Field の中身を、入口を呼ぶ間 asset:context this から読めるようにした。#2327 の上に積んでいるので、#2327 のマージ後に base を master へ付け替える。

主な変更

Field を入口へ渡す仕組みと、Field の数値を説明文に出す関数を足し、Field の置き場を ROM とキャッシュ(ArtifactCache)にした。

  • 入口から調整値を読めるよう、入口を呼ぶ直前にキャッシュの要素の Field を asset:context this へ写し、呼び終えたら this を消す
  • Field の持ち主を ROM にするため、give で ROM の Artifact に Field を書く。Field だけを変えた give でも、その時オンラインの全員のキャッシュを次の処理で作り直し、オフラインだった人は入り直したときに作り直す
  • 説明文に小数を出せるよう、Field の数値を文字列にする関数 asset:artifact/common/field_text.m を追加した
  • 書き方の見本として、example の give で Field から Lore の translate と AttackInfo を組んだ

設計判断

this に入れる値とその置き場、field_text.m の文字列の組み方を決めた。

  • Field は readonly で個体差が無いので、持ち主は ROM だけにし、アイテムの tag.TSB には入れない
  • 入口のたびに ROM を引く形は、1 人・1 tick 約 240 µs かかる(⚡️ ROM の提供で、前回のアドレスと上の桁が同じ層の付け替えを省く #2329 の前の provide 1 回 59 µs × tick の入口 4 回)ので採らない
  • 神器が MPCost などを読む作りにならないよう、tag.TSB の値は this に写さない
  • 呼ぶ前から this に入っていた値を入口へ渡さないよう、Field を書かない神器にも Field: {} を持たせ、this を必ず上書きする
  • 入口の macro(call.m)は Namespace・Entry だけを使い、要素の Field は macro の引数の組の照合に入らない
  • double を macro でそのまま文字列にすると 0.5 が .5 と出るので、field_text.m は符号・整数部・小数部を組んで作る

動作確認

機構テスト、テンプレートの検査、変更前後の比較、静的検査、CI の lint は通った。click と attack は変更前より軽く、tick は測りのぶれを超える差が出なかった。

  • 機構テスト 55 項目通過
  • MCDU の「神器/テンプレート」から作った神器で、テンプレートの検査 6 項目通過(give、click で 3.main、this、説明文)
  • 全 event の場面 184 個で、変更前と神器の関数呼び出しを比べ、181 個一致(差の 3 件は神器の中の乱数の分岐)
  • 変更した行の静的検査で指摘 0 件、CI の lint(lint-datapack)通過
  • 重さは神器 8 個を持たせ、各処理を 1 tick に 100 回呼んだときの 1 回あたりの時間(µs、7 周の中央値、別の起動で 2 回)
処理 変更前 #2327 この PR
tick の event 1878・1907 2027・1834 1826・1885
click 213.6・219.6 104.9・109.0 109.5・112.1
attack 255.7・263.6 221.8・200.1 194.2・196.2
毎 tick のキャッシュの読み出し 2.7・5.9 3.1・7.1 5.6・7.6

未対応・注意

マージの順は #2327 → ProjectTSB/Asset#2222 → この PR → ProjectTSB/Asset#2223。

  • asset:rejoin の tag で呼ぶ処理 22 本では、this に Field は入らない
  • field_text.m は、値の絶対値が 21474 以上か、Scale を掛けた値が 214748 以上だと扱えない
  • ✨ 神器の入口を give で宣言した Triggers から event ごとに呼ぶ #2327 だけの build で ROM に宣言が書かれた神器は、give し直すか移行で give されるまで this が空
  • Field だけを変えた give と同じ tick の use_item は、その 1 回だけ古い Field を使う(Triggers を変えたときも同じ)

@EllaCoat EllaCoat changed the title ✨ 神器の Field と TSB の値を、入口を呼ぶ間 asset:context this で読めるようにする ✨ 神器の Field を、入口を呼ぶ間 asset:context this で読めるようにする Nov 2, 2026
@EllaCoat
EllaCoat marked this pull request as ready for review November 2, 2026 11:39

@tatuharu tatuharu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

このレビューはハルがAI自動レビューの動作テストのためにOpus5.5 Extra Highを使用してレビューを行なったものです。鵜呑みにせず、指摘を採用するかはお任せします。

指摘はありません。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants