개발자용

TypeScript SDK와 프로젝트 구조

iDos Games 프로젝트의 구성: @idosgames npm 패키지, 로그인과 로비가 있는 호스트 셸, 시스템과 게임을 위한 기능 모듈, 디자인을 위한 설정 파일 하나.

iDos Games 프로젝트는 @idosgames npm 패키지 위에 만든, 호스트 셸과 기능 모듈로 이루어진 TypeScript 앱입니다. 셸은 로그인과 로비를 제공하고, 각 모듈은 시스템 하나(상점, 퀘스트…) 또는 게임 하나입니다. 클라이언트는 iDos Games 게임 API와 통신하므로 내 서버가 필요 없습니다.

패키지

패키지용도
@idosgames/core게임 API 클라이언트: 로그인, 플레이어 데이터, 경제, 모든 시스템
@idosgames/app-shell호스트 셸: 로그인 화면, 로비, 내비게이션, 공용 UI
@idosgames/module-sdk모듈이 셸에 연결되려고 구현하는 계약
@idosgames/react공용 React 컴포넌트와 UI kit
@idosgames/wallet토큰 입금과 출금을 위한 지갑 서명
@idosgames/mcpAI 에이전트용 모듈과 스킬이 있는 로컬 MCP 서버

프로젝트 구조

  • 기본: @idosgames/app-shell의 로그인과 로비, src/app.config.ts에서 설정(시작 화면, 탭 순서).
  • 시스템: src/modules/{id}/, 시스템마다 폴더 하나. 각 시스템은 로비 탭을 등록하고, 앱에서 아무것도 설정되지 않은 동안은 탭을 숨깁니다.
  • 게임: 역시 모듈이며, 로비는 프로젝트의 게임으로 "플레이" 목록을 만듭니다.
  • 디자인: 테마, 애니메이션, 소리를 위한 파일 하나 src/ui.config.ts.

시스템 목록은 새 프로젝트에 포함된 것에서 보세요. 시스템마다 자기 페이지가 있습니다. 예: 상점, 퀘스트, 리더보드.

코드로 작업하기

  • 대시보드의 AI 코더에서: 채팅, 실시간 미리보기, 버전 기록.
  • 내 에이전트로: MCP 서버를 연결하고 에이전트가 모듈과 스킬을 쓰게 하세요.
  • GitHub로: 대시보드에서 프로젝트에 저장소를 연결하세요.

자주 묻는 질문

Unity용 SDK가 있나요?

네, 같은 게임 API를 호출하는 Unity용 C# SDK가 있습니다. 플랫폼의 새 시스템은 따로 들어가므로 필요한 시스템이 거기서 쓸 수 있는지 확인하세요.

내 백엔드가 필요한가요?

아니요. 계정, 인벤토리, 경제, 리더보드 등 시스템은 iDos Games 게임 API에서 실행됩니다.

단계별 가이드

함께 보기

나만의 게임을 만드세요

아이디어를 한 문장으로 설명하면 AI 코더가 만들어 주고, 게임은 고유 링크로 바로 공개됩니다.