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

# Perintah cadangan

> Grup perintah /backup — buat, daftar, periksa, pulihkan, jadwalkan, ekspor, impor, dan bersihkan cadangan server Anda dari Discord.

`/backup` menjalankan [Cadangan Server](/id/server-management/server-backup) dari dalam Discord. Satu perintah, **tiga belas subperintah**.

| Persyaratan     | Nilai                                                              |
| --------------- | ------------------------------------------------------------------ |
| **Anda perlu**  | Manage Server                                                      |
| **Vetox perlu** | View Channel, Read Message History — plus lainnya untuk memulihkan |
| **Cooldown**    | 5 dtk                                                              |
| **Di mana**     | Hanya di server. Tidak tersedia di DM                              |

<Warning>
  **Setiap balasan `/backup` bersifat ephemeral — hanya Anda yang melihatnya.** Sebuah ID cadangan adalah kunci menuju isi server Anda, jadi Vetox tidak pernah memposting ID itu di tempat yang bisa dibaca anggota lain.
</Warning>

<Note>
  Setiap subperintah dapat dinonaktifkan atau dibatasi ke role dan channel tertentu satu per satu, melalui [Command Management](/id/server-management/command-management). `/backup create` bisa terbuka untuk admin Anda sementara `/backup load` dimatikan sepenuhnya.
</Note>

## Membuat dan memeriksa

<AccordionGroup>
  <Accordion title="/backup create — ambil sebuah cadangan" icon="camera">
    | Opsi       | Wajib | Catatan                                             |
    | ---------- | ----- | --------------------------------------------------- |
    | `name`     | Tidak | Hingga 64 karakter. Nama membuatnya mudah ditemukan |
    | `messages` | Tidak | 0–250, dibatasi pada maksimum paket Anda            |

    Bagian premium disertakan otomatis sampai batas yang diizinkan paket Anda. Balasannya membawa ID cadangan yang baru lalu diperbarui dengan progresnya. Ketika cadangan selesai, balasannya menampilkan **ID**-nya, dua perintah untuk memakainya (`/backup info` dan `/backup load`), dan sebuah tautan ke cadangan itu di dasbor — serta, di Starter, pengingat bahwa pesan, data anggota, ban, dan lampiran tidak disimpan.

    <Note>
      Satu cadangan manual per server setiap **10 menit**, dan satu proses cadangan atau pemulihan dalam satu waktu. Membuat cadangan membutuhkan izin Administrator, dan di bawah [level izin](/id/server-management/server-backup#izin) **Hanya pemilik**, hanya pemiliknya seorang diri.
    </Note>
  </Accordion>

  <Accordion title="/backup list — lihat cadangan Anda" icon="list">
    | Opsi    | Wajib | Catatan                                                                                            |
    | ------- | ----- | -------------------------------------------------------------------------------------------------- |
    | `page`  | Tidak | Mulai dari 1. Dua puluh baris per halaman                                                          |
    | `scope` | Tidak | **Server ini** (default), **Cadangan channel server ini**, atau **Cadangan saya di setiap server** |

    Terbaru lebih dulu. Cadangan otomatis dan pengaman ditandai sehingga Anda dapat membedakannya sekilas. `scope:mine` mendaftar setiap cadangan yang Anda buat, di server mana pun, beserta server asalnya — inilah caranya menemukan ID sebuah cadangan yang Anda ambil di tempat lain sebelum memuatnya di sini.
  </Accordion>

  <Accordion title="/backup info — isi sebuah cadangan" icon="circle-info">
    | Opsi        | Wajib  | Catatan                                  |
    | ----------- | ------ | ---------------------------------------- |
    | `backup_id` | **Ya** | Memiliki autocomplete saat Anda mengetik |

    Jumlah, opsi saat ia ditangkap, ukurannya, channel tersibuk, peringatan apa pun, apakah ia terkunci oleh paket Anda, dan sebuah tautan ke cadangan itu di Penampil Snapshot pada dasbor — tempat Anda dapat membaca setiap channel, role, pengaturan, ban, dan anggota yang dimuatnya.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` memiliki autocomplete pada setiap subperintah yang menerimanya, jadi Anda tidak pernah perlu menyalin sebuah ID dengan tangan. Ia hanya menawarkan cadangan yang boleh Anda gunakan.
</Tip>

## Memulihkan

<AccordionGroup>
  <Accordion title="/backup load — pulihkan sebuah cadangan" icon="rotate-left">
    | Opsi        | Wajib  | Catatan                                                                |
    | ----------- | ------ | ---------------------------------------------------------------------- |
    | `backup_id` | **Ya** | Memiliki autocomplete, termasuk cadangan Anda sendiri dari server lain |
    | `messages`  | Tidak  | 0–250, dibatasi pada maksimum paket Anda                               |
    | `options`   | Tidak  | Hingga 200 karakter. Lihat tata bahasanya di bawah                     |

    Tidak ada yang dipulihkan pada penekanan pertama. Vetox membalas dengan **rencananya** — berapa banyak channel dan role yang akan dihapus dan dibuat, serta apakah ada role yang berada di atas role Vetox sendiri sehingga tidak dapat disentuh — di balik tombol **Konfirmasi** dan **Batal** yang kedaluwarsa setelah **60 detik**. Hanya setelah Konfirmasi barulah Vetox mengambil salinan pengaman dan memulai pemulihan.

    <Warning>
      Memuat sebuah cadangan mengganti channel dan role server ini. Anggota tidak pernah dikeluarkan, tetapi apa pun yang dibuat setelah cadangan diambil akan hilang.
    </Warning>

    <Note>
      `/backup load` mematuhi [level izin](/id/server-management/server-backup#izin) server. Di bawah default **Admin tidak dapat melakukan aksi destruktif**, siapa pun selain pemilik ditolak bahkan dengan Administrator.
    </Note>

    <Note>
      Pemulihan dan pengembalian dijatah harian — **10 per server**, **20 per orang**. `/backup load`, `/backup channel load`, dan mengembalikan sebuah perubahan terlacak masing-masing dihitung terhadap keduanya; melanjutkan pemulihan yang gagal tidak dihitung.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — hentikan proses yang berjalan" icon="ban">
    Tanpa opsi. Membatalkan proses cadangan atau pemulihan yang aktif di server ini. Checkpoint-nya tetap disimpan, jadi pemulihan yang dibatalkan masih dapat dilanjutkan dari dasbor.
  </Accordion>

  <Accordion title="/backup status — apa yang sedang berjalan, dan batas yang sedang aktif" icon="heart-pulse">
    Tanpa opsi. Menampilkan proses yang sedang berjalan di server ini (jenis, fase, progres, peringatan, kapan ia dimulai) atau bahwa tidak ada yang berjalan; kapan cadangan manual berikutnya dimungkinkan jika cooldown 10 menit sedang aktif; kapan **batas pembuatan dari Discord** dicabut jika sebuah pemulihan menabraknya; dan, ketika tidak ada yang berjalan, mengapa proses terakhir berhenti serta apakah ia dapat dilanjutkan dari dasbor.
  </Accordion>
</AccordionGroup>

### Tata bahasa `options`

`options` adalah daftar token yang dipisahkan spasi, diterapkan **dari kiri ke kanan**.

| Token                                                                                                      | Efek                          |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Mengaktifkan bagian tersebut  |
| `!` sebelum salah satunya — `!members`                                                                     | Menonaktifkan bagian tersebut |
| `*`                                                                                                        | Mengaktifkan **semuanya**     |
| `!*`                                                                                                       | Menonaktifkan **semuanya**    |

Hilangkan `options` sepenuhnya dan Vetox memakai defaultnya: **`delete-channels channels delete-roles roles settings`** — penggantian struktural penuh, tanpa anggota, ban, pin, emoji, atau stiker.

| Contoh                                   | Hasil                                                                  |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| `options:!* roles delete-roles`          | Hanya role — menghapus role saat ini, membuat ulang role dari cadangan |
| `options:!* channels roles settings`     | Struktur, ditambahkan ke yang sudah ada — tidak ada yang dihapus       |
| `options:* !members !bans`               | Semuanya kecuali data anggota dan ban                                  |
| `options:!delete-channels !delete-roles` | Default, dijadikan tambahan                                            |

<Warning>
  **Urutan itu penting.** `* !members` mengaktifkan semuanya lalu mematikan anggota. `!members *` mematikan anggota lalu menyalakan semuanya kembali, termasuk anggota. Baca daftar token Anda dari kiri ke kanan.
</Warning>

<Note>
  Token tidak pernah dapat memperluas apa yang diizinkan paket Anda — batas paket diterapkan paling akhir. Token yang tidak dikenal ditolak dengan menyebut namanya alih-alih diabaikan, sehingga sebuah salah ketik tidak pernah dibuang diam-diam.
</Note>

## Penjadwalan

<AccordionGroup>
  <Accordion title="/backup interval — cadangan otomatis" icon="clock">
    | Opsi       | Wajib  | Catatan                                                |
    | ---------- | ------ | ------------------------------------------------------ |
    | `mode`     | **Ya** | `on`, `off`, atau `status`                             |
    | `interval` | Tidak  | 4 jam, 8 jam, 12 jam, 24 jam, 2 hari, 3 hari, 1 minggu |
    | `messages` | Tidak  | 0–250, dibatasi pada maksimum paket Anda               |

    `status` melaporkan jadwal saat ini tanpa mengubahnya: intervalnya, berapa banyak yang disimpan, jalannya yang terakhir dan berikutnya, serta ID cadangan otomatis yang terbaru. Menyalakan jadwalnya memberi tahu Anda kapan cadangan pertama akan berjalan.

    <Note>
      Interval yang lebih pendek daripada yang diizinkan paket Anda akan ditolak, dan penolakannya menyebutkan minimum paket Anda dalam jam. Cadangan otomatis berotasi: yang terlama di luar jumlah yang disimpan paket Anda dihapus saat yang baru tiba.
    </Note>
  </Accordion>
</AccordionGroup>

## Cadangan channel

<AccordionGroup>
  <Accordion title="/backup channel create — cadangkan satu channel" icon="hashtag">
    | Opsi       | Wajib | Catatan                                                      |
    | ---------- | ----- | ------------------------------------------------------------ |
    | `channel`  | Tidak | Teks, announcement, atau thread. Default ke channel saat ini |
    | `messages` | Tidak | 0–1000, dibatasi pada maksimum paket Anda                    |
    | `before`   | Tidak | Sebuah ID pesan. Menyimpan pesan **sebelum** pesan itu       |

    <Tip>
      `before` adalah caranya menjangkau lebih jauh ke belakang daripada yang diizinkan satu kali jalan: ambil sebuah cadangan channel, lalu ambil satu lagi dengan `before` diatur ke ID pesan terlama yang dicapai cadangan pertama.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — posting ke sebuah channel" icon="paste">
    | Opsi        | Wajib  | Catatan                                             |
    | ----------- | ------ | --------------------------------------------------- |
    | `backup_id` | **Ya** | Autocomplete-nya hanya menampilkan cadangan channel |
    | `channel`   | Tidak  | Tempat memposting. Default ke channel saat ini      |
    | `messages`  | Tidak  | 0–1000, dibatasi pada maksimum paket Anda           |

    Pesan diposting mulai dari yang terlama, beserta pin-nya.

    <Note>
      **Tidak ada yang dihapus.** Pesan yang tersimpan ditambahkan ke apa pun yang sudah ada di channel. Cadangan channel yang besar butuh waktu — balasannya melaporkan progres sambil berjalan.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Cadangan channel memerlukan **Basic** atau lebih tinggi.
</Info>

## Memindahkan cadangan

<AccordionGroup>
  <Accordion title="/backup export — unduh sebagai JSON" icon="file-export">
    | Opsi        | Wajib  | Catatan               |
    | ----------- | ------ | --------------------- |
    | `backup_id` | **Ya** | Memiliki autocomplete |

    Mengirim cadangan sebagai berkas `.json` berformat Discord yang dilampirkan pada balasan ephemeral. Di atas **8 MB** Anda mendapat tautan dasbor sebagai gantinya.

    <Note>
      Ekspor membawa server, role, channel, emoji, dan stiker. **Pesan, anggota, dan ban tidak disertakan** — pulihkan cadangannya untuk memindahkan semua itu. Ekspor bekerja di setiap paket.
    </Note>
  </Accordion>

  <Accordion title="/backup import — bangun cadangan dari sebuah berkas" icon="file-import">
    | Opsi   | Wajib  | Catatan                                              |
    | ------ | ------ | ---------------------------------------------------- |
    | `file` | **Ya** | Sebuah `.json` server berformat Discord, hingga 5 MB |

    Vetox memvalidasi berkasnya, mengubahnya menjadi sebuah cadangan, lalu membalas dengan ID-nya. Pulihkan atau periksa seperti cadangan lainnya.

    <Warning>
      Berkas yang tidak mengikuti format server Discord ditolak sepenuhnya, dengan menyebutkan field pertama yang gagal. Vetox tidak pernah menerapkannya setengah-setengah.
    </Warning>

    <Info>
      Impor memerlukan **Basic** atau lebih tinggi.
    </Info>
  </Accordion>
</AccordionGroup>

## Menghapus

<AccordionGroup>
  <Accordion title="/backup delete — hapus satu cadangan" icon="trash">
    | Opsi        | Wajib  | Catatan               |
    | ----------- | ------ | --------------------- |
    | `backup_id` | **Ya** | Memiliki autocomplete |

    Meminta **Konfirmasi** terlebih dahulu. Menghapus akan membuang snapshot beserta setiap berkas yang tersimpan bersamanya, seketika dan permanen.
  </Accordion>

  <Accordion title="/backup purge — hapus setiap cadangan" icon="dumpster-fire">
    Tanpa opsi. Meminta **Konfirmasi**, lalu menghapus **setiap** cadangan server ini beserta berkas yang tersimpan bersamanya.

    <Warning>
      Tidak ada pembatalan dan tidak ada tempat sampah. Ekspor dulu apa pun yang ingin Anda simpan.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` dan `/backup purge` adalah aksi destruktif menurut [level izin](/id/server-management/server-backup#izin) server, jadi di bawah level default keduanya menjadi hak pemilik seorang diri.
</Note>

## Contoh

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## Ketika sebuah perintah ditolak

Vetox selalu menyebutkan alasannya. Yang umum:

| Balasannya berbunyi                                                                 | Apa yang harus dilakukan                                                                                                                                                 |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Cadangan sudah dibuat di sini baru-baru ini                                         | Tunggu berakhirnya cooldown pembuatan 10 menit per server                                                                                                                |
| Proses cadangan lain sedang berjalan                                                | Tunggu, atau jalankan `/backup cancel`                                                                                                                                   |
| Batas harian untuk pemulihan dan pengembalian telah tercapai                        | Server ini atau akun Anda telah menghabiskan jatah hariannya, 10 per server / 20 per orang. Coba lagi besok                                                              |
| Anda telah mencapai batas cadangan paket Anda                                       | Hapus satu, atau tingkatkan paket                                                                                                                                        |
| Cadangan ini melampaui batas paket Anda                                             | Ia terkunci oleh sebuah downgrade. Hapus cadangan yang lebih baru atau tingkatkan paket                                                                                  |
| Hanya orang yang diizinkan oleh izin cadangan server yang dapat melakukan ini       | Level izin server menyerahkan hal ini kepada pemilik. Pemiliknya bertindak, atau mengubah levelnya di bawah Pengaturan → Izin                                            |
| Interval itu lebih pendek daripada yang diizinkan paket Anda                        | Gunakan minimum yang disebutkan pesannya, atau tingkatkan paket                                                                                                          |
| Salah satu opsi yang dipilih tidak valid                                            | Sebuah token `options` yang tidak dikenal — periksa terhadap tata bahasa di atas                                                                                         |
| Vetox kekurangan izin yang dibutuhkannya                                            | Berikan Administrator kepada Vetox dan pindahkan role-nya ke atas role yang sedang dipulihkan                                                                            |
| Discord hanya mengizinkan sebuah bot membuat 250 role atau 500 channel dalam 48 jam | Batas pembuatan milik Discord sendiri. `/backup status` menampilkan kapan batas itu dicabut; tunggu lalu lanjutkan, atau muat lagi dengan `options:!delete-roles !roles` |
| Berkas itu bukan ekspor server Discord yang valid                                   | Berkas impor tidak cocok dengan format Discord                                                                                                                           |
| Cadangan Server untuk sementara tidak tersedia                                      | Dijeda untuk pemeliharaan. Cadangan Anda tidak tersentuh                                                                                                                 |

## Terkait

<CardGroup cols={2}>
  <Card title="Cadangan Server" icon="server" href="/id/server-management/server-backup">
    Fitur lengkapnya — pemulihan, jadwal, pelacakan perubahan, dan Time Machine.
  </Card>

  <Card title="Cadangan Saya" icon="box-archive" href="/id/members/my-backups">
    Cadangan Anda di setiap server.
  </Card>

  <Card title="Command Management" icon="sliders" href="/id/server-management/command-management">
    Nonaktifkan atau batasi setiap subperintah satu per satu.
  </Card>

  <Card title="Referensi perintah" icon="terminal" href="/id/commands/overview">
    Cara kerja izin dan cooldown di seluruh perintah.
  </Card>
</CardGroup>