Activate profanity filter for validation

Last updated on April 4, 2025

Introduction

This article walks you through how to activate the profanity filter in your namespace to validate the display names and usernames of your players.

備考

• The profanity filter feature currently only validates the usernames and display names of your players.

Prerequisites

• You have added profane words to the default profanity filter database. See Register and manage default profane words.
• You have created and configured a designated profanity filter Extend App or set up your own custom server.
• You have created custom profanity filters in the Admin Portal. See Create and manage custom profanity filters.

Activate profanity filter for display name validation

1. In the AGS Admin Portal, go to your game namespace.
2. On the sidebar menu, click on Game Setup and go to Profanity Filter > Configurations.
3. On the Configurations page, go to list of services sections
4. It will shows services have supported profanity filter. Currently we only validates the usernames and display names of your players.
5. Turn on status toggle.
6. After activating the Profanity filter toggle, select the database filter that will be used from the Profanity database dropdown. You can choose the database for the profanity filter
   1. Default. See Register and manage default profane words.
   2. Custom filters See Create custom filters.

Activate profanity filter for display name validation

To activate the profanity filter to validate the display names of your players, follow these steps:

1. In the AGS Admin Portal, select Admin Task > IAM Input Validation on the sidebar menu.
2. In the Display Name section, turn on the Profanity filter toggle.
3. After activating the Profanity filter toggle, select the database filter that will be used from the Profanity database dropdown. You can choose the database for the profanity filter
   1. Default AGS database filter. See Register and manage default profane words.
   2. Custom filters See Create custom filters.

4. Click Save.

Activate profanity filter for username validation

To activate the profanity filter to validate the usernames of your players, follow these steps:

1. In the AGS Admin Portal, select Admin Task > IAM Input Validation on the sidebar menu.

2. In the Username section, turn on the Profanity filter toggle.

3. After activating the Profanity filter toggle, select the database filter that will be used from the Profanity database dropdown. You can choose the database for the profanity filter

   1. Default AGS database filter. See Register and manage default profane words.
   2. Custom filters See Create custom filters.

   

4. Click Save.

Implement profanity filter with client SDKs

The validate user endpoint is contained inside the User class on both Unity and Unreal SDK.

Validate user input

Unreal SDK

To enable this endpoint, specify the FUserInputValidationRequest model to put it into the parameter function. AGS has several validations including Username, DisplayName, or UniqueDisplayName. If the response is valid, then it will return true. Otherwise, it will return false with an error message.

FUserInputValidationRequest UserInputValidationRequest{};
UserInputValidationRequest.Username = "badwordsexample";
FUserInputValidationResponse UserInputValidationResponse{};
FRegistry::User.ValidateUserInput(UserInputValidationRequest, THandler<FUserInputValidationResponse>::CreateLambda([&](const FUserInputValidationResponse& Response)
{
    UE_LOG(LogAccelByteUserServiceTest, Log, TEXT("Success"));
}), FErrorHandler::CreateLambda([&](int32 ErrorCode, const FString& ErrorMessage)
{
    UE_LOG(LogAccelByteUserServiceTest, Warning, TEXT("Error Code: %d, Reason: %s"), ErrorCode, *ErrorMessage);
}));

Unreal OSS

To enable this endpoint, specify the FUserInputValidationRequest model to put it into the parameter function. AGS has several validations including Username, DisplayName, or UniqueDisplayName. If the response is valid, then it will return true. Otherwise, it will return false with an error message.

UserInterface = StaticCastSharedPtr<FOnlineUserAccelByte>(OnlineSubsystem->GetUserInterface());

FUserInputValidationRequest UserInputValidationRequest{};
UserInputValidationRequest.Username = "badwordsexample";
FUserInputValidationResponse UserInputValidationResponse{};
auto ValidateUserInputDelegate = UserInterface->AddOnValidateUserInputCompleteDelegate_Handle(FOnValidateUserInputCompleteDelegate::CreateLambda([&](
    const FUserInputValidationResponse& Response, bool bWasSuccessful, const FOnlineError & OnlineError)
{
    if (bWasSuccessful)
    {
        UE_LOG(LogAccelByteUserInterfaceProfanityFilterTest, Log, TEXT("Success"));
    }
    else
    {
        UE_LOG(LogAccelByteUserInterfaceProfanityFilterTest, Warning, TEXT("Error. Code: %s, Reason: %s"), *OnlineError.ErrorCode, *OnlineError.ErrorMessage.ToString());
    }
}));
UserInterface->ValidateUserInput(LocalUserNum, UserInputValidationRequest);

Unity SDK

// ValidateInputRequest accepts DisplayName, Username, Password, and UniqueDisplayName. If a field is unused or unneeded, you can leave it as null.
Models.ValidateInputRequest request = new Models.ValidateInputRequest()
{
    DisplayName = displayName,
    Username = username
};

Result<Models.ValidateInputResponse> validateResult = null;
AccelByteSDK.GetClientRegistry().GetApi()
    .GetUser()
    .ValidateUserInput(request, result =>
    {
        if (result.IsError)
        {
            // Your code to run when there's an error with the API call
        }

        // Your code to run when the API call is a success
        validateResult = result;
    });