# MatchmakingService

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Tags: Not creatable, Not replicated, Service
- Memory category: Instances
- HTML page: https://rapi.sleaze.dev/classes/MatchmakingService/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/MatchmakingService

The service responsible for managing custom matchmaking data.

## Methods

### GetServerAttribute

```luau
MatchmakingService:GetServerAttribute(name: string): ...any
```

- Tags: Capabilities: Basic

Retrieves the value of a specific server attribute.

Parameters:

- `name`: The name of the server attribute. Limited to a maximum of 50 characters.

Returns: Returns the server attribute value if the attribute is found and if the error is `nil`. Otherwise, returns `nil` for the attribute value and an error message.

### InitializeServerAttributesForStudio

```luau
MatchmakingService:InitializeServerAttributesForStudio(serverAttributes: { [string]: any }): ...any
```

- Tags: Capabilities: Basic

Initiates the server attribute schema and its values to test in Studio.

Parameters:

- `serverAttributes`: An array of attribute name-value pairs.

Returns: Returns `true` if the call succeeded. Otherwise, returns `false` and an error message.

### SetServerAttribute

```luau
MatchmakingService:SetServerAttribute(name: string, value: any): ...any
```

- Tags: Capabilities: Basic

Assigns a value to a specific server attribute.

Parameters:

- `name`: The name of the server attribute. Limited to a maximum of 50 characters.
- `value`: The value of the server attribute. Limited to a maximum of 50 characters.

Returns: Returns `true` if the call succeeded. Otherwise, returns `false` and an error message.

## Inherited members

- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`