블록체인 게임 관리

베타 게임 참여 신청 후 베타 게임 런처를 통해 게임 출시가 확정이 된 게임에 적용할 블록체인 기능들을 설정하는 페이지입니다. 블록체인 게임 관리 페이지에 노출되는 게임의 기준은 베타 게임 런처를 통해 게임 출시가 확정된 게임입니다. 게임에 적용할 블록체인 기능을 설정하고 표준화 API에 대한 설정을 진행합니다.

콘솔 > 블록체인 > XPLA 게임즈 > 블록체인 게임 관리를 클릭합니다.

게임 이미지 : 해당 게임을 대표하는 이미지입니다. Hive 앱센터에서 등록한 게임 아이콘 이미지가 노출됩니다.
게임명 : Hive 앱센터에서 등록한 게임명이 노출됩니다.
게임 토큰명 : 게임에서 사용하는 게임 토큰입니다. 베타 게임 런처 진행 과정에서 변경될 수 있으며 최종 확정된 게임 토큰명이 자동으로 노출됩니다.
블록체인 기능 설정 : 게임에 적용할 블록체인 기능 설정에 대한 상태 표시입니다.
- 완료 : 블록체인 기능 설정이 성공적으로 완료된 경우 노출되는 상태 표시입니다. 클릭 시 블록체인 기능 설정 확인 페이지로 이동합니다.
- 설정 버튼 : 블록체인 기능 설정이 완료되지 않은 경우 노출되는 상태 표시입니다. 클릭 시 블록체인 기능 설정 페이지로 이동합니다.
사용 기능 : 게임에 적용될 블록체인 기능들을 노출합니다. 해당 값은 블록체인 기능 설정 내용에 따라 변경됩니다.
게임 서버 API 설정 : Hive 블록체인 서버와 통신하기 위한 게임 서버 API를 테스트하고 설정하는 게임 서버 API 설정에 대한 상태 표시입니다.
- 완료 : 게임 서버 API 설정이 성공적으로 완료된 경우 노출되는 상태 표시입니다. 클릭 시 게임 서버 API 설정 페이지로 이동합니다.
- 설정 버튼 : 게임 서버 API 설정이 완료되지 않은 경우 노출되는 상태 표시입니다. 클릭 시 게임 서버 API 설정 페이지로 이동합니다.
서비스 활성화 여부 : 블록체인 기능 설정, 게임 서버 API 설정을 모두 완료한 뒤 블록체인 서비스 활성화 여부를 설정합니다. 서비스가 활성화될 경우 게임사가 설정한 블록체인 기능들이 게임에 적용됩니다.
- 비활성화 : 블록체인 기능 설정 또는 게임 서버 API 설정이 완료되지 않은 경우 해당 버튼은 비활성화됩니다.
- 활성화 : 블록체인 기능 설정과 게임 서버 API 설정이 모두 완료된 경우 활성화됩니다.
  - on : 블록체인 서비스가 적용되어 있는 상태입니다.
  - off : 블록체인 서비스가 중지된 상태입니다.

블록체인 기능 설정

블록체인 기능 설정에서는 게임에 적용될 블록체인 기능들에 대한 세부 설정을 진행하며 게임사가 원하는 블록체인 기능을 자유롭게 설정할 수 있습니다.

콘솔 > 블록체인 > XPLA 게임즈 > 블록체인 게임 관리 > 블록체인 기능 설정 > 설정 버튼을 클릭합니다.

페이지 구성

블록체인 기능 설정 페이지는 설정 영역과 미리 보기 영역으로 구성되어 있습니다. 설정 영역에서 설정한 값에 따라 미리 보기 영역 내 XPLA GAMES Wallet(XPLA 기반 가상화폐 지갑) UI/UX 및 콘텐츠가 변경됩니다.

1. 설정 영역 : 게임에 적용할 블록체인 기능을 설정하는 영역입니다.

2. 미리 보기 영역 : 설정 영역에서 설정한 정보에 따라 실제 서비스가 출시됐을 때 XPLA GAMES Wallet에서 노출되는 화면을 미리 보기 방식으로 제공하는 영역입니다. 해당 미리 보기 화면은 이해를 돕기 위한 용도이기 때문에 실제 서비스되는 XPLA GAMES Wallet와 상이할 수 있습니다.

1.기본 정보

블록체인 기능을 적용하기 위해 필요한 기본 정보를 설정합니다.

게임명(영문)
게임 토큰명 : 베타 게임 참여 신청 시 입력한 정보를 기반으로 베타 게임 런처 진행 후 최종 확정된 게임 토큰명이 표시됩니다.
게임 토큰 이미지 : 게임 토큰을 나타내는 대표 이미지입니다. 사이즈 : 100 x 100 px / 파일 형식 : JPG, PNG / 용량 : 100kb 이하 이미지를 지원합니다.

2.민팅

민팅이란 게임 내 아이템을 블록체인상에서 NFT(대체 불가능 토큰)로 생성하는 기능을 뜻합니다. 민팅 방식은 총 3개로 구성되어 있으며 민팅 방식별로 설정이 가능합니다.

단일 민팅

1개의 게임 아이템을 블록체인 상에서 NFT로 생성합니다.

사용 여부 설정 : 단일 민팅의 사용 여부를 결정합니다.
- 사용 : 단일 민팅을 사용할 수 있으며 유저가 XPLA GAMES Wallet에서 단일 민팅 기능을 이용할 수 있습니다.
- 미사용 : 단일 민팅을 사용하지 않으며 유저가 XPLA GAMES Wallet에서 단일 민팅 기능 이용을 이용할 수 없습니다.
카테고리 설정 : 카테고리는 게임 아이템들을 포괄하는 아이템들의 상위 타입입니다. 예를 들어, 단일 민팅 메뉴에서 ‘equipment’ 카테고리 생성 후 해당 카테고리에 속하는 아이템들을 게임 서버에서 설정하면 해당 아이템들은 단일 민팅이 가능한 아이템들이 됩니다. 카테고리 생성 개수는 제한이 없습니다.
- 카테고리 코드 : 해당 카테고리를 구별할 수 있는 고유 구별 값입니다. 카테고리 추가 후 성공적으로 저장 완료 시 자동 생성됩니다.
- 카테고리명 : 카테고리를 대표하는 이름을 입력합니다. 입력한 값이 XPLA GAMES Wallet 카테고리 탭에 노출됩니다.
- 활성화 여부 : 카테고리에 대한 활성화 여부를 설정합니다.
  - 활성화 체크 시 : 해당 카테고리의 단일 민팅 기능이 활성화되며 XPLA GAMES Wallet에 해당 카테고리가 노출됩니다.
  - 비활성화 체크 시 : 해당 카테고리의 단일 민팅 기능이 비활성화되며 XPLA GAMES Wallet에 해당 카테고리가 노출되지 않습니다.
- 민팅 수수료 : 단일 민팅 시 민팅을 요청한 유저가 지불하는 서비스 이용 수수료입니다. 카테고리별로 설정을 진행하며 CTXT, 게임 토큰 각각 설정이 필요합니다.

조합 민팅

2개 이상의 게임 아이템 또는 NFT를 조합하여 블록체인 상에서 새로운 NFT를 생성합니다. NFT를 생성하는 과정에서 재료가 된 게임 아이템 또는 NFT는 민팅 카운트가 증가합니다.

사용 여부 설정 : 조합 민팅의 사용 여부를 선택합니다.
- 사용 : 조합 민팅 기능을 사용합니다.
- 미사용 : 조합 민팅 기능을 사용하지 않습니다.
카테고리 설정 : 카테고리는 여러 종류의 게임 아이템들을 포괄할 수 있는 상위 타입을 의미합니다. 예를 들어, 조합 민팅에서 ＇equipment＇ 카테고리를 생성한 뒤 해당 카테고리에 속할 아이템들을 게임 서버에서 세팅하면 해당 아이템들은 조합 민팅이 가능한 아이템들이 됩니다.
- 민팅 가능 횟수 : 조합 민팅 시 게임 아이템 또는 NFT의 민팅 가능한 최대 횟수를 나타냅니다. 민팅 가능 횟수는 최대 5까지 설정할 수 있으며 설정에 따라 게임 아이템 또는 NFT에 민팅 카운트 속성이 부여됩니다.
- 민팅 카운트 : 민팅 가능 횟수에 따라 게임 아이템 또는 NFT에 0 ~ 5까지 부여되는 속성입니다. 민팅 카운트는 ＇(현재까지의 민팅 카운트)/(최대 민팅 카운트)＇ 형식으로 노출됩니다. 예를 들어, 민팅 가능 횟수를 5로 설정했을 경우 조합 민팅이 가능한 횟수는 게임 아이템 또는 NFT 별 최대 5번이며 조합 민팅 시 최대 5번까지 민팅 카운트가 증가(0 -> 1 -> 2 -> 3 -> 4 -> 5) 합니다.

<민팅 가능 횟수별 민팅 카운트 상세 정보>

민팅 가능 횟수	민팅 가능 횟수별 민팅 카운트	최대 민팅 카운트(민팅 불가능한 카운트)	설명
1	0	1	민팅 카운트 1 도달 시 민팅 불가
2	0,1	2	민팅 카운트 2 도달 시 민팅 불가
3	0,1,2	3	민팅 카운트 3 도달 시 민팅 불가
4	0,1,2,3	4	민팅 카운트 4 도달 시 민팅 불가
5	0,1,2,3,4	5	민팅 카운트 5 도달 시 민팅 불가

- 수수료 설정 : 조합 민팅 시 민팅을 요청한 유저가 지불하는 서비스 이용 수수료입니다. 카테고리별, 민팅 카운트별 설정을 진행하며 CTXT, 게임 토큰 각각 설정이 필요합니다.
  - 민팅 카운트별 수수료를 설정할 수 있기 때문에 게임 아이템 또는 NFT에 부여된 민팅 카운트별로 민팅 시 지불하는 수수료가 상이합니다.

<민팅 카운트별 수수료 예시>

조합 민팅 수수료 설정 예시
카운트 0 수수료	10 CTXT 10 게임 토큰
카운트 1 수수료	20 CTXT 20 게임 토큰
카운트 2 수수료	30 CTXT 30 게임 토큰
카운트 3 수수료	40 CTXT 40 게임 토큰
카운트 4 수수료	50 CTXT 50 게임 토큰

캐릭터 민팅

RPG 장르와 같이 캐릭터를 선택하여 게임에 진입하고 캐릭터 자체를 육성하는 게 중요한 게임에서는 캐릭터가 지닌 가치가 아이템과는 별도로 존재합니다. 해당 가치를 유지하기 위해서 사용하는 민팅 방식이 캐릭터 민팅입니다.

사용 여부 : 캐릭터 민팅의 사용 여부를 선택합니다.
- 사용 체크 : 캐릭터 민팅 기능을 사용합니다.
- 미사용 체크 : 캐릭터 민팅 기능을 사용하지 않습니다.
카테고리 설정 : 캐릭터 민팅에 해당하는 카테고리는 추가 및 삭제가 불가능하며 1개의 카테고리가 기본 값으로 세팅됩니다. 캐릭터 민팅 시 게임 서버로부터 캐릭터 목록을 호출하여 응답받은 캐릭터명을 XPLA GAMES Wallet 앱 내 노출합니다.
- 카테고리 코드 : 카테고리를 구별할 수 있는 유니크 값입니다. 카테고리 추가 후 저장 완료 시 저장 완료 시 자동 생성됩니다.
- 카테고리명 : 캐릭터 민팅의 카테고리명은 게임 서버로부터 전달받은 캐릭터명을 기본 값으로 노출합니다.
- 활성화 여부 : 카테고리의 활성화 여부를 선택합니다.
  - 활성화 : 해당 카테고리의 캐릭터 민팅 기능이 활성화되며 XPLA GAMES Wallet 앱 내 카테고리가 노출됩니다.
  - 비활성화 : 해당 카테고리의 캐릭터 민팅 기능이 비활성화되며 XPLA GAMES Wallet 앱 내 카테고리가 노출되지 않습니다.
- 민팅 수수료 : 캐릭터 민팅 시 민팅을 요청한 유저가 지불하는 서비스 이용 수수료입니다. CTXT, 게임 토큰 각각 설정이 필요합니다.

3.컨버트

컨버트란 CTXT <-> 게임 재화 or 게임 토큰 <-> 게임 재화 교환을 지원하는 기능입니다. CTXT, 게임 토큰 각각 교환할 게임 재화를 직접 설정할 수 있으며 특정 교환 조건을 설정해 어뷰징을 방지할 수 있습니다.

CTXT 컨버트

게임 재화명 : CTXT와 교환할 게임 재화명을 입력합니다.
게임 재화 코드 : CTXT와 교환할 게임 재화를 구별할 수 있는 고유 구별 값을 입력합니다. 게임 서버 API 요청 시 활용되는 정보기 때문에 실제 게임 서버에서 사용 중인 코드를 입력해야 합니다.
1회 최소 교환 가능 수량 : CTXT로 교환 시 필요한 게임 재화의 최소 수량입니다.
- 예를 들어 1,000을 입력한 경우 해당 게임의 유저는 컨버트 시 1,000개 이상의 게임 재화를 교환 수량으로 입력해야 CTXT로 교환이 가능합니다.
1일 최대 교환 가능 수량 : 1일 동안 CTXT로 교환할 수 있는 게임 재화의 최대 수량입니다.
- 예를 들어 10,000을 입력한 경우 유저가 1일 최대 CTXT로 교환할 수 있는 게임 재화의 총수량은 10,000으로 제한됩니다.
게임 재화 이미지 : CTXT와 교환할 게임 재화를 대표하는 이미지입니다.
- 사이즈 : 100 x 100 px / 파일 형식 : JPG, PNG / 용량 : 100kb 이하 이미지를 지원합니다.

게임 토큰 컨버트

게임 재화명 : 게임 토큰과 교환할 게임 재화명을 입력합니다.
게임 재화 코드 : 게임 토큰과 교환할 게임 재화를 구별할 수 있는 코드 값을 입력합니다. API 요청 시 활용되는 정보기 때문에 실제 게임 서버에서 사용 중인 코드를 입력해야 합니다.
1회 최소 교환 가능 수량 : 컨버트 시 필요한 게임 재화의 최소 수량입니다.
- 예를 들어, 1,000을 입력한 경우 해당 게임의 유저는 컨버트 시 1,000 이상의 게임 재화를 교환 수량으로 입력해야 게임 토큰으로 교환이 가능합니다.
1일 최대 교환 가능 수량 : 1일 동안 게임 토큰으로 교환할 수 있는 게임 재화의 최대 수량입니다.
- 예를 들어, 10,000을 입력한 경우 유저가 1일 최대 게임 토큰으로 교환할 수 있는 게임 재화 총수량은 10,000으로 제한됩니다.
게임 재화 이미지 : 게임 토큰과 교환할 게임 재화를 대표하는 이미지입니다.
- 사이즈 : 100 x 100 px / 파일 형식 : JPG, PNG / 용량 : 100kb 이하 이미지를 지원합니다.

게임 서버 API 설정

게임 서버 API 설정에서는 Hive 블록체인 표준화 API에 따라 개발된 게임 서버 API를 설정합니다. 개발 가이드에 따라 게임 서버 API 개발이 완료한 뒤 설정을 진행해 주세요.

콘솔 > 블록체인 > XPLA 게임즈 > 블록체인 게임 관리 > 게임 서버 API 설정 > 설정 버튼을 클릭합니다.

게임 서버 응답 공통 파라미터

게임 서버에서 공통적으로 응답해야 하는 파라미터 정보입니다. 자세한 사항은 개발 가이드를 확인해 주세요.

게임 서버 API 설정 목록

블록체인 기능을 게임에 적용하기 위해 필요한 게임 서버 API 목록입니다. 자세한 사항은 개발 가이드를 확인해 주세요.

게임 서버 API 설명

해당 API에 필요한 파라미터 정보와 요청, 응답 예제입니다. 자세한 사항은 개발 가이드를 확인해 주세요.

테스트 설정

실제 운영에 적용하기 전 자유롭게 게임 서버 API 통신을 테스트 할 수 있는 기능입니다.

게임 서버 API URL : 게임 서버 API URL을 입력한 뒤 TRY 버튼을 클릭하면 게임 서버 API 통신을 시도합니다. 게임 서버 응답 결과에서 게임 서버 API 통신 성공 여부를 확인할 수 있습니다.

운영 설정

실제 게임에 적용되는 게임 서버 API 설정 영역입니다.

게임 서버 API URL : 게임 서버 API URL을 입력한 뒤 TRY 버튼을 클릭하면 게임 서버 API 통신을 시도합니다.
파라미터 입력 : 게임 서버에서 정의한 파라미터 정보를 입력하는 영역입니다. 자세한 사항은 개발 가이드를 확인해 주세요. ※ appid : 웹 3 게임 전용 appid 이며 게임 권한에 따라 발급된 appid가 자동으로 입력됩니다.

게임 서버 API 통신 성공 시 우측 상단 V 표시가 활성화되며 게임 서버 응답 결과 영역에 통신 성공 결과가 노출됩니다.
모든 게임 서버 API 목록 내 운영 설정에서 게임 서버 API 통신을 성공해야 최종적으로 게임 서버 API 설정 저장이 가능합니다.

게임 서버 API 통신 실패 시 우측 상단 X 표시가 활성화되며 게임 서버 응답 결과 영역에 통신 실패 결과가 노출됩니다.