# Notifier Module

## Overview

The **Diarkis Notifier** is a high-efficiency, server-to-client unidirectional messaging module designed for broadcasting messages to all connected Diarkis client endpoints. Leveraging the architecture of the Diarkis server cluster, the Notifier enables **simultaneous message delivery** across all clients with **negligible latency** and **no additional server load**, regardless of scale.

This module is optimized for **one-to-many notification use cases**, such as global alerts or broadcast events, where uniform and immediate delivery to all clients is essential.

Unlike traditional implementations—which often incur significant server overhead and delivery lag when broadcasting to large numbers of clients—the Diarkis Notifier achieves **linear scalability** and **consistent performance** even under high concurrency.

It is important to note that the Notifier is designed specifically for **unidirectional server-to-client communication**. It is not intended for client-to-client messaging or real-time synchronization tasks.

For implementation details and usage parameters, refer to the [**Diarkis API Reference**](https://docs.diarkis.io/docs/server/current/diarkis/server/index.html#NotificationService).

#### **Use Case Examples for Diarkis Notifier**

1. **Global In-Game Announcements**\
   Instantly broadcast system-wide messages such as maintenance alerts, patch updates, or in-game event notifications to all connected players.
2. **Match Start Countdown**\
   Send synchronized countdown timers or match-start signals to all players in a game lobby to ensure consistent session start timing.
3. **Real-Time Status Updates**\
   Deliver alerts like “server at capacity,” “region under maintenance,” or dynamic world state changes (e.g., weather, time of day) to all clients.
4. **Emergency Broadcasts in Simulations**\
   In training simulations or command and control systems, use Notifier to push high-priority warnings or scenario triggers to all participants simultaneously.
5. **Live Event Coordination**\
   Trigger synchronized actions or effects across thousands of clients in real-time virtual concerts, esports events, or live multiplayer experiences.


---

# Agent Instructions: 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:

```
GET https://help.diarkis.io/en/diarkis-modules/notifier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.