SDK dan CLI
Instal paket resmi @luaward/sdk, luaward (Python), dan @luaward/cli dari npm dan PyPI beserta token yang sesuai.
Pastikan nama paket resmi sebelum menginstal
Instal hanya dari tautan resmi di bawah ini dan github.com/luaward. Perhatikan jenis kredensialnya: SDK memakai Developer API key workspace (lwa_live_...), sedangkan CLI memakai Personal token (lwm_...).
Paket resmi
| Alat | Registry & Paket | Autentikasi | Kebutuhan sistem |
|---|---|---|---|
| SDK JavaScript / TypeScript | npm @luaward/sdk | Developer API key (lwa_live_...) | Node.js / fetch standar |
| SDK Python | PyPI luaward | Developer API key (lwa_live_...) | Python 3.10+, tanpa dependensi eksternal |
| Luaward CLI | npm @luaward/cli | Personal token (lwm_...) | Node.js 20+ |
| GitHub resmi | github.com/luaward | Repositori & dokumentasi | Organisasi resmi |
SDK JavaScript / TypeScript (@luaward/sdk)
Instal dari npm:
npm install @luaward/sdkInisialisasi LuawardClient di sisi server memakai Developer API key (lwa_live_...) dan ID proyek Anda:
import { LuawardClient } from "@luaward/sdk";
const lw = new LuawardClient({
apiKey: process.env.LUAWARD_API_KEY,
projectId: process.env.LUAWARD_PROJECT_ID,
});
const created = await lw.keys.create({
discord_id: "123456789012345678",
key_days: 30,
note: "Monthly access",
});
const queued = await lw.scripts.upload(process.env.LUAWARD_SCRIPT_ID, {
source: 'print("Hello from SDK")',
preset: "balanced",
});- URL dasar: Default ke
https://api.luaward.comdan otomatis menambahkan/v3. - Resource tersedia:
projects,keys,scripts,stats,lw.request()generik, danLuarmorCompat(periksa field sebelum migrasi). - Retry dan error: Mencoba ulang HTTP
429dan503hingga 3 kali dengan menghormatiRetry-After, serta melempar error bertipe (LuawardAuthError,LuawardRateLimitError,LuawardPlanLimitError,LuawardNotFoundError,LuawardError).
Lihat detail scope dan endpoint di Ringkasan Developer API dan Referensi API v3.
SDK Python (luaward)
Instal dari PyPI:
pip install luawardGunakan LuawardClient untuk sinkron atau AsyncLuawardClient untuk alur asinkron:
import os
from luaward import LuawardClient
lw = LuawardClient(
api_key=os.environ["LUAWARD_API_KEY"],
project_id=os.environ["LUAWARD_PROJECT_ID"],
)
created = lw.keys.create(
discord_id="123456789012345678",
key_days=30,
note="Monthly access",
)
print(created["user_key"])- Tanpa dependensi eksternal: Memakai
urllibstandar Python (wajib Python 3.10+).AsyncLuawardClientmenjalankan permintaan lewatasyncio.to_thread(). - Cakupan: Klien sinkron menyediakan
keys,scripts,stats, danrequest(), sedangkan klien asinkron menyediakankeysdanrequest(). TermasukLuarmorCompatdanAsyncLuarmorCompat. - Retry dan exception: Mencoba ulang HTTP
429/503hingga 3 kali dan menyediakan exception bertipe diluaward.exceptions.
Luaward CLI (@luaward/cli)
Instal secara global dari npm (memerlukan Node.js 20+):
npm install -g @luaward/cli
luaward --versionAtau instal dari tarball resmi di luaward.com:
npm install -g https://luaward.com/luaward-cli.tgz
luaward --version- Kredensial dan Early Access: Menggunakan Personal token (
lwm_...) kehttps://luaward.com/api/ide(Developer API keylwa_live_...tidak dapat dipakai di sini). Dashboard dan IDE API saat ini berada dalam tahap Early Access. - Lokasi kredensial: Disimpan di
~/.config/luaward/credentials.json(ubah lewatLUAWARD_CONFIG_DIR) atau diberikan viaLUAWARD_TOKEN. - Perintah utama:
login,init,scripts,pull,push,toggle,sessions,pair,dev,exec,stop,keys, danerrors, dengan dukungan--json/-juntuk CI.
IDE, AI, dan MCP
- Ekstensi VS Code / Cursor: Belum tersedia di VS Code Marketplace maupun Open VSX. Hubungi dukungan untuk meminta paket
.vsixyang sudah diuji selama Early Access. - AI dan MCP: Hubungkan Claude, ChatGPT, Claude Code, atau Cursor ke sesi game dan skrip Anda lewat Workspace MCP.