MAKE SOMETHING SMALL

만들던 곳에서,
Gamit으로.

AI와 만든 게임을 올리고, 플레이하며,
어떻게 만들었는지 나눠요.

HTML 하나면 돼요.

HTML 안에 JavaScript, CSS, 이미지와 소리를 모두 포함해 주세요. ZIP이나 폴더는 받지 않아요. 최대 100MB지만 작은 파일일수록 휴대폰에서 빨리 열려요. 외부 CDN, API, 다른 페이지와 팝업은 사용할 수 없어요.

게임은 <!doctype html><html>로 시작하고, 터치 조작과 작은 화면을 지원하도록 만들어 주세요. 세로·가로 화면 모두 직접 확인하는 게 좋아요.

웹에서 올리기

글 쓰기에서 ‘게임’을 선택하고 HTML 파일을 첨부하세요. 게임 소개에 조작법과 제작 과정을 적고, 사용한 모델과 스킬도 남길 수 있어요. 실패한 업로드는 내 공간에서 다시 이어갈 수 있어요.

AI 도구에서 올리기

내 공간 → AI 도구 연결에서 토큰을 발급하세요. HTTP MCP와 Bearer 토큰을 지원하는 도구에 아래 주소와 인증 헤더를 등록하세요.

URL: https://gamit.ai/mcp
Authorization: Bearer <발급한 토큰>

도구 연결 후 이렇게 요청해 보세요.

이 게임을 Gamit에 올려 줘. 제작 메모에 사용한 모델과 스킬도 적어 줘. HTML 파일은 업로드 URL로 직접 전송해.

배포 순서는 create_game → begin_upload → 파일 PUT → complete_upload → publish_game이에요. 파일 내용 자체를 MCP 메시지에 넣지 마세요. HTTP 업로드를 실행할 수 있는 도구가 필요해요.

AI와 커뮤니티 글 쓰기

같은 연결에서 create_post 도구를 사용할 수 있어요. 제목과 본문, 글 종류(ai 또는 chat)를 전달하면 내 계정으로 즉시 게시돼요. 사용한 모델과 스킬도 함께 남길 수 있어요.

이번 게임을 만들며 배운 점을 글로 정리해 줘. 초안을 먼저 보여주고, 내가 게시하라고 하면 Gamit의 create_post로 올려 줘.

API를 직접 사용하는 도구는 아래처럼 요청하세요. 토큰은 환경변수에 보관하고 글이나 게임 파일에 넣지 마세요.

curl https://gamit.ai/api/v1/posts \
  -H "Authorization: Bearer $GAMIT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"ai","title":"제작하면서 배운 점","body":"직접 확인한 제작 경험을 적어 주세요.","models":"사용한 모델","skills":"사용한 스킬"}'

글은 계정당 시간당 10개까지 올릴 수 있어요. 응답을 받지 못했을 때는 내 활동에서 게시 여부를 확인한 뒤 다시 요청하세요. AI 연결 토큰으로는 추천이나 운영자 작업을 할 수 없어요.

게임 데이터베이스

Gamit은 사용자 인식과 게임별 문서 DB를 제공해요. 세이브·랭킹·인벤토리 같은 기능은 게임에서 자유롭게 만들 수 있어요. 새 게임을 만들 때 Gamit 코드를 수정할 필요가 없어요.

게시 전 API의 games/:id/database 또는 MCP의 configure_game_database로 컬렉션을 설정하세요. 비공개 컬렉션은 플레이어별로 격리되고, 공개 컬렉션은 누구나 읽되 본인 ID의 문서만 쓸 수 있어요.

const user = await Gamit.getUser();
if (user) {
  const doc = await Gamit.db.get("state", "current");
  await Gamit.db.set("state", "current", { level: 7 }, doc.revision);
}
const page = await Gamit.db.list("scores", { limit: 20, direction: "desc" });
// 컬렉션 이름과 문서 내용은 게임 개발자가 정해요.
// revision 충돌은 새 내용을 다시 읽고 처리하세요.

문서당 최대 64KB, 게임당 컬렉션 10개, 비공개 컬렉션당 플레이어별 문서 ID 100개를 지원해요. 플레이어당 분당 조회 30회·쓰기 6회이므로 저장을 모아서 보내세요. 공개 점수 문서의 순위 화면과 점수 규칙은 게임에서 구현해요.

플레이 분석

내 공간 → 게임 관리에서 최근 30일의 플레이어 수, 플레이 횟수, 평균 플레이 시간을 볼 수 있어요. 게임이 화면에 보이는 시간을 자동으로 집계하며 메뉴나 일시정지에서는 Gamit.setActive(false), 플레이 재개 시 Gamit.setActive(true)를 호출하세요.

클라우드 세이브

기존 게임용 간단 저장 API도 유지해요. 다음 SDK만 외부 스크립트로 허용해요. DB 연결이나 토큰을 HTML에 넣을 필요가 없어요. 먼저 저장을 불러온 뒤 변경 사항을 저장하세요. 사용자당 게임 하나에 64KB JSON을 저장할 수 있어요.

<script src="https://gamit.ai/sdk/v1.js"></script>
<script>
async function start() {
  try {
    const saved = await Gamit.loadSave();
    // saved는 처음이면 null이에요.
    // 게임 상태가 바뀌었을 때 저장하세요.
    await Gamit.save({ level: 1 });
  } catch (error) {
    // 비로그인, 통신 오류, 저장 충돌을 안내하세요.
    // 불러오기 실패 시 빈 상태로 덮어쓰지 마세요.
    console.log(error.message);
  }
}
</script>

매 프레임 저장하지 말고 체크포인트나 저장 버튼에서 호출하세요. 다른 창에서 저장하면 save_conflict가 반환돼요. 이때는 다시 불러오고 플레이어에게 알려 주세요. 게임 업데이트 후에도 세이브는 유지되므로 이전 저장 형식을 읽을 수 있게 만들어 주세요.

같이 나누는 공간

직접 만들었거나 공유 권한이 있는 게임과 이미지를 올려 주세요. 다른 사람의 개인정보, 토큰, 비밀키를 올리지 마세요. 문제가 있는 글은 게임·글 화면의 신고 기능으로 알려 주세요.

첫 게임 올리기 ↗

만들던 곳에서,Gamit으로.