GearN Server | Rest Api references | Dashboard

Overview

Update general metadata and configuration details for a specific game.

Client

Require permission rules masterAdmin.setGameInformation.selfEnable. See PermissionRules

HTTP

POST /api/rJson/masterAdmin/client/setGameInformation

Request Headers

Name	Required	Description
Auth-Token	true	A token used to authenticate the user. It is issued after successful login from the client type authenticate (e.g., loginByAccount, loginWithCustomId, etc.) or when an admin logs in via the GearN Dashboard. This token identifies the request sender and determines their access level.
Secret-Key	true	The SecretKey in SecretInfo with role must is Player.
Game-Id		Optional if the gameId in the SecretInfo use in headers Secret-Key has assign a valid value, if not, let unique identifier of the game this request is targeting.
Content-Type	true	application/json

Request Body

Code	Type	Required	Description
gameId	string	true	Unique identifier of the game to query or modify. (2 - 32 characters)
gameName	string		GameName parameter.
gameDescription	string		GameDescription parameter.
gameIconUrl	string		GameIconUrl parameter.
gameSettings	GameSettingsParam		GameSettings parameter. See GameSettingsParam
matchmakingQueueSettings	MatchmakingQueueSettingsParam[]		MatchmakingQueueSettings parameter. See MatchmakingQueueSettingsParam

Response Body

200 Ok

Code	Type	Required	Description
returnCode	ReturnCode	true	Additional metadata that can be attached to any request. Especially useful when working with advanced features such as EventCallbackScript. See ReturnCode
debugMessage	string		A developer-oriented message that provides additional context useful for debugging and internal logging. This field is not intended for end-users and may include stack traces, validation failures, or internal error diagnostics.
invalidRequestParameters	InvalidMember[]		Just had data when the returnCode is InvalidRequestParameters.A list of members that failed validation or could not be processed during the request. Each entry typically includes identifying information and an error reason. This is useful for partial success scenarios where some members are accepted and others are rejected. See InvalidMember
parameters	ResponseData		Just had data when the returnCode is Ok. A dynamic set of key-value pairs included in the response to provide additional context or metadata. These parameters may vary depending on the operation and typically contain optional fields such as timestamps, identifiers, or computed values relevant to the result. See ResponseData

ReturnCode

Name	Code	Description
SecretInvalid	-10	Secret token is invalid (removed, expired or does not contains).
MaxSizeRequestReject	-9	Request rejected due to exceeding maximum allowed size.
MaxRequestReject	-8	Request rejected because the number of requests has exceeded the allowed limit per user or IP or exceeds the total number of pending requests the server is waiting to process..
MaxCCUReject	-7	Connection rejected due to exceeding the allowed CCU (Concurrent Users).
OperationNotAuthorized	-6	You are not authorized to perform this operation. Possibly due to missing or invalid token, or insufficient permissions.
InvalidRequestParameters	-5	Request parameters are invalid or missing.
OperationInvalid	-4	The requested operation is invalid or not supported.
InternalServerError	-3	Internal server error. Could be due to an unhandled exception or logic failure.
OperationNotAllow	-2	This operation is not allowed in the current context.
OperationTimeout	-1	The operation timed out. No response received within the expected time.
UnknownError	0	An unknown error occurred. The cause could not be determined.
Ok	1	Success. The operation completed successfully and returned a valid result.

ResponseData

Code	Type	Required	Description
errorCode	ErrorCode		A string that represents the status of the operation. It indicates whether the request was successful or failed due to a specific error condition. See ErrorCode

GameSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Description
gamePlayerSettings	GamePlayerSettingsParam	GamePlayerSettings used in GameSettingsParam. See GamePlayerSettingsParam
characterPlayerSettings	CharacterPlayerSettingsParam	CharacterPlayerSettings used in GameSettingsParam. See CharacterPlayerSettingsParam
groupSettings	GroupSettingsParam	GroupSettings used in GameSettingsParam. See GroupSettingsParam
inventorySettings	InventorySettingsParam	InventorySettings used in GameSettingsParam. See InventorySettingsParam

GamePlayerSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Description
playerCurrenciesSettings	CurrencySettingsParam[]	PlayerCurrenciesSettings used in GamePlayerSettingsParam. See CurrencySettingsParam
playerStatisticsSettings	StatisticsSettingsParam[]	PlayerStatisticsSettings used in GamePlayerSettingsParam. See StatisticsSettingsParam
playerDatasSettings	DataSettingsParam[]	PlayerDatasSettings used in GamePlayerSettingsParam. See DataSettingsParam
customDatasSettings	DataSettingsParam[]	CustomDatasSettings used in GamePlayerSettingsParam. See DataSettingsParam
tagsSettings	TagSettingsParam[]	TagsSettings used in GamePlayerSettingsParam. See TagSettingsParam
playerCharacterCatalogSettings	CharacterCatalogSettingsParam[]	PlayerCharacterCatalogSettings used in GamePlayerSettingsParam. See CharacterCatalogSettingsParam
playerGroupCatalogSettings	GroupCatalogSettingsParam[]	PlayerGroupCatalogSettings used in GamePlayerSettingsParam. See GroupCatalogSettingsParam
playerItemCatalogSettings	ItemCatalogSettingsParam[]	PlayerItemCatalogSettings used in GamePlayerSettingsParam. See ItemCatalogSettingsParam
playerFriendCatalogSettings	FriendCatalogSettingsParam[]	PlayerFriendCatalogSettings used in GamePlayerSettingsParam. See FriendCatalogSettingsParam

CurrencySettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
key	string	true	Key used to reference the value or setting. (2 - 32 characters)
initialValue	number	true	Value assigned to the configuration or key.
description	string	true	Description used in CurrencySettingsParam.
index	boolean	true	Index used in CurrencySettingsParam.

StatisticsSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
key	string	true	Key used to reference the value or setting. (2 - 32 characters)
statisticsAggregationMethod	number int	true	StatisticsAggregationMethod used in StatisticsSettingsParam.
maximumValue	number		Value assigned to the configuration or key. (Default: null)
minimumValue	number		Value assigned to the configuration or key. (Default: null)
initialValue	number	true	Value assigned to the configuration or key.
description	string	true	Description used in StatisticsSettingsParam.
index	boolean	true	Index used in StatisticsSettingsParam.

DataSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
key	string	true	Key used to reference the value or setting. (2 - 32 characters)
description	string	true	Description used in DataSettingsParam.
permission	number int	true	Permissions configuration or role-based access control settings.

TagSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
key	string	true	Key used to reference the value or setting. (2 - 32 characters)
description	string	true	Description used in TagSettingsParam.
index	boolean	true	Index used in TagSettingsParam.

CharacterCatalogSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
catalogId	string	true	CatalogId used in CharacterCatalogSettingsParam. (2 - 32 characters)
description	string	true	Description used in CharacterCatalogSettingsParam.

GroupCatalogSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
catalogId	string	true	CatalogId used in GroupCatalogSettingsParam. (2 - 32 characters)
description	string	true	Description used in GroupCatalogSettingsParam.
forceAcceptMember	boolean	true	ForceAcceptMember used in GroupCatalogSettingsParam.

ItemCatalogSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
catalogId	string	true	CatalogId used in ItemCatalogSettingsParam. (2 - 32 characters)
itemType	number int	true	ItemType used in ItemCatalogSettingsParam.
itemClassSettings	ItemClassSettingsParam[]	true	ItemClassSettings used in ItemCatalogSettingsParam. See ItemClassSettingsParam

ItemClassSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
classId	string	true	ClassId used in ItemClassSettingsParam. (2 - 32 characters)
description	string	true	Description used in ItemClassSettingsParam.

FriendCatalogSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
catalogId	string	true	CatalogId used in FriendCatalogSettingsParam. (2 - 32 characters)
description	string	true	Description used in FriendCatalogSettingsParam.
forceAcceptFriend	boolean	true	ForceAcceptFriend used in FriendCatalogSettingsParam.

CharacterPlayerSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Description
playerCurrenciesSettings	CurrencySettingsParam[]	PlayerCurrenciesSettings used in CharacterPlayerSettingsParam. See CurrencySettingsParam
playerStatisticsSettings	StatisticsSettingsParam[]	PlayerStatisticsSettings used in CharacterPlayerSettingsParam. See StatisticsSettingsParam
playerDatasSettings	DataSettingsParam[]	PlayerDatasSettings used in CharacterPlayerSettingsParam. See DataSettingsParam
customDatasSettings	DataSettingsParam[]	CustomDatasSettings used in CharacterPlayerSettingsParam. See DataSettingsParam
tagsSettings	TagSettingsParam[]	TagsSettings used in CharacterPlayerSettingsParam. See TagSettingsParam
playerGroupCatalogSettings	GroupCatalogSettingsParam[]	PlayerGroupCatalogSettings used in CharacterPlayerSettingsParam. See GroupCatalogSettingsParam
playerItemCatalogSettings	ItemCatalogSettingsParam[]	PlayerItemCatalogSettings used in CharacterPlayerSettingsParam. See ItemCatalogSettingsParam
playerFriendCatalogSettings	FriendCatalogSettingsParam[]	PlayerFriendCatalogSettings used in CharacterPlayerSettingsParam. See FriendCatalogSettingsParam

GroupSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Description
groupCurrenciesSettings	CurrencySettingsParam[]	GroupCurrenciesSettings used in GroupSettingsParam. See CurrencySettingsParam
groupStatisticsSettings	StatisticsSettingsParam[]	GroupStatisticsSettings used in GroupSettingsParam. See StatisticsSettingsParam
groupDatasSettings	DataSettingsParam[]	GroupDatasSettings used in GroupSettingsParam. See DataSettingsParam
customDatasSettings	DataSettingsParam[]	CustomDatasSettings used in GroupSettingsParam. See DataSettingsParam
tagsSettings	TagSettingsParam[]	TagsSettings used in GroupSettingsParam. See TagSettingsParam
groupItemCatalogSettings	ItemCatalogSettingsParam[]	GroupItemCatalogSettings used in GroupSettingsParam. See ItemCatalogSettingsParam

InventorySettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Description
itemStatisticsSettings	StatisticsSettingsParam[]	ItemStatisticsSettings used in InventorySettingsParam. See StatisticsSettingsParam
itemDatasSettings	DataSettingsParam[]	ItemDatasSettings used in InventorySettingsParam. See DataSettingsParam
customDatasSettings	DataSettingsParam[]	CustomDatasSettings used in InventorySettingsParam. See DataSettingsParam
tagsSettings	TagSettingsParam[]	TagsSettings used in InventorySettingsParam. See TagSettingsParam

MatchmakingQueueSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
queueName	string	true	QueueName used in MatchmakingQueueSettingsParam. (6 - 32 characters)
matchSize	SizeParam	true	MatchSize used in MatchmakingQueueSettingsParam. See SizeParam
ticketSize	SizeParam	true	TicketSize used in MatchmakingQueueSettingsParam. See SizeParam
serverAllocation	ServerAllocationParam	true	ServerAllocation used in MatchmakingQueueSettingsParam. See ServerAllocationParam
teams	TeamParam[]		Teams used in MatchmakingQueueSettingsParam. See TeamParam
rules	RuleParam[]		Rules used in MatchmakingQueueSettingsParam. See RuleParam
remove	boolean		Remove used in MatchmakingQueueSettingsParam.

SizeParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
min	number int	true	Min used in SizeParam. (from 1)
max	number int	true	Max used in SizeParam. (from 1)

ServerAllocationParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
enable	boolean	true	Enable used in ServerAllocationParam.

TeamParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
teamId	string	true	TeamId used in TeamParam. (1 - 32 characters)
teamSize	SizeParam	true	TeamSize used in TeamParam. See SizeParam

RuleParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
name	string	true	Name used in RuleParam. (1 - 32 characters)
type	number int	true	Type used in RuleParam. (from 1 to 8)
attributeSource	number		AttributeSource used in RuleParam. (from 1 to 2)
attributePath	string		AttributePath used in RuleParam. (1 - 32 characters)
defaultValue	any		Value assigned to the configuration or key.
compairType	number int		CompairType used in RuleParam. (from 1 to 2)
allowedDifference	number		AllowedDifference used in RuleParam. (from 0)
min	number		Min used in RuleParam.
max	number		Max used in RuleParam.
advancedSettings	AdvancedSettingsParam		AdvancedSettings used in RuleParam. See AdvancedSettingsParam

AdvancedSettingsParam

Configuration structure defining backend behavior or system-level preferences.

Code	Type	Required	Description
secondsUntilOptional	number	true	SecondsUntilOptional used in AdvancedSettingsParam. (from 1)
expansionType	number int		ExpansionType used in AdvancedSettingsParam. (from 1 to 3)
linearExpansions	LinearExpansionsParam		LinearExpansions used in AdvancedSettingsParam. See LinearExpansionsParam
customExpansions	CustomExpansionsParam		CustomExpansions used in AdvancedSettingsParam. See CustomExpansionsParam

LinearExpansionsParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
secondsBetweenExpansions	number	true	SecondsBetweenExpansions used in LinearExpansionsParam. (from 1)
delta	number		Delta used in LinearExpansionsParam.
limit	number		Limit used in LinearExpansionsParam.

CustomExpansionsParam

Parameters used to configure or control a related operation.

Code	Type	Required	Description
secondsBetweenExpansions	number	true	SecondsBetweenExpansions used in CustomExpansionsParam. (from 1)
overrideValue	any[]		Value assigned to the configuration or key.
overrideMin	any[]		OverrideMin used in CustomExpansionsParam.
overrideMax	any[]		OverrideMax used in CustomExpansionsParam.

ErrorCode

Name	Code
Ok	1
GameNotFound	22

InvalidMember

Code	Type	Description
code	string	The parameterCode invalid.
invalidMemberType	InvalidMemberType	The invalid member type of this parameterCode. See InvalidMemberType

InvalidMemberType

Name	Code	Description
UnknownError	1	An unspecified or unexpected error has occurred.
DataRequired	2	A required data field is missing or not provided.
TypeInvalid	3	The data type provided does not match the expected type.
StringNull	4	A string value is null or has not been assigned.
StringMinLength	5	The string value is shorter than the minimum required length.
StringMaxLength	6	The string value exceeds the maximum allowed length.
NumberMinValue	7	The numeric value is less than the minimum allowed value.
NumberMaxValue	8	The numeric value exceeds the maximum allowed value.
NumberMustInt	9	The numeric value must be an integer but is not.
GNHashtableNull	10	The hashtable object is null or not provided.
GNHashtableMinLength	11	The hashtable contains fewer entries than the minimum required.
GNHashtableMaxLength	12	The hashtable contains more entries than the maximum allowed.
GNArrayNull	13	The array object is null or not provided.
GNArrayMinLength	14	The array contains fewer elements than the minimum required.
GNArrayMaxLength	15	The array contains more elements than the maximum allowed.