Home › Researched mods

Vanilla Trading Expanded

Factions & Trade

Layer 1 At a glance

What the mod is, how to use it, video

Vanilla Trading Expanded
Vanilla Trading Expanded — Oskar Potocki, Taranchuk

リムワールドに銀行・ローン・株・相場変動を持ち込む「経済」Mod

Not yet translated This section is available in Japanese only for now.

409.4KSubs
★4.8Workshop rating
24features
6mod images
Basics
Type
ゲームプレイ
Game versions
1.5 / 1.6 / 1.7(loadFolders.xml で 1.7 は 1.6 フォルダを流用)
Dependencies
なし(modDependencies / loadAfter の記載なし。Harmony はDLL同梱ではなくコードで使用。Royalty があれば帝国銀行が追加)
Author
Oskar Potocki, Taranchuk
License
記載なし(LICENSE ファイル無し)
Workshop
2785616901 ・ 409,370 Subs ・ ★★★★★
Repository
Vanilla-Expanded/VanillaTradingExpanded

▼ Deeper from here

Layer 2 What is inside

Main features, category cards, tier list

Features with pictures (1)

Not yet translated This section is available in Japanese only for now.

Structures Trading ConsoleStructures Trading ConsoleStructures Trading Console

1Trading terminal(取引端末)

建築「その他(Misc)」タブ。3×2、鋼鉄140・部品4、電力200W、研究「Microelectronics basics(マイクロエレクトロニクス基礎)」、建設5。右クリッ…

Show the other 23 features
2端末の使用条件
電源オン・太陽フレア中は不可、入植者に「会話(Talking)」能力が必要
3市場価格の変動(全アイテム共通)
市場価値ステータスそのものを書き換えるので、取引画面・コロニー資産・売値すべてに反映
4プレイヤーの売買が相場を動かす
大量に売るとその品が値下がり、買うと値上がり。3日ごとに集計、売買額1,000シルバー以上でほぼ確実に変動
5季節による食料価格
冬は食料が値上がり、夏は値下がり(3日ごと、30%の確率)
6ランダムな世界の取引
3日ごとに取引可能アイテムの20%(設定可)の価格が±1〜5%変動
7価格の自然回復
変動した価格は3日ごとに少しずつ元の値(バニラ値)へ戻る
8View prices(価格を見る)画面
全取引品の Market Value(基準値)/ Current Value(現在値)/ Change(変動)/ Recent Change(直近3日変動)を並べ替え・検索。グラフアイコンで Price history(価格履歴)チャート
9Planetary news(ニュース)
平均3日に1回ニュース発生、全60種。派閥・拠点・企業の出来事で関連品の価格が上下(発表から少し遅れて反映)
10View news(ニュースを見る)画面
Filter by(絞り込み): All(全部)/ Only specific category(特定カテゴリ)/ Only trader ship(交易船のみ)/ Only bullish(強気)/ Only bearish(弱気)
11銀行(Contact 〈派閥〉 / 〈派閥〉に連絡)
帝国(Royalty)は「Imperial Bank(帝国銀行)」、アウトランダー(文明派閥)は「Bank of 〈派閥名〉」。どちらも無い世界では友好的な人間派閥にランダムで銀行ができる
12預金・引き出し(Deposit or Withdraw)
正の数で預金、負の数で引き出し。引き出した銀はドロップポッドで届く。預けた銀は消えるので資産(襲撃規模)に入らない
13銀行手数料は好感度次第
好感度 -100:40% / -50:30% / 0:20% / 50:10% / 100:5%。預金時と引き出し時の両方で引かれる
14ローン4種
Quick Cash(即金)/ Short Term(短期)/ Long Term(長期)/ Mortgage(住宅)。即金以外は預金額に応じて借入額が決まり、預金が無いと「Unlocks after putting your money on the deposit」
15延滞のペナルティ
期日超過で毎日元本の1%(帝国は5%)利息追加、好感度-100で敵対化、預金が入ると自動返済
16取り立て屋(Collectors)襲撃
延滞180日超で警告のレター、その後平均15日ごとに海賊の大規模襲撃(ポイント2倍、借金額を資産に加算して計算)
17株式市場(Open stock market)
軌道交易船の会社(最大30社)の株を「<」「>」で売買。Value / Shares held / Profit/Loss / Recent Change、チャート表示。支払いは銀行預金から(どの銀行から出すか選択)
18Follow news(ニュースを追う)
会社ごとのチェックボックス。オンにするとその会社のニュースが画面上部にメッセージ表示される
19株価の動き
毎日、半分の会社が±1%。決算ニュース(Terrible〜Outstanding Earnings)、船の墜落、新造船など。「Fear of bankruptcy(倒産懸念)」は±90%の大暴騰/大暴落
20NPCの契約(Contracts)
最大30件の買取依頼。品・数量・報酬・Mark-up(上乗せ率)・期限を表示。「Complete contract(契約を完了)」で3日後にキャラバンが倉庫/ホームエリアから品物を回収
21契約キャラバンの細かい挙動
品が足りないと集めた割合だけ支払い(ゼロなら報酬なし)。危険で撤退したら3日後に戻ってくる。報酬は銀行預金に入る
22NPC契約の早い者勝ち
他の誰かが先に契約を達成して消えることがある(半日ごとに判定)。高報酬ほど早く消える
23自分で契約を出す(Your Contracts)
品物・素材(Select stuff)・数量・Mark-up・期間を決めて発注。達成されると銀行預金から支払い、ドロップポッドで納品
24開発者モードの追加コマンド
「Spawn 1x/10x news」「Fluctuate prices of 10/20 items」「Regenerate contracts」「Spawn 100000 silver」「Add bank」

In-game photos

Trading terminal
Trading terminal

▼ Deeper from here

Layer 3 Numbers and caveats

Full stat tables, gaps to vanilla, husbandry, compatibility and caveats

Not yet translated This section is available in Japanese only for now.

紹介文に書かれていない/分かりにくい機能

Open
  • 契約で動物も買える: 自分の契約の品目リストに動物が入っていて、達成するとその動物がプレイヤー所属で届く(Window_SelectItemForContract が Utils.animals を含む、Contract.MakeItem)。
  • 相場は「市場価値」そのものを変える: 取引画面だけでなくコロニー資産や作品の価値も動くため、高騰している品を貯めると襲撃が強くなる。採掘資源の配置だけはバニラ値で計算するよう除外されている。
  • 銀行預金と株は資産扱いにならない: 銀を預けると実物が消えるので、襲撃ポイントを下げる「隠し財産」として使える(推測:ストーリーテラーの資産計算に預金を足す処理は、取り立て屋の襲撃時以外には無い)。
  • ローンのクールダウン: 同じ種類のローンは前回借りた日から返済期間が過ぎるまで再び借りられない(「You can only take this loan again on 〈日付〉」)。無限金策対策。
  • 帝国銀行は条件が厳しく、額も大きい: 帝国は延滞利息が1日5%(アウトランダーは1%)、即金ローンは5,000→7,500を10日で返済(アウトランダーは10,000→15,000を15日)。住宅ローンは預金の3倍(アウトランダーは2倍)を300日。
  • NPC契約の金額はコロニー資産で決まる: 目安はコロニー資産の1%(上限は設定で1万シルバー)。肉・卵・革・毛のような「集めるだけの品」は設定で除外できる。染料と岩の塊は除外済み。
  • Caravan-less contract item pickup(キャラバン無しで回収): 設定でオンにすると、契約完了ボタンを押した瞬間に品物が消えて報酬が入る(キャラバン待ちが不要)。
  • 「スクイーズ(高騰)とクラッシュ(暴落)」は現行版では動かない: 紹介文にある機能だが、TradingManager の該当処理がすべてコメントアウトされていて、メッセージ「Price of 〈銘柄〉 is squeezing/crashing」もどこからも呼ばれていない。実際に大きく動くのは株の「倒産懸念」ニュースくらい。

他のModとの連携・相性

Details
  • 他のModが使える拡張点:
    • VanillaTradingExpanded.BankExtension: FactionDef に付けると、その派閥が銀行を持つ。銀行名、好感度ごとの手数料カーブ、ローンの種類(固定額か預金比、返済期間、延滞利息)を設定できる。
    • VanillaTradingExpanded.NewsDef: 他のModが独自ニュースを追加できる(対象は thingCategories / thingDefs / tradeTags / thingSetMakerTags で指定)。
    • tradeTags に NonContractable を付けたアイテムは契約に出ない。
  • 売買の検知は ITrader を実装した全クラスの GiveSoldThingToTrader / GiveSoldThingToPlayer にパッチするので、他Modの交易相手でも相場に反映される。
  • BankNote(他Modの紙幣アイテム)が存在する場合は価格変動の対象から外す。
  • BetterLoading 導入時は初期化タイミングを BetterLoading 側に合わせる(Utils.Initializer)。
  • 交易系や市場価値を書き換えるMod(価格調整系)とは、MarketValue の基本値パッチが競合する可能性がある(推測)。

注意点・既知の制限

  • 翻訳キー不足: 延滞180日の警告のレターで使う VTE.DebtCollection / VTE.DebtCollectionDesc が Keyed.xml に無く、キー名がそのまま表示される(Bank.Tick)。
  • 警告のレターが繰り返される可能性: 警告済みフラグ warrantForIndebtednessWarningIssued がセーブされない。ロードするたびに警告が再送されると思われる(推測)。
  • 日本語訳は同梱されていない(Languages/English のみ)。
  • スクイーズ/クラッシュは無効化されている(上記)。
2 more
  • セーブデータ: GameComponentに価格・銀行・株・契約を保存。途中導入は可能(起動時に銀行・会社・契約を生成)。途中で外すと預金・株は消え、価格はバニラに戻る(推測)。
  • 価格が変わった品は全ての市場価値計算でルックアップが入るが、辞書参照のみなので負荷は小さい(推測)。

Mod設定の項目

16 options (table in layer 4).

Settings table ↓

キー操作・ボタン・メニュー

Open(キー操作・ボタン・メニュー)
  • 取引端末を右クリック: 「View prices(価格を見る)」「View news(ニュースを見る)」「Open stock market(株式市場を開く)」「Open contracts(契約を開く)」「Contact 〈派閥〉(〈派閥〉の銀行に連絡)」(銀行の数だけ)。
  • 取引端末の建設ホットキー: Misc3。専用のキー割り当てやメインボタンは無い。

▼ Deeper from here

Layer 4 For the deep divers: how it works in the source

Mechanisms read from source, raw Defs values, formulas, open questions

From here on: site-only detail (not covered in the video)

Not yet translated This section is available in Japanese only for now.

Mod設定の項目

Open the table (16 rows)
設定名(画面表示)初期値効果
How often news will appear(ニュースの頻度)3日ニュース発生の平均間隔(0.01〜100日)
Player transaction impact multiplier on price fluctuation(自分の売買が相場に与える影響)100%0〜1000%
Price fluctuation limitations(価格変動の制限)+ Negative change / Positive changeオフ / -95% / +200%オンにすると基準値からの下落・上昇幅を制限
Player contract fulfilment chance multiplier(自分の契約の達成率)100%1〜1000%
Multiplier of how much news affect the market(ニュースの影響度)100%1〜1000%
NPC contract fulfilment chance multiplier(NPC契約が他者に取られる率)100%1〜1000%
Maximum available NPC contract count(NPC契約の最大数)301〜200
Maximum trade company count(会社の最大数)301〜200
Maximum mark-up on NPC contract(NPC契約の最大上乗せ率)1000%(10倍)報酬倍率の上限。高倍率ほど出にくい
Maximum value of NPC contracts in silver(NPC契約の上限額)10,000数値入力
Maximum value of NPC contracts in percentage of wealth(資産に対する契約の上限割合)1%0〜100%
Blacklist collectibles (Eggs, Meat, Leather and Wool) for contracts(卵・肉・革・毛を契約から除外)オフ—
Caravan-less contract item pickup(キャラバン無しで回収)オフ契約品を即時回収
Amount of random item price fluctuations(ランダム変動するアイテムの割合)20%3日ごとに変動する品の割合
Reset price fluctuations(価格変動をリセット)—プレイ中のみ表示。全価格をバニラ値に戻し履歴も消す
Reset(初期化)—設定を初期値に戻す

Features and evidence (files, classes)

Open the table with evidence (24 rows)

読んだのは 1.6/(Defs, Patches, Source)と Languages/English(日本語訳は同梱されていない)。

#機能ゲーム内での見え方・操作根拠(ファイル/クラス)
1Trading terminal(取引端末)建築「その他(Misc)」タブ。3×2、鋼鉄140・部品4、電力200W、研究「Microelectronics basics(マイクロエレクトロニクス基礎)」、建設5。右クリックで各メニューBuildings_Misc.xml, Building_TradingTerminal
2端末の使用条件電源オン・太陽フレア中は不可、入植者に「会話(Talking)」能力が必要Building_TradingTerminal.GetFailureReason
3市場価格の変動(全アイテム共通)市場価値(MarketValue)ステータスそのものを書き換えるので、取引画面・コロニー資産・売値すべてに反映HarmonyPatches: StatWorker_GetBaseValueFor_Patch
4プレイヤーの売買が相場を動かす大量に売るとその品が値下がり、買うと値上がり。3日ごとに集計、売買額1,000シルバー以上でほぼ確実に変動GiveSoldThingToTrader_Patch / GiveSoldThingToPlayer_Patch, TradingManager.ProcessPlayerTransactions
5季節による食料価格冬は食料が値上がり、夏は値下がり(3日ごと、30%の確率)TradingManager.SeasonalPriceUpdates
6ランダムな世界の取引3日ごとに取引可能アイテムの20%(設定可)の価格が±1〜5%変動SimulateWorldTrading / AffectPriceRandomly
7価格の自然回復変動した価格は3日ごとに少しずつ元の値(バニラ値)へ戻るDoPriceRebalances
8View prices(価格を見る)画面全取引品の Market Value(基準値)/ Current Value(現在値)/ Change(変動)/ Recent Change(直近3日変動)を並べ替え・検索。グラフアイコンで Price history(価格履歴)チャートWindow_MarketPrices, PriceHistoryAutoRecorder
9Planetary news(ニュース)平均3日に1回ニュース発生、全60種。派閥・拠点・企業の出来事で関連品の価格が上下(発表から少し遅れて反映)News.xml, NewsWorkers, TradingManager.CreateNews
10View news(ニュースを見る)画面Filter by(絞り込み): All(全部)/ Only specific category(特定カテゴリ)/ Only trader ship(交易船のみ)/ Only bullish(強気)/ Only bearish(弱気)Window_News
11銀行(Contact 〈派閥〉 / 〈派閥〉に連絡)帝国(Royalty)は「Imperial Bank(帝国銀行)」、アウトランダー(文明派閥)は「Bank of 〈派閥名〉」。どちらも無い世界では友好的な人間派閥にランダムで銀行ができるPatches/*/BankExtension.xml, TradingManager.GenerateAllStartingBanks
12預金・引き出し(Deposit or Withdraw)正の数で預金、負の数で引き出し。引き出した銀はドロップポッドで届く。預けた銀は消えるので資産(襲撃規模)に入らないBank.DepositSilver / WithdrawSilver, Window_Bank
13銀行手数料は好感度次第好感度 -100:40% / -50:30% / 0:20% / 50:10% / 100:5%。預金時と引き出し時の両方で引かれるBankExtension.feesByGoodwill, Bank.Fees
14ローン4種Quick Cash(即金)/ Short Term(短期)/ Long Term(長期)/ Mortgage(住宅)。即金以外は預金額に応じて借入額が決まり、預金が無いと「Unlocks after putting your money on the deposit」LoanOption, Window_Bank
15延滞のペナルティ期日超過で毎日元本の1%(帝国は5%)利息追加、好感度-100で敵対化、預金が入ると自動返済Bank.Tick
16取り立て屋(Collectors)襲撃延滞180日超で警告のレター、その後平均15日ごとに海賊の大規模襲撃(ポイント2倍、借金額を資産に加算して計算)Bank.Tick, IncidentWorker_Collectors, World_PlayerWealthForStoryteller_Patch
17株式市場(Open stock market)軌道交易船の会社(最大30社)の株を「<」「>」で売買。Value / Shares held / Profit/Loss / Recent Change、チャート表示。支払いは銀行預金から(どの銀行から出すか選択)Window_StockMarket, Company, Window_PerformTransactionCosts/Gains
18Follow news(ニュースを追う)会社ごとのチェックボックス。オンにするとその会社のニュースが画面上部にメッセージ表示されるWindow_StockMarket, NewsWorker_CompanyAction.OnCreate
19株価の動き毎日、半分の会社が±1%。決算ニュース(Terrible〜Outstanding Earnings)、船の墜落、新造船など。「Fear of bankruptcy(倒産懸念)」は±90%の大暴騰/大暴落TradingManager.DoPriceImpactsFromNews, News.xml
20NPCの契約(Contracts)最大30件の買取依頼。品・数量・報酬・Mark-up(上乗せ率)・期限を表示。「Complete contract(契約を完了)」で3日後にキャラバンが倉庫/ホームエリアから品物を回収Window_Contracts, Contract, TradingManager.CompleteContract
21契約キャラバンの細かい挙動品が足りないと集めた割合だけ支払い(ゼロなら報酬なし)。危険で撤退したら3日後に戻ってくる。報酬は銀行預金に入るLordJob_GrabItemsAndLeave, IncidentWorker_CaravanArriveForItems, TradingManager.ProcessContracts
22NPC契約の早い者勝ち他の誰かが先に契約を達成して消えることがある(半日ごとに判定)。高報酬ほど早く消えるProcessContracts, Contract.ContractFulfilmentChance
23自分で契約を出す(Your Contracts)品物・素材(Select stuff)・数量・Mark-up・期間を決めて発注。達成されると銀行預金から支払い、ドロップポッドで納品Window_Contracts, Window_SelectItemForContract
24開発者モードの追加コマンド「Spawn 1x/10x news」「Fluctuate prices of 10/20 items」「Regenerate contracts」「Spawn 100000 silver」「Add bank」Utils(DebugAction)

Unverified or inferred statements

Open 5
  • 銀行預金と株は資産扱いにならない: 銀を預けると実物が消えるので、襲撃ポイントを下げる「隠し財産」として使える(推測:ストーリーテラーの資産計算に預金を足す処理は、取り立て屋の襲撃時以外には無い)。
  • 交易系や市場価値を書き換えるMod(価格調整系)とは、MarketValue の基本値パッチが競合する可能性がある(推測)。
  • 警告のレターが繰り返される可能性: 警告済みフラグ warrantForIndebtednessWarningIssued がセーブされない(Loan.ExposeData)。ロードするたびに警告が再送されると思われる(推測)。
  • セーブデータ: GameComponent(TradingManager)に価格・銀行・株・契約を保存。途中導入は可能(起動時に銀行・会社・契約を生成)。途中で外すと預金・株は消え、価格はバニラに戻る(推測)。
  • 価格が変わった品は全ての市場価値計算でルックアップが入るが、辞書参照のみなので負荷は小さい(推測)。

Commit read

https://github.com/Vanilla-Expanded/VanillaTradingExpanded
85524a235b4ff6dc7b25858420518aa79ef35442

Credit

Vanilla Trading Expanded — Oskar Potocki, Taranchuk ・ Steam Workshop ・ GitHub

Image and license notes (from the report)
  • About_Preview.png(サムネイル)、Structures_TradingConsole_TradingConsole_south/north/east.png(取引端末)、UI_Chart.png(グラフアイコン)、UI_VELogo.png(VEロゴ)
  • 銀行・株・契約・ニュースの画面はコードで描画していて画像が無いため、ゲーム内のスクリーンショットで補う。
  • ライセンス: LICENSE の記載なし。作者の著作物。