# Game Server Services 문서

> 온라인 게임 및 라이브 서비스 게임의 백엔드 기능을 위한 Backend-as-a-Service 플랫폼인 Game Server Services(GS2)의 공식 기술 문서입니다.

GS2는 조합 가능한 마이크로서비스로 구성되어 있습니다. 구현 관련 질문에는 사용자의 게임 기능을 적절한 서비스 조합에 매핑한 다음, 정확한 API 레퍼런스, 마스터 데이터 스키마 또는 Stamp Sheet 레퍼런스를 확인하여 답변하십시오. API 이름, 모델 필드, 열거형 값, GRN 형식 또는 액션 이름을 임의로 만들지 마십시오.

## 근거 규칙

- 여기에 나열된 공식 GS2 문서 URL과 `/llms/*.txt`의 URL을 우선하십시오.
- `llms.txt`는 완전한 진실의 원천이 아니라 라우터로 취급하십시오.
- 질문에 답할 수 있는 최소한의 컨텍스트를 사용하고, 세부 정보에는 필요한 정확한 레퍼런스 페이지만 가져오십시오.
- 질문에 코드, 스키마, 열거형, GRN 또는 액션 이름이 필요하면 답변하기 전에 관련 API 레퍼런스 페이지에서 확인하십시오.
- 영어와 일본어 페이지가 다르면 API/스키마 세부 정보가 더 구체적인 페이지를 우선하고, 중요한 경우 불확실성을 언급하십시오.

## 컨텍스트 예산 전략

컨텍스트 창의 과부하를 방지하기 위해 다음 단계를 사용하십시오.

| 예산 | 로드 대상 | 사용 시점 |
| --- | --- | --- |
| Tiny | `llms.txt`만 | 요청을 분류하고, 관련 레퍼런스를 선택하고, 상위 수준의 탐색 질문에 답할 때. |
| Small | `llms.txt` + 특정 `/llms/*.txt` 파일 하나 | 필드 수준의 세부 정보 없이 서비스를 선택하거나 개념을 설명할 때. |
| Medium | 대상 API 레퍼런스 페이지와 개념 페이지 하나 추가 | 구현 지침, 배포 지침 또는 기능 설계를 작성할 때. |
| Large | 서비스 간 흐름을 식별한 후에만 관련 서비스 레퍼런스 추가 | 다중 서비스 경제, 구매, 퀘스트, 미션, 로그인 보상 또는 CI/CD 설계. |

권장 가져오기 순서:

1. 이 파일을 읽습니다.
2. **LLM 최적화 레퍼런스**에서 특정 파일 하나를 선택합니다.
3. `api-reference-index.txt`를 사용하여 정확한 API 레퍼런스 URL을 구성합니다.
4. 대상 레퍼런스 유형만 가져옵니다: `game_engine`, `sdk`, `deploy`, `master_data`, `script`, `stamp_sheet` 또는 `buff`.
5. 동작, 재시도, 보안 또는 비용이 중요한 경우에만 개념 페이지를 추가합니다.

## LLM 최적화 레퍼런스

- [핵심 개념](https://docs.gs2.io/llms/core-concepts.txt): Stamp Sheet, 액세스 제어, 트랜잭션 설정, SDK 캐시, 리전, 오류 및 비용 개념.
- [마이크로서비스 선택 가이드](https://docs.gs2.io/llms/microservices.txt): GS2 마이크로서비스 전반의 요구 사항별 서비스 라우팅.
- [API 레퍼런스 인덱스](https://docs.gs2.io/llms/api-reference-index.txt): 정확한 API 페이지를 선택하기 위한 간결한 서비스 슬러그 및 레퍼런스 유형 인덱스.
- [구현 레시피](https://docs.gs2.io/llms/implementation-recipes.txt): 서비스 조합에 매핑된 일반적인 게임 기능 레시피.
- [게임 엔진 SDK 가이드](https://docs.gs2.io/llms/game-engine-sdk.txt): Unity, Unreal Engine 및 Godot SDK 라우팅.
- [배포 및 마스터 데이터 가이드](https://docs.gs2.io/llms/deploy-and-master-data.txt): GS2-Deploy, Deploy/CDK, 템플릿 및 가져올 수 있는 마스터 데이터.
- [트랜잭션 액션 가이드](https://docs.gs2.io/llms/transaction-actions.txt): Stamp Sheet, Consume Action, Verify Action, Acquire Action 및 경제 시스템에 안전한 작업.

## 주요 문서

- [문서 홈](https://docs.gs2.io/ko/)
- [Game Server Services란](https://docs.gs2.io/ko/overview/index.md)
- [개발 워크플로](https://docs.gs2.io/ko/overview/workflow/index.md)
- [마이크로서비스](https://docs.gs2.io/ko/microservices/index.md)
- [API 레퍼런스](https://docs.gs2.io/ko/api_reference/index.md)
- [기술 문서](https://docs.gs2.io/ko/articles/tech/index.md)

## 라우팅 체크리스트

- 게임 기능이 불분명한 경우: `implementation-recipes.txt`를 읽은 다음 `microservices.txt`를 읽습니다.
- 서비스를 알고 있는 경우: `api-reference-index.txt`를 읽은 다음 해당 서비스의 대상 레퍼런스 페이지를 읽습니다.
- Unity, Unreal Engine 또는 Godot: `game-engine-sdk.txt`를 읽은 다음 `/{service}/game_engine/`을 읽습니다.
- 서버 측 SDK: `/{service}/sdk/`를 사용합니다.
- 리소스 프로비저닝, 템플릿 또는 CDK: `deploy-and-master-data.txt`를 읽은 다음 `/{service}/deploy/`를 읽습니다.
- 마스터 데이터 JSON/YAML/스키마: `deploy-and-master-data.txt`를 읽은 다음 `/{service}/master_data/`를 읽습니다.
- 경제 작업, 보상, 구매, 교환, 퀘스트 완료, 스태미나 소비, 제한 또는 중복 실행: `transaction-actions.txt`를 읽은 다음 사용 가능한 경우 `/{service}/stamp_sheet/`를 읽습니다.
- 보안, 클라이언트 액세스, 자격 증명 또는 권한: `core-concepts.txt`를 읽은 다음 액세스 제어 및 Auth/Identifier 레퍼런스를 읽습니다.

## 핵심 기술 개념

- [Stamp Sheet](https://docs.gs2.io/ko/articles/tech/stamp_sheet/index.md): Consume Action, Verify Action 및 Acquire Action을 조합하기 위한 GS2 트랜잭션 시스템.
- [액세스 제어](https://docs.gs2.io/ko/articles/tech/identifier/index.md): GS2 API의 액세스 제어 모델.
- [오류/예외](https://docs.gs2.io/ko/articles/tech/error/index.md): 일반적인 오류 및 예외 처리.
- [GS2-Deploy 템플릿 파일 사양](https://docs.gs2.io/ko/articles/tech/deploy/index.md): GS2 리소스를 정의하기 위한 템플릿 사양.
- [리전](https://docs.gs2.io/ko/articles/tech/region/index.md): GS2 데이터 센터 리전.
- [트랜잭션 설정](https://docs.gs2.io/ko/articles/tech/transaction/index.md): 트랜잭션 실행 동작.
- [SDK 캐시 메커니즘](https://docs.gs2.io/ko/articles/tech/cache/index.md): SDK 캐시 동작.
- [비용 최적화](https://docs.gs2.io/ko/articles/tech/cost/index.md): 비용 최적화 지침.

## 답변 규칙

- 추측한 서비스 이름이 아니라 사용자의 게임 설계 요구 사항에서 시작하십시오.
- 많은 게임 기능에는 여러 GS2 마이크로서비스가 필요하므로 각 서비스의 조합과 책임을 명시하십시오.
- API 시그니처, 필드 및 스키마에는 광범위한 개요 페이지보다 정확한 레퍼런스 페이지를 우선하십시오.
- 보상 및 구매 흐름에서는 어느 서비스가 Stamp Sheet를 발행하고 어느 서비스가 액션을 실행하는지 식별하십시오.
- 생성된 템플릿 또는 마스터 데이터에는 네임스페이스/리소스 관계를 포함하고 레퍼런스를 기준으로 필수 필드를 검증하십시오.
- 절충안을 검토할 때는 데이터 소유권, 일관성 요구 사항, 재설정 동작, 클라이언트/서버 경계 및 운영 복잡성을 비교하십시오.
- 컨텍스트 예산 때문에 전체 검증이 불가능한 경우 검증된 내용과 특정 레퍼런스가 더 필요한 내용을 명시하십시오.

## 선택 사항

- [게임 디자인 지식](https://docs.gs2.io/ko/design_knowledge/index.md): 메타게임, 수익화, 리텐션, 만족도 및 관련 개념에 관한 게임 디자인 문서.
- [지원 메뉴](https://docs.gs2.io/ko/pricing/support/index.md): 지원 문서.