> For the complete documentation index, see [llms.txt](https://mirror-networking.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mirror-networking.gitbook.io/docs/manual/general/connection-quality.md).
# Connection Quality
Mirror does a lot of work to smooth out poor network connections.
However, there's only so much we can do on.
{% hint style="warning" %}
For poor connections, it's best practice to display a '**Poor Connection**' warning.
{% endhint %}
Mirror's ConnectionQuality consists of three parts to make this very easy for your game.
### **ConnectionQuality.cs**
Standalone connection quality enum & heuristics, which can be used outside of Unity if needed.
Mirror provides the following connection quality levels:
```csharp
public enum ConnectionQuality : byte
{
EXCELLENT, // ideal experience for high level competitors
GOOD, // very playable for everyone but high level competitors
FAIR, // very noticeable latency, not very enjoyable anymore
POOR, // unplayable
ESTIMATING, // still estimating
}
```
Currently it offers two heuristics:
* **Simple** (based on Ping & Jitter)
* **Pragmatic** (based on Snapshot Interpolation).
### NetworkPingDisplay
This component can be added to the NetworkManager to display a Ping & Connection Quality indicator on the bottom right of the screen. Feel free to modify this to your needs, or create your own.
### **NetworkManager Callbacks**
* **CalculateConnectionQuality()** can be overwritten to inject your own heuristic. By default, it uses the **Simple** heuristic from above. This is called every **connectionQualityInterval** seconds, which can also be configured in the NetworkManager.
```csharp
protected virtual void CalculateConnectionQuality()
{
NetworkClient.connectionQuality = ConnectionQualityHeuristics.Simple(
NetworkTime.rtt,
NetworkTime.rttVar
);
}
```
* **OnConnectionQualityChanged**() can be used to show warnings to the user. By default, this emits a log message - useful for debugging user logs, etc.
```csharp
protected virtual void OnConnectionQualityChanged(ConnectionQuality previous, ConnectionQuality current)
{
Debug.Log($"[Mirror] Connection Quality changed from {previous} to {current}");
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://mirror-networking.gitbook.io/docs/manual/general/connection-quality.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.