kongyo2 Stellaris Modding
Stellaris mod 制作のための documents-only な self-contained reference skill。
bundled references/ だけで判断できるように構成している。ローカル環境の追加資料、補助ツール、外部サイトの存在は前提にしない。ユーザーが別途ファイルを与えた場合だけ、それを追加の一次資料として扱う。
基本方針
- まず対象ドメインを決める。
- そのドメインに最も近い reference を先に読む。
- スコープや論理条件が怪しいときは、必ず基礎 reference に戻る。
- 構文上は書けそうでも、実運用はバニラ慣習に従う。
読み始め
基礎
| トピック | リファレンス | 用途 |
|---|---|---|
| PDXスクリプト基礎 | 1.基礎概念 | 構文、エンコーディング、コメント、変数 |
| 条件式と論理演算 | 2.条件式と論理演算 | AND/OR/NOT/NOR/NAND、calc_true_if |
| スコープ | 3.スコープ | root、from、prev、主要スコープ遷移 |
主要コンテンツ
| トピック | リファレンス | 用途 |
|---|---|---|
| アノマリー | 4.アノマリー | anomaly category、on_success、anomaly event |
| イベント | 5.イベント | event type、option、after、継承 |
| テクノロジー | 6.テクノロジー | potential、weight_modifier、technology_swap |
| オンアクション | 7.オンアクション | events、random_events、スコープ一覧 |
| エフェクト | 8.エフェクト | 制御構文、生成、変数、反復、scripted effect |
| 政府 | 9.政府 | authority、civic、origin、government |
| 遺物・考古学 | 10.遺物・考古学サイト | relic、artifact action、archaeological site |
| POPと職業 | 11.POPと職業 | pop category、job、swappable_data、経済カテゴリ連携 |
| 特性 | 12.特性 | species trait、leader trait、replace_traits |
| 惑星地形と惑星補正 | 13.惑星地形と惑星補正 | deposit、blocker、planet modifier |
| 建造物とディストリクト | 14.建造物とディストリクト | building、district、building_sets、convert_to |
| 惑星ディシジョン | 15.惑星ディシジョン | potential、allow、effect、resources |
| スペシャルプロジェクト | 16.スペシャルプロジェクト | requirements、on_success、abort_trigger |
追加で読むべき reference
| トピック | リファレンス | 読むタイミング |
|---|---|---|
| 実装規約と上書き原則 | 17.実装規約と上書き原則 | どのファイルに置くか、どこまで上書きするか迷うとき |
| shared logic の設計 | 18.scripted_effects・scripted_triggers・inline_scripts | 共通化、再利用、パラメータ化を考えるとき |
| 経済カテゴリと zones | 19.経済カテゴリ・triggered_modifier・zones | jobs/buildings/districts の出力や 4.0 zone 設計を触るとき |
| 高位システムの入口 | 20.高度システム索引 | situation、megastructure、component、system initializer を触るとき |
実務ルール
scope、trigger、effectが曖昧なら、先に基礎 reference を読む。- 頻繁に発火するイベントは
is_triggered_only = yesとpre_triggersを優先する。 MTTHや重いポーリングより、on_action、遅延イベント、shared logic を優先する。- 似た定義を複製する前に、
convert_to、technology_swap、swappable_data、scripted_effects、scripted_triggers、inline_scriptで吸収できないか考える。 - jobs/buildings/districts の出力変更は、個別定義だけでなく経済カテゴリの継承も確認する。
triggered_*_modifierはツールチップ表示と実適用がズレやすいので、必要ならcustom_tooltipで補足する。- 外部資料がない限り、この skill では「bundled references に書いてあること」だけを根拠に結論を組み立てる。