DroneToOrbItem
【Host Only MOD】Adds hidden orb items to the shop with configurable spawn, price, and behavior settings. 各種ドローンのオーブバージョンアイテムをショップ出現させるMOD
By REPO_JP
| Last updated | 14 hours ago |
| Total downloads | 126 |
| Total rating | 1 |
| Categories | Mods Items Drones Server-side |
| Dependency string | REPO_JP-DroneToOrbItem-1.0.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
DroneToOrbItem
DroneToOrbItem adds hidden orb items to the shop and lets the host control how often they appear, how expensive they are, and how they behave after purchase.
It is intended for runs where you want the shop to naturally offer orb-type utility items instead of spawning them manually in the map.
Known Issues :(
Errors are displayed during the following moments, but the mod itself works normally.
During MOD loading after REPO starts
When creating a room
These errors do not affect gameplay or the functionality of this mod.
A fix to eliminate these error messages is planned for the next update.
Features
- Adds these orb items to shop rolls
- Orb Battery
- Orb Feather
- Orb Heal
- Orb Indestructible
- Orb Magnet
- Orb Torque
- Per-item spawn enable toggle
- Per-item max shop amount
- Per-item spawn chance
- Per-item price delta
- Per-item effect radius
- Per-item battery drain override
- Per-item through-wall toggle
- Per-item held-only toggle
- Orb Heal option to use the health-pack shop slot
- Host-only control for shop roll logic and orb gameplay logic
- Participants can still see and interact with the actual spawned orb items because the mod uses real in-game item resources instead of synthetic placeholder paths
How it works
When a shop is generated, the host injects the supported orb items into the shop candidate lists and applies the configured rules for:
- whether the orb is eligible
- how many may appear
- how often it may appear
- how much its final price is adjusted
After purchase, the host also applies the configured runtime behavior values such as radius and battery drain.
Important behavior
- The host controls shop generation
- The host controls orb runtime behavior
- Participants do not need to control the logic
- The mod uses real item resources already present in the game, so purchased orb items can be rendered for other players as normal game objects
Requirements
- BepInEx 5.4.x
- REPO
- Host should install this mod
- Keeping the same mod version across the group is still recommended for easier troubleshooting even though the main control path is host-side
Installation
- Install BepInEx 5.4.x for REPO
- Place the DLL in the BepInEx plugins folder
- Start the game once to generate the config file
- Adjust the config as needed
- Host a lobby and enter a shop
Supported items
- Orb Battery
- Orb Feather
- Orb Heal
- Orb Indestructible
- Orb Magnet
- Orb Torque
Equip Cube is intentionally not included in this release because a stable, release-safe shop implementation could not be guaranteed from the available runtime behavior and resource information.
Runtime behavior details
Shop-side behavior
The mod injects supported orb items into the normal shop roll flow. It does not create a separate special shop UI. The host decides:
- whether each orb can appear
- its maximum amount in a single shop
- its appearance chance
- its price adjustment
Gameplay-side behavior
The host also applies the following orb runtime rules:
- orb radius override
- individual common battery drain override
- through-wall targeting toggle
- held-only activation toggle
Additional item-specific handling:
- Orb Battery can use a separate extra drain value while charging targets
- Orb Heal can use a custom heal interval and heal amount
- Orb Heal can optionally be treated as a health-pack-slot item
Technical notes
The mod is designed around real in-game item assets and their existing prefab resource paths. That design choice matters because it avoids the visibility issues that happen when network-spawned shop items use synthetic prefab paths that only the host can resolve.
The shop injection is performed on the host. Runtime orb behavior patches are also host-authoritative. This keeps the logic centralized and avoids client-side divergence for shop contents and orb effects.
Compatibility notes
- Mods that heavily rewrite shop candidate generation may conflict
- Mods that modify the same orb classes may override some runtime values
- Mods that patch ItemAttributes pricing may affect final prices
- Mods that change item categories or shop slots may alter where Orb Heal appears when the health-pack option is enabled
Known limitations
- This mod only adds the supported orb items listed above
- Equip Cube is not part of this release
- If another mod forcefully rewrites shop pools after this mod runs, shop appearance may differ from the configured expectation
- If another mod changes orb internals every frame, its values may compete with this mod’s runtime overrides
Troubleshooting
The orbs do not appear in the shop
Check:
- the host has the mod installed
- the item is enabled
- the spawn chance is not 0
- the maximum amount is at least 1
- another shop mod is not overriding the item pools afterward
The orb appears too rarely
Increase:
- the spawn chance
- the max amount Also check whether purchased count subtraction is enabled, because repeated purchases can reduce future availability.
Orb Heal appears in an unexpected shop category
Check:
- Orb Heal Use HealthPack Slot
The effect behavior feels different from expected
Check:
- radius
- individual battery drain
- through-wall setting
- held-only setting
- Orb Battery extra drain
- Orb Heal rate
- Orb Heal amount
Configuration
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Count Purchased Against Max | Subtract purchased count from each item’s per-shop maximum | true | false | true |
| Common Orb Battery Drain Rate | Global fallback common drain rate for orb items | 0.1 | 0 | 100 |
| Orb Battery Extra Drain Rate | Extra drain used while Orb Battery actively charges targets | 1.5 | 0 | 100 |
| Orb Heal Rate | Heal interval in seconds for Orb Heal | 2.0 | 0.01 | 100 |
| Orb Heal Amount | Heal amount per tick for Orb Heal | 10 | 0 | 1000 |
Orb Battery
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Battery Enabled | Allow Orb Battery in shop rolls | true | false | true |
| Orb Battery Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Battery Spawn Chance Percent | Shop appearance chance | 10 | 0 | 100 |
| Orb Battery Price Delta | Added to generated shop price | 0 | -50 | 50 |
| Orb Battery Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Battery Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Battery Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Battery Only Active While Held | Only works while being held | false | false | true |
Orb Feather
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Feather Enabled | Allow Orb Feather in shop rolls | true | false | true |
| Orb Feather Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Feather Spawn Chance Percent | Shop appearance chance | 10 | 0 | 100 |
| Orb Feather Price Delta | Added to generated shop price | 0 | -50 | 50 |
| Orb Feather Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Feather Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Feather Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Feather Only Active While Held | Only works while being held | false | false | true |
Orb Heal
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Heal Enabled | Allow Orb Heal in shop rolls | true | false | true |
| Orb Heal Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Heal Spawn Chance Percent | Shop appearance chance | 10 | 0 | 100 |
| Orb Heal Price Delta | Added to generated shop price | 20 | -50 | 50 |
| Orb Heal Use HealthPack Slot | Treat Orb Heal as a health-pack-slot item | false | false | true |
| Orb Heal Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Heal Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Heal Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Heal Only Active While Held | Only works while being held | false | false | true |
Orb Indestructible
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Indestructible Enabled | Allow Orb Indestructible in shop rolls | true | false | true |
| Orb Indestructible Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Indestructible Spawn Chance Percent | Shop appearance chance | 10 | 0 | 100 |
| Orb Indestructible Price Delta | Added to generated shop price | 0 | -50 | 50 |
| Orb Indestructible Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Indestructible Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Indestructible Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Indestructible Only Active While Held | Only works while being held | false | false | true |
Orb Magnet
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Magnet Enabled | Allow Orb Magnet in shop rolls | true | false | true |
| Orb Magnet Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Magnet Spawn Chance Percent | Shop appearance chance | 10 | 0 | 100 |
| Orb Magnet Price Delta | Added to generated shop price | 20 | -50 | 50 |
| Orb Magnet Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Magnet Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Magnet Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Magnet Only Active While Held | Only works while being held | false | false | true |
Orb Torque
| Setting | Description | Default | Min | Max |
|---|---|---|---|---|
| Orb Torque Enabled | Allow Orb Torque in shop rolls | true | false | true |
| Orb Torque Max Amount In Shop | Maximum possible amount in one shop roll | 1 | 1 | 10 |
| Orb Torque Spawn Chance Percent | Shop appearance chance | 0 | 0 | 100 |
| Orb Torque Price Delta | Added to generated shop price | 0 | -50 | 50 |
| Orb Torque Radius | Effect radius | 1.0 | 0.01 | 100 |
| Orb Torque Battery Drain Rate | Individual common battery drain override | 0.1 | 0 | 100 |
| Orb Torque Allow Through Walls | Allow targeting through walls | true | false | true |
| Orb Torque Only Active While Held | Only works while being held | false | false | true |
Recommended baseline setup
A stable baseline for ordinary runs:
- keep max amount at 1 for every orb
- keep most spawn chances low
- leave Orb Torque at 0 if you do not want it in normal economy balance
- raise Orb Heal and Orb Magnet price if you want them to stay meaningful mid-run purchases
Release notes summary
This release focuses on bringing hidden orb items into the normal shop flow while preserving multiplayer visibility and host-authoritative behavior.
DroneToOrbItem
DroneToOrbItem は隠しオーブ系アイテムをショップに追加し、どのくらい出現するか、いくらで売られるか、購入後にどう動作するかをホストが細かく設定できるMODです。
手動でマップに生成するのではなく、通常のショップ経済の中にオーブ系ユーティリティを自然に組み込みたい場合を想定しています。
既知の問題 :(
以下のタイミングでエラーが出力されますが、MOD自体は正常に動作します。
REPO起動後のMODロード中
部屋作成時
これらのエラーはゲームプレイやMODの機能には影響しません。
次回のアップデートでエラーが出力されないよう修正予定です。
主な機能
- 以下のオーブをショップ抽選に追加
- Orb Battery
- Orb Feather
- Orb Heal
- Orb Indestructible
- Orb Magnet
- Orb Torque
- アイテムごとの出現有効無効
- アイテムごとのショップ最大生成数
- アイテムごとの生成確率
- アイテムごとの価格差分
- アイテムごとの効果範囲
- アイテムごとの共通消費量上書き
- アイテムごとの壁越し判定切り替え
- アイテムごとの持っている時だけ有効切り替え
- Orb Heal をヘルスパック枠扱いにする設定
- ショップ制御とオーブ挙動制御はホスト側で統一
- 合成の偽パスではなく実在のゲーム内アイテムリソースを利用するため、参加者側からも通常のゲームオブジェクトとして表示されやすい構成
動作概要
ショップ生成時に、ホストが対応オーブを通常のショップ候補リストへ注入します。 専用ショップ画面を追加する方式ではありません。 ホストが以下を決定します。
- そのオーブを抽選対象にするか
- 1店舗で何個まで出るか
- どの程度の確率で出るか
- 最終価格にどれだけ補正をかけるか
購入後はホストが半径や消費量などの実動作値も上書きします。
重要な挙動
- ショップ生成はホストが制御
- オーブ挙動もホストが制御
- 参加者がロジックを制御する必要はない
- ゲーム内に実在するアイテムアセットと既存のPrefabリソースを使うため、購入後のオーブが他プレイヤーからも通常オブジェクトとして見える構成を狙っています
必要環境
- BepInEx 5.4.x
- REPO
- ホストへの導入を前提
- トラブル切り分けを容易にするため、参加者側も同じMODバージョンに揃えることを推奨
導入手順
- REPO に BepInEx 5.4.x を導入
- DLL を BepInEx の plugins フォルダへ配置
- 一度ゲームを起動して設定ファイルを生成
- 必要に応じて config を編集
- ホストとしてロビーを開き、ショップへ入る
対応アイテム
- Orb Battery
- Orb Feather
- Orb Heal
- Orb Indestructible
- Orb Magnet
- Orb Torque
Equip Cube は今回のリリース対象外です。 利用可能な安定したショップ実装を、入手できたランタイム挙動とリソース情報だけで保証できなかったためです。
実行時の挙動詳細
ショップ側
通常のショップ抽選に対応オーブを割り込ませます。 専用の販売UIは追加しません。 ホストが以下を制御します。
- そのオーブを出現対象にするか
- そのショップで何個まで出しうるか
- どの程度の確率で出すか
- 最終価格にどれだけ差分を足し引きするか
購入後の挙動側
ホストは以下のオーブ実動作値も制御します。
- 効果半径
- 個別の共通消費量
- 壁越し判定の有無
- 持っている時だけ有効かどうか
個別処理:
- Orb Battery は対象充電時の追加消費量を別設定可能
- Orb Heal は回復間隔と回復量を設定可能
- Orb Heal はヘルスパック枠扱いにも変更可能
技術的な説明
このMODは、ゲーム内に実在する Item アセットとその既存 prefab resource path を利用する方針で組まれています。 これは重要です。 マルチプレイでショップ購入物を同期する際、存在しない合成 prefab path を使うと、ホストでは見えても参加者では解決できず、表示されない原因になりやすいためです。
ショップ注入はホスト側で行われます。 オーブの半径や消費量などの実動作パッチもホスト権限で処理されます。 そのため、ショップ内容やオーブ効果の判定がプレイヤーごとにズレにくい構成です。
互換性に関する注意
- ショップ候補生成を大きく書き換えるMODとは競合する可能性あり
- 同じオーブクラスを毎フレーム書き換えるMODとは値の上書き競合が起きる可能性あり
- ItemAttributes の価格処理を変更するMODとは最終価格が変わる可能性あり
- アイテムカテゴリやショップ枠を変更するMODがあると、Orb Heal の表示枠が想定と変わる場合あり
既知の制限
- 対応するのは README に列挙したオーブのみ
- Equip Cube は含まれない
- 他のMODがこのMODの後でショップ候補を強制上書きすると、想定どおりに出現しない場合がある
- 他のMODがオーブ内部値を常時上書きする場合、半径や消費量の見え方が競合する場合がある
トラブルシュート
ショップに出ない
確認項目:
- ホストにMODが入っているか
- そのオーブが有効か
- 生成確率が 0 ではないか
- 最大生成数が 1 以上か
- 他のショップ系MODが後から候補リストを上書きしていないか
出現頻度が低すぎる
以下を上げてください。
- 生成確率
- 最大生成数
また、購入済み差し引きが ON だと、同一ラン中に繰り返し購入した後の出現可能数が減ります。
Orb Heal の出現枠が想定と違う
以下を確認してください。
- Orb Heal Use HealthPack Slot
効果が想定と違う
以下を確認してください。
- Radius
- Battery Drain Rate
- Allow Through Walls
- Only Active While Held
- Orb Battery Extra Drain Rate
- Orb Heal Rate
- Orb Heal Amount
設定一覧
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Count Purchased Against Max | 購入済み数を各アイテムのショップ最大個数から差し引く | true | false | true |
| Common Orb Battery Drain Rate | オーブ系アイテムの共通消費量の既定値 | 0.1 | 0 | 100 |
| Orb Battery Extra Drain Rate | Orb Battery が対象を充電した時の追加消費量 | 1.5 | 0 | 100 |
| Orb Heal Rate | Orb Heal の回復間隔 秒 | 2.0 | 0.01 | 100 |
| Orb Heal Amount | Orb Heal の1回あたり回復量 | 10 | 0 | 1000 |
Orb Battery
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Battery Enabled | Orb Battery をショップ抽選対象に含めるか | true | false | true |
| Orb Battery Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Battery Spawn Chance Percent | ショップ出現確率 | 10 | 0 | 100 |
| Orb Battery Price Delta | 生成されたショップ価格へ加算減算する差分 | 0 | -50 | 50 |
| Orb Battery Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Battery Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Battery Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Battery Only Active While Held | 持っている時だけ有効にするか | false | false | true |
Orb Feather
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Feather Enabled | Orb Feather をショップ抽選対象に含めるか | true | false | true |
| Orb Feather Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Feather Spawn Chance Percent | ショップ出現確率 | 10 | 0 | 100 |
| Orb Feather Price Delta | 生成されたショップ価格へ加算減算する差分 | 0 | -50 | 50 |
| Orb Feather Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Feather Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Feather Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Feather Only Active While Held | 持っている時だけ有効にするか | false | false | true |
Orb Heal
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Heal Enabled | Orb Heal をショップ抽選対象に含めるか | true | false | true |
| Orb Heal Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Heal Spawn Chance Percent | ショップ出現確率 | 10 | 0 | 100 |
| Orb Heal Price Delta | 生成されたショップ価格へ加算減算する差分 | 20 | -50 | 50 |
| Orb Heal Use HealthPack Slot | Orb Heal をヘルスパック枠扱いにするか | false | false | true |
| Orb Heal Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Heal Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Heal Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Heal Only Active While Held | 持っている時だけ有効にするか | false | false | true |
Orb Indestructible
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Indestructible Enabled | Orb Indestructible をショップ抽選対象に含めるか | true | false | true |
| Orb Indestructible Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Indestructible Spawn Chance Percent | ショップ出現確率 | 10 | 0 | 100 |
| Orb Indestructible Price Delta | 生成されたショップ価格へ加算減算する差分 | 0 | -50 | 50 |
| Orb Indestructible Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Indestructible Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Indestructible Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Indestructible Only Active While Held | 持っている時だけ有効にするか | false | false | true |
Orb Magnet
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Magnet Enabled | Orb Magnet をショップ抽選対象に含めるか | true | false | true |
| Orb Magnet Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Magnet Spawn Chance Percent | ショップ出現確率 | 10 | 0 | 100 |
| Orb Magnet Price Delta | 生成されたショップ価格へ加算減算する差分 | 20 | -50 | 50 |
| Orb Magnet Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Magnet Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Magnet Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Magnet Only Active While Held | 持っている時だけ有効にするか | false | false | true |
Orb Torque
| 設定項目 | 設定項目説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |
|---|---|---|---|---|
| Orb Torque Enabled | Orb Torque をショップ抽選対象に含めるか | true | false | true |
| Orb Torque Max Amount In Shop | 1回のショップ抽選で出現しうる最大個数 | 1 | 1 | 10 |
| Orb Torque Spawn Chance Percent | ショップ出現確率 | 0 | 0 | 100 |
| Orb Torque Price Delta | 生成されたショップ価格へ加算減算する差分 | 0 | -50 | 50 |
| Orb Torque Radius | 効果範囲サイズ | 1.0 | 0.01 | 100 |
| Orb Torque Battery Drain Rate | 各オーブ個別の共通消費量上書き | 0.1 | 0 | 100 |
| Orb Torque Allow Through Walls | 壁越しでも効果を適用するか | true | false | true |
| Orb Torque Only Active While Held | 持っている時だけ有効にするか | false | false | true |
推奨初期運用
通常のプレイで使うなら、次の考え方が扱いやすいです。
- 最大生成数は全オーブ 1 のまま
- 生成確率は低めで維持
- Orb Torque は通常経済に混ぜたくないなら 0 のまま
- Orb Heal と Orb Magnet は価格を高めにして価値を残す
リリース概要
このリリースは、隠しオーブ系アイテムを通常ショップ経済へ自然に組み込むことを目的にしています。 マルチプレイでの表示問題を避けるため、実在のゲーム内 Item アセットと既存 prefab resource path を使う設計を優先しています。
