🚀Quick‑Start Overview

BulletHell Elemental Template v1.4 ships with three backend options so you can pick the balance of security, scalability, and setup effort that best matches your project:

Backend	Local Data Protection	Remote Validation	Connectivity	Complexity	Recommended For
Offline	AES‑encrypted PlayerPrefs keep local saves tamper‑resistant	— (no external server)	100 % offline	Low	Game jams, prototypes, single‑player titles
Firebase	Same AES‑encrypted PlayerPrefs	Cloud Firestore double‑checks currency balance and purchases	Requires Firebase Auth + Firestore	Medium	Cross‑platform projects that need cloud save & social features
WebSocket + SQL	AES‑encrypted PlayerPrefs used only for UI display	All writes validated by custom Node.js + MySQL server	Self‑hosted (Colyseus)	High	Live‑ops, custom rule sets, full control over backend logic

Tip – You can switch backend any time via BackendSettings.asset.

---

🔄 Switching Backends in Unity

1. Open the Login scene.

2. Select the BackendBootstrap object in the Hierarchy.

3. In the Inspector, choose Offline, Firebase, or WebSocket SQL from the Backend Selection dropdown.

4. Press Play – the template auto‑configures the selected pipeline.

---

🔐 How Security Works

• Local Encryption – All backends use the same symmetric encryption layer for PlayerPrefs, making casual tampering on a local machine difficult.

• Firebase Validation – Each purchase call checks the current coin/gem balance in Firestore before committing, preventing hacked clients from spending negative balances.

• WebSocket Server Validation – The client only displays cached values; the authoritative balance lives on the Node.js server. Any modified local data is ignored if not confirmed by the server.

Threat Scenario	Offline	Firebase	WebSocket + SQL
Player hex‑edits local currency	Balance immediately changes (cheat succeeds)	Overwritten next sync (server wins)	Ignored; server balance stays authoritative
Packet replay / forged purchase	n/a (offline)	Mitigated by Firestore rules	Mitigated by Colyseus route validation
DDOS / Scaling	n/a	Auto‑scales on Google infra	Responsibility of your host

---

📈 Choosing the Right Backend

If you need…	Choose
Zero server costs, instant play‑testing	Offline
Built‑in Auth, basic cloud save, leaderboards	Firebase
Custom game logic, SQL queries, full control	WebSocket + SQL

---

➡️ Next Steps

• Follow the dedicated setup pages:

  • Offline Backend (5 min)

  • Firebase Backend (15 – 20 min)

  • WebSocket + SQL Backend (30 min+)

• Join our community if you have questions:

  • Discord: https://discord.com/invite/EGGj77g3eQ

  • Email : [e-mail]

Happy developing and may your bullet patterns be ever in your favor!