API skrip
Tampilkan, buat, ubah, unggah kode, dan hapus skrip, serta pantau build-nya.
Skrip dimiliki satu proyek. Route ini menampilkan, membuat, mengubah, dan menghapus skrip, mengunggah kode baru, dan memantau build yang mengubah kode menjadi skrip terlindungi yang dimuat pemain. Apa pun yang mengubah skrip memerlukan kunci dengan scope scripts:write (Akses penuh memilikinya); membaca tidak perlu scope.
Membaca tetap memerlukan kunci API developer aktif, tetapi tidak memerlukan scope scripts:write.
Membaca skrip
GET /v3/projects/:id/scripts
Mengembalikan scripts, dari yang terlama. GET /v3/projects/:id/scripts/:script_id mengembalikan satu script. Skrip yang tidak ada di proyek ini, sudah dihapus, atau tidak ada dijawab 404 SCRIPT_NOT_FOUND.
Sebuah skrip memiliki script_id, script_name, project_id, enabled (kill switch), paused_reason (null, atau alasan Luaward mematikannya: plan, owner, ban), version, pengaturan ffa, silent, heartbeat, lightning, preset (max, balanced, atau fast) dan auto_rebuild, loader_url serta loadstring (yang ditempel pemain di runtime), current_build (build_id, version, status), stable_build_id, created_at, dan updated_at.
Membuat skrip
POST /v3/projects/:id/scripts
| Field | Aturan |
|---|---|
| name | Wajib. 1 sampai 60 karakter. |
| script | Wajib (source juga bisa). Kodenya, hingga 2.000.000 karakter. |
| ffa, silent, heartbeat, lightning, auto_rebuild | Opsional, true atau false. ffa membuat skrip tanpa kunci. |
| preset | Opsional: max, balanced (bawaan), atau fast. |
curl -X POST "https://api.luaward.com/v3/projects/PROJECT_ID/scripts" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Arena","script":"print(\"hello\")","ffa":false,"preset":"balanced"}'Jawabannya 202 dengan script_id, build_id, version (1), status queued, dan script: kode disimpan tersegel dan build masuk antrean, belum selesai. Pantau dengan route build di bawah. Penolakan: 403 PLAN_LIMIT di batas skrip plan, 404 PROJECT_NOT_FOUND, 429 TOO_MANY_BUILDS saat workspace sudah punya beberapa build menunggu, 503 UNAVAILABLE jika API tidak bisa menjangkau layanan build. Body untuk dua route kode ini boleh hingga 4 MiB. Default adalah 16 KiB; route kunci bulk mengizinkan 512 KiB.
Mengunggah kode baru
PUT /v3/projects/:id/scripts/:script_id
Kirim script (atau source) dan, jika mau, pengaturan apa pun. Versi naik satu dan build baru masuk antrean; pemain tetap memakai build lama sampai yang baru siap. Pengaturan yang dikirim bersama kode berlaku untuk build yang sama. Dua unggahan bersamaan mendapat dua versi. Jawabannya 202 dengan script_id, build_id, version, dan status queued.
Memantau build
GET /v3/projects/:id/scripts/:script_id/builds
Mengembalikan builds, dari yang terbaru (limit 1 sampai 50, bawaan 20). GET …/builds/:build_id mengembalikan satu build: build_id, version, status (queued, building, ready, atau failed), error (pesan kompiler saat gagal), size_bytes, is_stable, current (pemain mendapat yang ini), created_at, dan finished_at. Build butuh beberapa detik sampai menit; cek setiap beberapa detik:
build_id=BUILD_ID
build_deadline=$((SECONDS + 180))
build_status=""
while (( SECONDS < build_deadline )); do
build_remaining=$((build_deadline - SECONDS))
(( build_remaining > 15 )) && build_remaining=15
build_response=$(curl --fail-with-body --silent --show-error --connect-timeout 5 --max-time "$build_remaining" \
-H "Authorization: Bearer $LUAWARD_API_KEY" \
"https://api.luaward.com/v3/projects/PROJECT_ID/scripts/SCRIPT_ID/builds/$build_id") || exit 1
build_status=$(printf '%s' "$build_response" | jq -er '.build.status') || exit 1
case "$build_status" in
ready) printf '%s\n' "$build_response"; break ;;
failed) printf '%s\n' "$build_response" | jq -r '.build.error // "Build failed"' >&2; exit 1 ;;
queued|building)
build_remaining=$((build_deadline - SECONDS))
(( build_remaining > 0 )) || break
(( build_remaining > 3 )) && build_remaining=3
sleep "$build_remaining" ;;
*) printf 'Unexpected build status: %s\n' "$build_status" >&2; exit 1 ;;
esac
done
if [[ "$build_status" != ready ]]; then
printf 'Build did not finish within 180 seconds\n' >&2
exit 1
fiMengubah skrip
PATCH /v3/projects/:id/scripts/:script_id
Salah satu dari name, enabled (kill switch), dan pengaturan; minimal satu. Menyalakan skrip membutuhkan ruang di plan (403 PLAN_LIMIT). Skrip yang dimatikan Luaward sendiri (paused_reason owner atau ban) tidak bisa dinyalakan di sini (403 SCRIPT_LOCKED). Mengubah preset atau lightning mengubah hasil yang dilindungi, jadi build baru masuk antrean: jawaban memuat rebuilding true dengan build_id-nya; pengaturan lain berlaku seketika.
Memutar balik
POST /v3/projects/:id/scripts/:script_id/rollback
{ "build_id": "0123456789abcdef0123456789abcdef" }Menyajikan kembali build ready sebelumnya. Build yang belum selesai dijawab 400 BUILD_NOT_READY; yang bukan milik skrip ini, 404 BUILD_NOT_FOUND.
Menghapus dan memulihkan
DELETE /v3/projects/:id/scripts/:script_id
Ini soft delete: permintaan loader baru ditolak dan record skrip disimpan. POST …/:script_id/restore memulihkan jika proyek masih ada dan paket memiliki ruang (403 PLAN_LIMIT jika tidak). Ini bukan janji penghapusan otomatis setelah 30 hari; lihat penghapusan akun. Kedua operasi diaudit.