Selamat datang di dokumentasi teknis untuk c77, sebuah bahasa pemrograman berbasis skrip yang dirancang untuk pembuatan bot interaktif dengan sintaks yang sederhana dan mudah dibaca.

Dokumen ini menjelaskan sintaks dasar, konfigurasi perintah, fungsi bawaan (API), dan struktur kontrol alur.

Label berfungsi sebagai penanda titik awal sebuah blok logika atau fungsi. Sistem akan melompat ke label ini ketika dipanggil oleh event handler atau perintah lompatan.

• Aturan: Nama label wajib diawali dengan tanda titik (.).
• Sintaks: .nama_label
• Contoh:

.fungsi_logika
    print "Logika dimulai di sini"

Komentar digunakan untuk memberikan catatan pada kode program. Bagian ini tidak akan dieksekusi oleh mesin.

• Simbol: Titik koma (;)
• Contoh:

; Ini adalah komentar baris penuh
count = 0 ; Ini komentar di akhir baris

Pendefinisian variabel dilakukan secara dinamis (tanpa tipe data eksplisit).

• String: Teks harus diapit tanda kutip ganda (“).
• Integer: Angka ditulis langsung.
• Operator Penggabungan: Gunakan tanda plus (+) untuk menggabungkan string atau variabel.
• Contoh:

nama = "User"
skor = 100
pesan = "Halo " + nama

Bagian ini digunakan untuk memetakan perintah yang diketik pengguna (Trigger) ke Label logika yang sesuai.

Sintaks: saat_perintah [trigger] lompat [label_tujuan]

Parameter:

1. trigger: Kata kunci perintah (contoh: /start).
2. lompat: Kata kunci wajib (keyword).
3. label_tujuan: Label yang akan dieksekusi saat trigger diterima.

Contoh:

saat_perintah /start lompat .fungsi_start
saat_perintah /menu  lompat .cmd_menu

Berikut adalah daftar fungsi yang tersedia, cara penggunaannya, dan argumen yang dibutuhkan.

Mengirim pesan teks ke pengguna.

• Argumen 1: target_id (Biasanya menggunakan variabel sistem chat_id).
• Argumen 2: pesan (String atau Variabel).
• Contoh:

send chat_id "Halo, selamat datang!"

Mengirim file gambar disertai dengan teks keterangan (caption).

• PENTING: File gambar hanya dibaca dari dalam folder bot_config.
• Argumen 1: target_id
• Argumen 2: path_file (String, lokasi file gambar relatif terhadap bot_config).
• Argumen 3: caption (String, teks keterangan).
• Contoh:

path = "qris.png" ; File harus ada di folder bot_config/qris.png
desc = "Ini adalah menu kami"
send_photo chat_id path desc

Mencetak log ke konsol server. Fungsi ini berguna untuk debugging dan tidak akan terlihat oleh pengguna bot.

• Argumen 1: teks (String/Variabel).
• Contoh:

print "User telah menekan tombol start"

Menunda eksekusi program selama beberapa milidetik (delay).

• Argumen 1: milidetik (Integer).
• Contoh:

sleep 1000 ; Menunggu selama 1 detik

Membaca isi file teks dari penyimpanan lokal dan menyimpannya ke dalam variabel.

• Argumen 1: path_file (String).
• Return: Mengembalikan isi file sebagai String.
• Contoh:

konten = baca_file "catatan.txt"
send chat_id konten

Menulis teks ke dalam file. Jika file tidak ada, akan dibuat. Jika ada, akan ditimpa/ditambah (tergantung implementasi sistem).

• PENTING: File akan otomatis disimpan/ditulis ke dalam folder bot_config.
• Argumen 1: path_file (String).
• Argumen 2: isi_konten (String/Variabel).
• Contoh:

data = "Log aktivitas baru"
tulis_file "log.txt" data ; Akan tersimpan di bot_config/log.txt

Mengatur jalannya logika program, seperti percabangan dan pengulangan.

Memindahkan eksekusi program langsung ke label lain tanpa syarat.

• Sintaks: lompat [label]
• Contoh: lompat .menu_utama

Melakukan lompatan hanya jika kondisi terpenuhi.

• Sintaks: jika [nilai_kiri] [operator] [nilai_kanan] lompat [label]
• Operator:
  • < (Kurang dari)
  • > (Lebih dari)
  • = (Sama dengan)
  • != (Tidak sama dengan)
• Contoh:

count = 0
max = 5
.looping
count = count + 1
jika count < max lompat .looping

Menghentikan eksekusi skrip pada baris tersebut. Wajib diletakkan di akhir setiap blok label agar kode tidak “bocor” (fall-through) ke label di bawahnya.

• Sintaks: stop

Variabel ini disediakan otomatis oleh sistem saat perintah dijalankan. Anda tidak perlu mendeklarasikannya secara manual.

Contoh Penggunaan agrs: Jika pengguna mengetik: /echo halo dunia Maka:

• Command: /echo
• agrs: “halo dunia”

.cmd_echo
    msg = "Anda mengetik: " + agrs
    send chat_id msg
    stop