Skip to main content
Version: 5.17.0

SetRegistrationValueV3

public BackendReturnObject SetRegistrationValueV3(bool immediateFlag);

Parameters

ValueTypeDescription
immediateFlagboolWhether to allow immediate join (true - quick join, false - join on approval)

Description

Sets whether to allow quick join when players attempt to join the guild.\ When you set the quick join status via SetRegistrationValueV3, the _immediateRegistration key is added to the metadata of the guild.\ _immediateRegistration key cannot be confirmed through the console's metadata; it can only be checked when looking up guild information through the client.\ The value is stored as true or false.

Caution
  • If you do not set whether to allow quick join using this method, all guilds are set to be joined after the approval of the guild master.

  • If you do not set whether to allow quick join using this method, the _immediateRegistration key is not added to the metadata.

  • If you set quick join only for certain guilds and not others, the metadata may contain both guilds with and without the _immediateRegistration key. Developers who wish to allow the quick join status to be set are recommended to immediately reset the quick join status by calling SetRegistrationValueV3 after a player successfully creates a guild.\ :::

Example

Synchronous

Backend.Guild.SetRegistrationValueV3(true); // Quick join settings

Asynchronous

Backend.Guild.SetRegistrationValueV3(true, (callback) =>  // Quick join settings
{
// Post-process
});

SendQueue

SendQueue.Enqueue(Backend.Guild.SetRegistrationValueV3,true, (callback) =>  // Quick join settings
{
// Post-process
});

ReturnCase

Success cases

When the change is successful\ statusCode : 204\ message : Success

Error cases

When a guild member who is not the master calls the method\ statusCode : 403\ errorCode : ForbiddenException\ message : Forbidden guild Member, Forbidden guild Member

When a player not joined to the guild calls the method\ statusCode : 404\ errorCode : NotFoundException\ message : guild not found, guild cannot be found