FreeUpgradeEveryRound

🌎 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人以上でプレイすることが多い
• 各プレイヤーのアップグレード格差を抑えたい
• 大人數協力プレイで進行バランスを整えたい