LuawardDocs

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

AlatRegistry & PaketAutentikasiKebutuhan sistem
SDK JavaScript / TypeScriptnpm @luaward/sdkDeveloper API key (lwa_live_...)Node.js / fetch standar
SDK PythonPyPI luawardDeveloper API key (lwa_live_...)Python 3.10+, tanpa dependensi eksternal
Luaward CLInpm @luaward/cliPersonal token (lwm_...)Node.js 20+
GitHub resmigithub.com/luawardRepositori & dokumentasiOrganisasi resmi

SDK JavaScript / TypeScript (@luaward/sdk)

Instal dari npm:

npm install @luaward/sdk

Inisialisasi 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.com dan otomatis menambahkan /v3.
  • Resource tersedia: projects, keys, scripts, stats, lw.request() generik, dan LuarmorCompat (periksa field sebelum migrasi).
  • Retry dan error: Mencoba ulang HTTP 429 dan 503 hingga 3 kali dengan menghormati Retry-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 luaward

Gunakan 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 urllib standar Python (wajib Python 3.10+). AsyncLuawardClient menjalankan permintaan lewat asyncio.to_thread().
  • Cakupan: Klien sinkron menyediakan keys, scripts, stats, dan request(), sedangkan klien asinkron menyediakan keys dan request(). Termasuk LuarmorCompat dan AsyncLuarmorCompat.
  • Retry dan exception: Mencoba ulang HTTP 429 / 503 hingga 3 kali dan menyediakan exception bertipe di luaward.exceptions.

Luaward CLI (@luaward/cli)

Instal secara global dari npm (memerlukan Node.js 20+):

npm install -g @luaward/cli
luaward --version

Atau 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_...) ke https://luaward.com/api/ide (Developer API key lwa_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 lewat LUAWARD_CONFIG_DIR) atau diberikan via LUAWARD_TOKEN.
  • Perintah utama: login, init, scripts, pull, push, toggle, sessions, pair, dev, exec, stop, keys, dan errors, dengan dukungan --json / -j untuk CI.

IDE, AI, dan MCP

  • Ekstensi VS Code / Cursor: Belum tersedia di VS Code Marketplace maupun Open VSX. Hubungi dukungan untuk meminta paket .vsix yang sudah diuji selama Early Access.
  • AI dan MCP: Hubungkan Claude, ChatGPT, Claude Code, atau Cursor ke sesi game dan skrip Anda lewat Workspace MCP.