> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arqonara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrasi Database (MySQL/MariaDB)

> Panduan menghubungkan plugin Minecraft (LuckPerms/CoreProtect) ke database MySQL untuk performa maksimal.

# Integrasi Database (MySQL/MariaDB)

Menggunakan database eksternal (MySQL/MariaDB) sangat disarankan untuk server dengan banyak pemain. Ini membuat plugin seperti **LuckPerms**, **CoreProtect**, atau **LiteBans** berjalan jauh lebih cepat dibandingkan menggunakan file lokal (H2/SQLite).

## 1. Membuat Database di Panel

Langkah pertama adalah menyiapkan database melalui panel kontrol Arqonara.

1. Masuk ke **Game Panel Arqonara**. [panel.arqonara.com](https://panel.arqonara.com)
2. Pilih server Anda, lalu navigasi ke tab **Databases** di sidebar kiri atau akses langsung via:
   `https://panel.arqonara.com/server/<idserver>/databases`
3. Klik tombol **New Database**.
4. Beri nama database (contoh: `server_data`) dan klik **Create Database**.

## 2. Mengambil Detail Koneksi

Setelah database berhasil dibuat, Anda perlu mengambil informasi kredensial untuk dimasukkan ke konfigurasi plugin.

1. Klik tombol **Settings** (ikon kunci/gear) atau **Detail** pada database yang baru dibuat.
2. Salin informasi berikut:
   * **Endpoint / Host**: Alamat IP database.
   * **Database Name**: Nama database unik yang tertera.
   * **Username**: Nama pengguna database.
   * **Password**: Klik ikon mata untuk melihat password.

## 3. Implementasi ke Plugin

Hampir semua plugin Minecraft menggunakan format konfigurasi yang sama. Cari bagian `storage-method` atau `database` di file `config.yml` plugin terkait.

**Contoh Konfigurasi (LuckPerms/CoreProtect):**

```yaml theme={null}
storage-method: MySQL

data:
  address: "MASUKKAN_ENDPOINT_DISINI"
  database: "MASUKKAN_DATABASE_NAME_DISINI"
  username: "MASUKKAN_USERNAME_DISINI"
  password: "MASUKKAN_PASSWORD_DISINI"
  maximum-pool-size: 10
```

## 4. Simpan & Restart

1. Klik **Save Content** setelah memasukkan detail database dengan benar.
2. **Restart** server Anda melalui Console.
3. Periksa log startup. Jika muncul pesan `Connected to MySQL database`, berarti integrasi berhasil.

***

## Keuntungan Menggunakan Database

* **Kecepatan Tinggi:** Query data (seperti cek log CoreProtect) menjadi instan meskipun data sudah jutaan baris.
* **Sync Data:** Anda bisa menghubungkan banyak server (BungeeCord/Velocity) ke satu database yang sama agar Rank/Uang pemain sinkron di semua sub-server.
* **Keamanan:** Data tersimpan di sistem database khusus yang terpisah dari file server Minecraft Anda.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Error: Access Denied?">
    Pastikan Username dan Password yang Anda masukkan persis sama dengan yang tertera di tab Databases. Jangan ada spasi tambahan.
  </Accordion>

  <Accordion title="Error: Connection Refused/Timeout?">
    Periksa bagian **Endpoint/Address**. Pastikan host dan port (biasanya 3306) sudah benar.
  </Accordion>
</AccordionGroup>

***

<Card icon="headset" href="/support" title="Gagal Menghubungkan?">
  Jika database Anda tidak mau tersambung, tim support kami siap membantu pengecekan konfigurasi.
</Card>

***

Penulis: Dzakiri - Sekretaris official Arqonara