収集システム / Collectible System【VRChatワールド用・UdonSharp】

VRChat用 コレクティブルシステム

**ライブデモワールド：**

https://vrchat.com/home/launch?worldId=wrld_d0b44bfc-34d3-4493-a9ea-f3b9bfb4f2ea

> VRChatワールド向けの、導入するだけですぐに使えるUdonSharpコレクティブルシステム。進行状況の同期、アニメーションUI、カスタムサウンドに対応し、宝物、秘密の扉、さらには隠しエリア全体など、好きなものをアンロックできます。

---

探索を、みんなで楽しめるクエストに変えましょう。

`Collectible System`は、同期ロジックを一から構築することなく、完成度の高いアイテム収集ゲームプレイを実装したいVRChatワールド制作者向けの、すぐに使えるUdonSharpパッケージです。プレイヤーはマップ内に配置されたアイテムを集め、進行状況はインスタンス内の全プレイヤーで共有されます。最後のアイテムを集めると、設定した報酬が出現します — トロフィー、秘密の扉、テレポート、さらには隠された別空間全体をアンロックすることもできます。

こんな用途に最適：

* 宝探し＆スカベンジャーハント

* 秘密のエリアや隠し通路

* クエスト形式のワールド進行

* イベントワールドやパズル体験

* 「X個のアイテムを集めてYをアンロックする」仕組みが必要なあらゆるワールド

---

### 収録内容

* `CollectibleUnlockManager` — グローバル同期、UI、サウンド、報酬のアンロック

* `CollectibleItem` — 各ピックアップ用スクリプト（VRC Pickup対応）

* すぐに使えるPrefab — `CollectibleSystem`、サンプルコレクティブル、`Reward`、`CanvasCount UI`

* 進行状況UI — グローバルカウンター（`0/5` → `5/5`）+ スムーズにアニメーションするプログレスバー

* 各スポットのラベル — 各収集場所にオプションで配置できるワールド空間テキスト

* オーディオ — アイテム取得音 + 最後のアイテム取得時の専用クリアサウンド

* 完全なドキュメント — `ReadMe.txt` + 商用利用に対応した`License.txt`

---

### 主な機能

✅ **マルチプレイヤー同期** — すべてのプレイヤーが同じ進行状況、消えるアイテム、アンロックされた報酬を確認できます

✅ **柔軟なアイテム数** — 3個、5個、7個、またはそれ以上のコレクティブルを使用可能（5個固定ではありません）

✅ **好きな報酬を設定可能** — 宝箱、扉、ポータル、部屋、親グループなど、任意のGameObjectをアンロック可能

✅ **コレクティブルを自由に変更可能** — コイン、鍵、クリスタル、書類など、VRC Pickupを使用できるものなら何でも利用可能

✅ **スムーズなプログレスバー** — アイテム取得ごとにアニメーションするゲージ

✅ **クリア演出** — 最後のアイテムを集めたときに特別なサウンドを再生

✅ **整理された英語のコードベース** — 読みやすく、変更や拡張も簡単

✅ **商用ライセンス付属** — 無料・有料のVRChatワールドで使用可能

---

### 使い方

1. `CollectibleSystem`をシーンにドラッグ

2. Inspectorでコレクティブルと報酬を設定

3. UdonSharpでコンパイル

4. ワールドを公開

プレイヤーがアイテムを拾うと、そのアイテムは全プレイヤーに対して非表示になり、グローバルカウンターが更新され、プログレスバーがアニメーションします。また、ローカルラベルに収集順を表示することもできます。すべて集めると — 報酬がアンロックされます。

---

### 必要環境

* Unity（VRChat SDK対応プロジェクト）

* VRChat Worlds SDK

* UdonSharp

* UnityのPrefabとVRChatのビルドプロセスに関する基本的な知識

---

### ライセンス

VRChatワールドでの**個人利用および商用利用**が可能です。

完全な利用規約については、付属の`License.txt`をご確認ください。

公開されたワールドでのクレジット表記は歓迎しますが、必須ではありません。

--- eng ---

**Live Demo World:**

https://vrchat.com/home/launch?worldId=wrld_d0b44bfc-34d3-4493-a9ea-f3b9bfb4f2ea

> A drop-in UdonSharp collectible system for VRChat worlds. Synced progress, animated UI, custom sounds, and unlock anything — treasures, secret doors, or entire hidden areas.

---

Turn exploration into a shared quest.

Collectible System is a ready-to-use UdonSharp package for VRChat world creators who want polished collect-a-thon gameplay without building sync logic from scratch. Players pick up items across your map; progress is shared for everyone in the instance. When the final item is collected, your reward appears — a trophy, a secret door, a teleport, or an entire hidden dimension.

Perfect for:

- Treasure hunts & scavenger quests

- Secret areas and hidden passages

- Quest-style world progression

- Event worlds and puzzle experiences

- Any world that needs “collect X items to unlock Y”

---

### What you get

- CollectibleUnlockManager — global sync, UI, sounds, and reward unlock

- CollectibleItem — per-pickup script (works with VRC Pickup)

- Ready-made prefabs — CollectibleSystem, example collectibles, Reward, CanvasCount UI

- Progress UI — global counter (`0/5` → `5/5`) + smooth animated fill bar

- Per-spot labels — optional world-space text at each collect location

- Audio — collect sound + separate victory sound on the last pickup

- Full documentation — ReadMe.txt + commercial-friendly License.txt

---

### Key features

✅ Multiplayer synced — all players see the same progress, disappearing items, and unlocked reward

✅ Flexible item count — use 3, 5, 7, or more collectibles (not hardcoded to 5)

✅ Any reward you want — unlock any GameObject: chest, door, portal, room, or parent group

✅ Swap any collectible — coins, keys, crystals, documents — anything with VRC Pickup

✅ Smooth progress bar — animated fill on each pickup

✅ Victory moment — special sound when the last item is collected

✅ Clean English codebase — easy to read, modify, and extend

✅ Commercial license included — use in free and paid VRChat worlds

---

### How it works

1. Drag CollectibleSystem into your scene

2. Assign your collectibles and reward in the Inspector

3. Compile with UdonSharp

4. Publish your world

When a player picks up an item, it hides for everyone, the global counter updates, the progress bar animates, and local labels can show collection order. Complete the set — reward unlocked.

---

### Requirements

- Unity (VRChat SDK compatible project)

- VRChat Worlds SDK

- UdonSharp

- Basic familiarity with Unity prefabs and the VRChat build process

---

### License

Personal and commercial use allowed in VRChat worlds.

See included License.txt for full terms.

Attribution appreciated but not required for published worlds.