Region Setting

> **Note:** This feature is **disabled by default** in version **V3.3.3.0**. To enable it, add the following configuration item to `larkxr-center/application.properties` and restart the service:

```
pxy.dispatch-policy.enable-multi-region-dispatch=true
```

## Overview

The Region Setting feature allows you to divide rendering servers into named partitions (regions) and configure intelligent client dispatch based on geographic proximity or network latency.

## Configuring Partitions on a Rendering Server

Each rendering server can be assigned a **Region ID** and **Region Name** via the Admin Configuration panel. These fields are available under the **General** tab of the Render Configuration window.

![](https://docs.paraverse.cc/media/202505/8c5817ede1df448f9593a00e199fbaa76539.png)

Once the rendering service has started successfully, the partition information is automatically registered and displayed in the Region Settings interface. You can then assign each region to a specific city.

![](https://docs.paraverse.cc/media/202504/f507dcbb5af4417ea6aa02ab17c58e357258.png)

## Client Dispatch Strategy

The system supports two dispatch modes:

- **Distance-based (default):** When RTT detection is disabled, the client is allocated to the partition belonging to the geographically closest city.
- **RTT-based:** When RTT detection is enabled, distance-based allocation is bypassed. The client's browser performs RTT (round-trip time) detection on all available regions via the front-end overview screen. The system then selects the partition with the lowest network latency and prioritizes allocation to that region.

If the target region's resources are fully occupied, the system automatically falls back to the global resource pool and allocates the client to the next available region.

> **Note:** When the site uses the **HTTPS** protocol, RTT detection must use the **WSS** protocol. Each detection node must be configured with a valid SSL certificate and a corresponding domain name; otherwise, RTT detection will not function correctly.

## Directed Partition

A **directed partition** is a partition explicitly bound to a specific workspace. When an application uses **semi-active synchronization**, it can only synchronize to the directed partition within the selected workspace.

### Setting Up a Directed Partition

To configure a directed partition, modify the rendering agent's configuration file:

1. Set `pxy.host.region-type` to `1`.
2. Restart the agent service.

Once the server re-registers successfully, it will automatically be treated as a directed partition.