HoyoDash 🌟

HoyoDash adalah sebuah dashboard interaktif berbasis web yang elegan dan modern untuk memantau statistik akun game HoYoverse Anda (Genshin Impact, Honkai: Star Rail, Honkai Impact 3rd, dan Zenless Zone Zero) dalam satu tempat.

Aplikasi ini menggunakan teknologi Laravel, Livewire, Alpine.js, dan didesain secara khusus menggunakan Tailwind CSS untuk memberikan antarmuka pengguna (user interface) bergaya transparan (glassmorphism) yang indah dan mulus.

---

🔥 Fitur Utama

• Multi-Game Support: Mendukung data dari berbagai game HoYoverse secara langsung menggunakan API internal HoYoLAB.
• Login via Cookie: Tidak perlu memasukkan password. Cukup berikan cookie HoYoLAB browser Anda untuk mendapatkan akses yang aman secara read-only karena seluruh data Anda hanya disimpan di local storage Anda sendiri.
• Daily Note (Real-Time): Pantau Original Resin, Trailblaze Power, Expeditions, Realm Currency/Serenitea Pot, serta Parametric Transformer tanpa harus membuka game.
• Game Stats Overview: Lihat ringkasan akun Anda (Level, Spiral Abyss, jumlah karakter, peti yang diklaim, persentase eksplorasi map, hingga penyelesaian quest).
• Koleksi Karakter: Tinjau karakter-karakter yang Anda miliki beserta Weapon dan Relik-nya.
• Event Calendar: Dapatkan pemberitahuan mengenai Event Wishes terbaru dan overview dari semua event yang saat ini sedang berlangsung di tiap game.
• Dark Mode Modern Aesthetic: Desain warna bernuansa gradasi neon dengan fokus visual UX yang detail dan terkesan eksklusif.

---

🛠️ Tech Stack

• Laravel 12.x: Framework mumpuni pada sisi server backend (PHP).
• Livewire 4: Untuk membuat antarmuka web dinamis (Single Page Application feel) tanpa harus menulis banyak Vanilla JavaScript atau Vue/React.
• Alpine.js: Untuk interaksi UI minimalis yang efisien dan responsif (dropdown, akordion, tabulasi, dsb).
• Tailwind CSS: Sistem styling utilitas Utility-First CSS super-cepat dengan kapabilitas desain kustom tanpa hambatan.
• Guzzle / cURL: Library backend untuk menyambungkan permintaan (request) ke Endpoint Rest API resmi dari HoYoLAB (via api-os.hoyolab.com).

---

🚀 Instalasi & Persiapan

1. Clone repositori ini:

   git clone https://github.com/akumano/hoyodash.git
   cd hoyodash

2. Instal dependensi Composer dan NPM:

   composer install
   npm install

3. Salin environment variable (Env) file:

   cp .env.example .env

4. Kompilasi frontend assets:

   npm run build

   (Atau jalankan npm run dev jika Anda ingin sambil memodifikasi tampilannya).

5. Generate Kunci Aplikasi (App Key):

   php artisan key:generate

6. Jalankan Server Lokal:

   php artisan serve

   Kini Anda dapat membuka: http://localhost:8000 di peramban Anda.

---

🍪 Cara Login (Mendapatkan HoYoLAB Cookie)

Proyek ini tidak menyimpan data sensitif Anda ke database server lokal. Aplikasi hanya berjalan sebagai saluran langsung antara Browser Anda dan API dari HoYoverse.

1. Buka situs www.hoyolab.com dan selesaikan Log in.
2. Klik kanan untuk membuka Developer Tools (atau tekan Ctrl+Shift+I / F12 lalu klik Inspect).
3. Buka tab berjudul Application.
4. Di panel sebelah kiri, temukan opsi Storage > Cookies, lalu pilih https://www.hoyolab.com.
5. Cari key berikut dan salin isi tiap valuenya: account_id_v2, account_mid_v2, cookie_token_v2, ltmid_v2, ltoken_v2, ltuid_v2
6. Susun dan tempel di formulir Login HoyoDash menggunakan format seperti ini: account_id_v2=XXXX; account_mid_v2=XXXX; cookie_token_v2=XXXX; ltmid_v2=XXXX; ltoken_v2=XXXX; ltuid_v2=XXXX;

---

👨‍💻 Kontribusi

Segala bentuk Issues dan Pull Requests sangat dipersilakan untuk memperluas kapabilitas dari HoYoDash. Semua kontribusi Anda akan saya jadikan evaluasi.

📝 Lisensi

Proyek HoyoDash adalah perangkat lunak sumber terbuka (Open Source) yang dilisensikan di bawah Lisensi MIT. Data game Genshin Impact, Honkai: Star Rail, Zenless Zone Zero, serta maskot yang bersangkutan adalah properti terdaftar yang dimiliki oleh COGNOSPHERE PTE. LTD. / HoYoverse.