🌎 EN Description

Free Upgrade Every Round

A balancing mod designed for large multiplayer lobbies. When many players join a run, upgrade distribution often becomes extremely uneven. This mod reduces that variance by giving each player a guaranteed upgrade choice every stage.

🟦 Purpose of This Mod

In large multiplayer groups, it’s common for:

• Some players to get strong upgrades early
• Others to get nothing useful
• Power levels to drift too far apart

This mod solves that problem by providing every player with an equal chance to grow, regardless of random loot distribution.

🟦 Features

• Configurable free upgrade slots every stage Each player receives free upgrade slots when progressing to a new stage. The number of slots granted per level can be changed in the config.

• Fair & equal selection system (draft) Players choose from 4 random upgrade options generated by the host.

• Host-controlled generation (anti-cheat friendly)

  • Clients cannot alter their own upgrade results
  • Host ensures synchronized, authoritative upgrade progression

• Configurable appearance rates Adjust which upgrades show more or less often. Perfect for balancing large cooperative runs.

• Full multiplayer sync via REPOUpgradeAPI Ensures upgrade effects apply correctly on both host and clients.

• Press P to reopen the upgrade UI at any time.

🛠️ Configuration

Automatically generated at:

BepInEx/config/Kai.FreeUpgradeEveryRound.cfg

Free Slots Per Level

FreeSlotsPerLevel controls how many free upgrade selections are granted for each level of progression.

Example:

FreeSlotsPerLevel = 3

With this setting, each applicable level grants 3 free upgrade slots per player.

The host's setting is authoritative in multiplayer.

Free upgrades start from Level 2. Level 1 does not grant free slots.

If the value is changed during a run, the mod reconciles the total granted slots when the next level starts:

• Increasing the value grants any missing slots from previous levels.
• Decreasing the value does not remove already granted slots. New grants are paused until the configured total catches up.

Also supports per-upgrade weighting (0.0 = never appears).

v3.0.0 compatibility notice:
Free-slot progression data from older versions is not migrated.
v3.0.0 uses a new host-authoritative grant tracking system.

✔ Recommended For Players Who:

• Play with large multiplayer groups (5–10+ players)
• Want to reduce upgrade RNG variance
• Prefer fairer and more even character progression

🇯🇵 日本語説明欄

Free Upgrade Every Round

このMODは、大人数マルチプレイで発生する「アップグレード格差」を減らすため に作られました。

人数が多いと、どうしても：

• 誰かは強いアップグレードを独占する
• 誰かはほとんど強化できない
• プレイヤー間で戦力差が広がる

といった問題が起こります。

このMODは、全プレイヤーに平等な強化機会を保証することで格差を緩和します。

🟦 このMODの目的

• 大人数で遊ぶときのアップグレード偏りを減らす
• プレイヤー間の進行度の差を抑え、協力プレイを快適にする

🟦 主な機能

• レベル進行ごとの“無料アップグレード枠”付与数をConfigで調整可能 1レベルあたりに各プレイヤーへ付与するFreeSlot数を変更できます。

• 4つの候補から好きな強化を1つ選べるドラフト方式 ホスト側で生成 → 全クライアントへ同期する安全仕様。

• 不正防止・同期保証 クライアントが勝手にアップグレードを書き換えられない構造。

• 出現確率を自由に調整可能（Config対応） "Health が出すぎ問題" などを好みに調整できます。

• REPOUpgradeAPI による完全同期 ステータス更新のズレが発生しません。

• P キーを押すと、いつでもアップグレードUIを再度開くことができます。

🛠️ Config設定

Configは以下に自動生成されます。

BepInEx/config/Kai.FreeUpgradeEveryRound.cfg

1レベルあたりのFreeSlot付与数

FreeSlotsPerLevel で、レベル進行ごとに各プレイヤーへ付与するFreeSlot数を変更できます。

例：

FreeSlotsPerLevel = 3

この場合、対象となる各レベルで 1人につき3回分の無料アップグレード枠 が付与されます。

マルチプレイでは ホスト側の設定が権威 となります。

FreeSlotの付与は Level 2から開始 し、Level 1では付与されません。

Run途中で値を変更した場合は、次のLevel開始時に累計付与数を再計算します。

• 値を増やした場合：過去Level分の不足数を補填します。
• 値を減らした場合：既に付与済みのFreeSlotは没収せず、設定上の累計値が追いつくまで新規付与を停止します。

従来どおり、各アップグレードの出現重みもConfigから調整できます（0.0 = 出現しない）。

v3.0.0 互換性について
旧バージョンのFreeSlot進行データは引き継ぎません。
v3.0.0からホスト権威の新しい付与管理方式を使用します。

✔ こんな人におすすめ

• 5～10人以上でプレイすることが多い
• 各プレイヤーのアップグレード格差を抑えたい
• 大人数協力プレイで進行バランスを整えたい

Changelog

Changelog – v3.0.0

• Added configurable FreeSlot grants per level
FreeSlotsPerLevel can now be used to change how many free upgrade selections each player receives per level.

• Changed FreeSlot progression to host-authoritative tracking
The host now manages FreeSlot grants and reconciles each player's cumulative granted slots when a level starts.

• Added runtime config reconciliation
Increasing FreeSlotsPerLevel grants missing slots from previous levels at the next level start.
Decreasing it does not remove already granted slots; new grants remain paused until the configured cumulative amount catches up.

• Breaking save compatibility
FreeSlot progression data from older versions is not migrated to v3.0.0.

Changelog – v1.0.1

• Adjusted configuration options Improved how upgrade weighting values are defined and handled in the config file.

• Refined draft selection logic Updated the upgrade selection algorithm to better reflect configured appearance rates.

Changelog – v1.0.3

• Added configurable draft count You can now configure how many upgrade choices appear (1–4).