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/mcp | AI 에이전트용 모듈과 스킬이 있는 로컬 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에서 실행됩니다.
단계별 가이드
함께 보기
- MCP로 AI 에이전트와 함께 만들기iDos Games를 Claude, ChatGPT, Claude Code, Cursor 또는 어떤 MCP 클라이언트에든 연결하세요. 원격 서버 하나는 라이브 앱을 다루고, 로컬 서버는 에이전트에게 SDK 모듈과 스킬을 줍니다.
- 게임 내 상점: 진열대, 상품, 가격iDos Games의 준비된 상점이 작동하는 방식: 상품이 바뀌는 진열대, 게임 재화나 실제 돈으로 매기는 가격, 무료 선물, 구매 한도, 그리고 대시보드에서 코드 없이 설정하는 방법.
- 새 프로젝트에 포함된 것iDos Games의 모든 새 프로젝트는 로그인, 로비, 준비된 시스템 여섯 개로 시작합니다. 상점, 리더보드, 이벤트, 멀티플레이 같은 시스템은 앱에 필요할 때 추가됩니다.
나만의 게임을 만드세요
아이디어를 한 문장으로 설명하면 AI 코더가 만들어 주고, 게임은 고유 링크로 바로 공개됩니다.