Documentation index for AI agents

GS2-Guild 마스터 데이터 레퍼런스

마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스

마스터 데이터 포맷

{
  "version": "2024-04-25",
  "guildModels": [
    {
      "name": "[string]길드 모델 이름",
      "metadata": "[string?]메타데이터",
      "defaultMaximumMemberCount": "[int]기본 최대 멤버 수",
      "maximumMemberCount": "[int]최대 멤버 수 상한",
      "inactivityPeriodDays": "[int]무활동 기간(일수)",
      "roles": [
        {
          "name": "[string]롤 모델 이름",
          "metadata": "[string?]메타데이터",
          "policyDocument": "[string]정책 문서"
        }
      ],
      "guildMasterRole": "[string]길드 마스터 롤 이름",
      "guildMemberDefaultRole": "[string]기본 멤버 롤 이름",
      "rejoinCoolTimeMinutes": "[int]재가입 쿨타임(분)",
      "maxConcurrentJoinGuilds": "[int?]동시 가입 가능 길드 최대 수",
      "maxConcurrentGuildMasterCount": "[int?]동시 존재 가능 길드 마스터 최대 수"
    }
  ]
}
타입활성화 조건필수기본값값 제한설명
versionstring
2024-04-25마스터 데이터 포맷 버전
guildModelsList<GuildModel>~ 100 items길드 모델
길드 모델이란 길드에 가입 가능한 최대 인원수 설정 및 길드 내 직책별 권한 설정을 가지는 엔티티입니다.

모델

GuildModel

길드 모델

길드 모델이란 길드에 가입 가능한 최대 인원수 설정 및 길드 내 직책별 권한 설정을 가지는 엔티티입니다.

타입활성화 조건필수기본값값 제한설명
guildModelIdstring
~ 1024자길드 모델 GRN
※ 서버가 자동으로 설정
namestring
~ 128자길드 모델 이름
길드 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
metadatastring~ 2048자메타데이터
메타데이터에는 임의의 값을 설정할 수 있습니다.
이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다.
defaultMaximumMemberCountint
1 ~ 2147483646기본 최대 멤버 수
새 길드가 생성될 때 허용되는 초기 최대 멤버 수입니다. 이 값은 신규 길드의 currentMaximumMemberCount 초기값으로 사용됩니다. 길드 조작이나 입수 액션을 통해 나중에 maximumMemberCount 상한까지 늘릴 수 있습니다.
maximumMemberCountint
1 ~ 2147483646최대 멤버 수 상한
길드가 가질 수 있는 멤버 수의 절대적인 상한입니다. 길드의 currentMaximumMemberCount는 이 값을 초과할 수 없습니다. 길드가 의도된 규모를 넘어 성장하는 것을 방지하는 하드 캡으로 작동합니다.
inactivityPeriodDaysint71 ~ 365무활동 기간(일수)
길드 마스터의 무활동이 이 일수를 초과한 경우, 남은 길드 멤버 중에서 새로운 길드 마스터가 자동으로 선출됩니다. 길드 마스터가 플레이를 중단했을 때 길드가 관리 불능 상태가 되는 것을 방지합니다.
rolesList<RoleModel>
1 ~ 10 items롤 모델 리스트
이 타입의 길드 내에서 이용 가능한 롤 정의 리스트입니다. guildMasterRole 및 guildMemberDefaultRole에서 참조되는 롤을 최소한 포함해야 합니다. 각 롤은 정책 문서를 통해 고유한 권한 집합을 정의합니다. 최대 10개의 롤을 정의할 수 있습니다.
guildMasterRolestring
~ 128자길드 마스터 롤 이름
길드 마스터에게 할당되는 롤의 이름입니다. roles 리스트에 정의된 롤을 참조해야 합니다. 길드 마스터는 일반적으로 참가 신청 승인, 멤버 추방, 롤 변경, 길드 설정 갱신 등 길드를 관리하는 모든 권한을 가집니다.
guildMemberDefaultRolestring
~ 128자기본 멤버 롤 이름
새로운 길드 멤버가 가입할 때 자동으로 할당되는 롤의 이름입니다. roles 리스트에 정의된 롤을 참조해야 합니다. 이는 길드 마스터에 의한 롤 변경 이전, 일반 멤버의 기본 권한 집합입니다.
rejoinCoolTimeMinutesint00 ~ 2147483646재가입 쿨타임(분)
사용자가 길드를 탈퇴한 후 다시 길드에 가입할 수 있게 되기까지의 쿨다운 기간(분)입니다. 0으로 설정하면 즉시 재가입이 가능합니다. 사용자가 길드에 반복적으로 가입·탈퇴하는 악용 패턴을 방지합니다.
maxConcurrentJoinGuildsint1 ~ 10동시 가입 가능 길드 최대 수
사용자가 이 타입의 길드에 동시에 멤버로 가입할 수 있는 최대 수입니다. 플레이어가 여러 길드에 동시에 소속될 수 있는 디자인(예: 전투 길드와 소셜 길드)을 가능하게 합니다. 값은 1에서 10 사이입니다.
maxConcurrentGuildMasterCountint1 ~ 100동시 존재 가능 길드 마스터 최대 수
하나의 길드에 동시에 존재할 수 있는 길드 마스터의 최대 인원수입니다. 여러 플레이어가 길드 마스터의 책임과 권한을 공유하는 공동 리더십 디자인을 가능하게 합니다. 값은 1에서 100 사이입니다.

RoleModel

롤 모델

롤 모델은 길드 내에서의 역할을 정의하고, 각 역할별로 실행할 수 있는 처리에 관한 권한을 설정합니다.

타입활성화 조건필수기본값값 제한설명
namestring
~ 128자롤 모델 이름
롤 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
metadatastring~ 2048자메타데이터
메타데이터에는 임의의 값을 설정할 수 있습니다.
이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다.
policyDocumentstring
~ 10240자정책 문서
이 역할의 권한을 정의하는 JSON 형식의 정책 문서입니다. 이 역할에 할당된 멤버에 대해 어떤 길드 조작(참가 요청 승인/거부, 멤버 추방, 길드 정보 업데이트, 멤버 역할 변경 등)이 허용되거나 거부되는지를 지정합니다.