🎮 게임 업로드

💡 팁: 게임 안에서 🍀 럭키를 사용하게 만들 수 있어요 (계속하기, 아이템 구매 등)
게임 HTML에 아래 스크립트를 추가하면 플레이어의 럭키를 조회/차감하거나, 진행 상황을 저장할 수 있어요:

<script src="https://lkgames.kr/assets/lkgames-sdk.js"></script>
<script>
  LKgames.spendLucky(5).then(r => {
    if (r.success) continueGame();
    else alert("럭키가 부족해요!");
  });

  // 진행 상황 저장 / 불러오기 (계정 기준으로 서버에 저장됨)
  LKgames.saveState({ score: 1200 });
  LKgames.loadState().then(r => { if (r.data) restoreGame(r.data); });
</script>

⋯ 더보기

📌 게임 업로드 시 럭키 차감

• 계정당 무료 업로드 3개까지
• 4번째부터는 업로드당 🍀 20 Lucky 차감

💰 게임 안에서 럭키 쓰면 → 1일 뒤 제작자에게 50% 정산

• 플레이어가 LKgames.spendLucky()로 럭키를 쓰면, 그 게임을 올린 제작자에게 1일 후 사용량의 50%가 자동 지급돼요
• 본인이 올린 게임에서 본인이 쓴 럭키는 정산 대상에서 제외돼요
• 정산은 실시간이 아니라 사이트 방문 트래픽에 맞춰 처리돼요 (며칠 정도 오차 있을 수 있음)

💾 게임 저장 기능

• LKgames.saveState(data) — 원하는 시점에 진행 상황을 서버에 저장 (data는 JSON으로 변환 가능한 값이어야 함)
• LKgames.loadState() — 게임 시작 시 호출해서 이전 저장 데이터 불러오기. 저장된 적 없으면 data: null
• 계정(로그인) 기준으로 저장되고, 게임별로 따로 저장돼요 — 확인 팝업 없이 바로 처리됨

⚙️ 코딩할 때 알아두어야 할 것

• spendLucky()를 호출하면 LKgames 사이트가 "N럭키를 사용할까요?" 확인 팝업을 직접 띄워요 — 유저가 승인해야만 차감돼요. 갑자기 차감되는 게 아니니 게임에서 별도 확인창 안 만드셔도 돼요
• 이 SDK는 게임이 LKgames 사이트의 iframe 안에서 실행될 때만 동작해요. 게임 파일을 로컬에서 단독으로 열면 응답이 없다가 5초 후 {success:false, reason:"timeout"}이 와요
• spendLucky()는 차감만 가능해요. 럭키를 지급하는 API는 없어요 (악용 방지)
• 실패 이유(reason): "login_required"(비로그인) · "insufficient_lucky"(잔액부족) · "invalid_amount"(amount가 0 이하) · "user_cancelled"(유저가 확인 팝업에서 취소) · "timeout"
• 차감 성공/실패와 관계없이 result.balance로 현재 잔액을 항상 확인할 수 있어요
• 럭키 요청 전, 게임 화면에 "계속하려면 🍀 5 사용" 같은 안내를 미리 보여주는 걸 추천해요 (확인 팝업이 뜨긴 하지만, 맥락 없이 갑자기 뜨면 유저가 당황해요)

🚀 게임 업로드