FreeRandomUpgrade

Free Random Upgrade

Automatically grants random upgrades when entering the Shop level.

Overview

Free Random Upgrade automatically grants random player upgrades when entering a Shop level.

The upgrades are selected based on the current level progression and fully controlled by configurable weights.

This mod is host-only authoritative and does not require installation on client machines.

Features

• Automatically grants free upgrades upon entering Shop levels
• Upgrade selection is based on weighted random selection
• Fully configurable upgrade weights
• Host-only execution (clients do not need the mod)
• Clean multiplayer-safe implementation

Multiplayer Behavior

• This mod runs entirely on the host
• Clients do NOT need to install the mod
• Upgrade synchronization requires loading into the next stage
• No network RPC injection or unsafe sync behavior

Configuration

All upgrade probabilities and behavior can be controlled via the config file.

General

| Setting | Default | Description |

| --------- | ------- | ---------------------------------- |

| EnableMod | true | Enables or disables the entire mod |

Free Upgrade Settings

| Setting | Default | Range | Description |

| ----------------- | ------- | ----- | ------------------------------------------------------- |

| FreeSlotsPerLevel | 1 | 0 – 5 | Number of free upgrades granted per eligible Shop level |

Upgrade Weight Settings

Each upgrade has an independent weight from 0 to 100.

Higher values increase the chance of being selected.

Setting a weight to 0 disables the upgrade completely.

| Upgrade | Default Weight |

| -------- | -------------- |

| Stamina | 100 |

| Health | 100 |

| Wings | 100 |

| Launch | 100 |

| Climb | 100 |

| Rest | 100 |

| Speed | 100 |

| Jump | 100 |

| Strength | 100 |

| Range | 100 |

| Battery | 0 |

| MapCount | 0 |

| Throw | 0 |

How It Works

When entering a Shop level:

• The mod checks the current level progression
• It determines how many free upgrades to grant
• It selects upgrades based on configured weights
• The upgrades are applied by the host
• Synchronization occurs naturally during stage transitions

Free Random Upgrade

ショップレベルに入った際、自動的にランダムなアップグレードを獲得できるMODです。

概要

Free Random Upgrade は、ショップレベルに突入した際にプレイヤーへランダムなアップグレードを自動付與します。

アップグレードの抽選は、現在の進行狀況を基準に行われ、Configで完全に制御可能です。

本MODは ホストのみで動作 し、クライアント側に導入する必要はありません。

機能

• ショップレベル突入時に自動でアップグレードを付與
• 重み付きランダム抽選によるアップグレード選択
• 全ての抽選確率をConfigで調整可能
• ホストのみで動作（クライアント不要）
• マルチプレイ安全設計

マルチプレイ挙動

• このMODは ホストのみで実行されます
• クライアントにインストールする必要はありません
• アップグレードの同期は ステージ遷移時のロードによって適用されます
• 不正なRPCや同期処理は使用していません

Config説明

Configファイルからすべての挙動を制御できます。

基本設定

| 設定名 | デフォルト | 説明 |

| --------- | ----- | ----------- |

| EnableMod | true | MODの有効 / 無効 |

無料アップグレード設定

| 設定名 | デフォルト | 範囲 | 説明 |

| ----------------- | ----- | ----- | ---------------------- |

| FreeSlotsPerLevel | 1 | 0 – 5 | 各対象レベルで付與される無料アップグレード數 |

アップグレード抽選重み

各アップグレードは 0 ～ 100 の重みを持ちます。

値が高いほど選ばれやすくなります。

0 に設定すると抽選対象から除外されます。

| アップグレード | デフォルト |

| -------- | ----- |

| Stamina | 100 |

| Health | 100 |

| Wings | 100 |

| Launch | 100 |

| Climb | 100 |

| Rest | 100 |

| Speed | 100 |

| Jump | 100 |

| Strength | 100 |

| Range | 100 |

| Battery | 0 |

| MapCount | 0 |

| Throw | 0 |

動作仕様

ショップレベルに突入した際:

• 現在の進行レベルを確認
• 付與するアップグレード數を決定
• Configの重みに基づいて抽選
• ホストがアップグレードを適用
• ステージ遷移時に自動同期