> For the complete documentation index, see [llms.txt](https://pro-hytale-mods.gitbook.io/pro-hytale-mods-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pro-hytale-mods.gitbook.io/pro-hytale-mods-docs/server-administrators/partypro-xp-sharing-configuration-guide.md).

# PartyPro XP Sharing Configuration Guide

PartyPro supports XP sharing integrations with **RPGLeveling** and **MMOSkillTree**. This guide explains all configuration options.

***

### RPGLeveling Integration

**Config File:** `PartyPro/RPGLeveling_x_PartyPro.json`

#### Configuration Options

| Option                        | Type    | Default           | Description                                                                                |
| ----------------------------- | ------- | ----------------- | ------------------------------------------------------------------------------------------ |
| `enabled`                     | boolean | `true`            | Enable/disable XP sharing globally                                                         |
| `groupMultiplier`             | double  | `1.0`             | Fallback XP multiplier (used if no party size multiplier is set)                           |
| `maxShareDistance`            | double  | `-1`              | Maximum distance (blocks) for XP sharing. `-1` = unlimited                                 |
| `killerGetsFullXP`            | boolean | `false`           | If `true`, killer keeps 100% XP + others get multiplied XP. If `false`, XP is split evenly |
| `defaultEnabledForNewParties` | boolean | `true`            | Default state of "Share XP" checkbox for new parties                                       |
| `partySizeMultipliers`        | object  | `{"2": 1.0, ...}` | XP multiplier per party size (2-16 players)                                                |

#### Example Config

```json
{
  "enabled": true,
  "groupMultiplier": 1.0,
  "maxShareDistance": -1,
  "killerGetsFullXP": false,
  "defaultEnabledForNewParties": true,
  "partySizeMultipliers": {
    "2": 1.5,
    "3": 1.3,
    "4": 1.2,
    "5": 1.1,
    "6": 1.0,
    "7": 1.0,
    "8": 1.0,
    "9": 1.0,
    "10": 1.0,
    "11": 1.0,
    "12": 1.0,
    "13": 1.0,
    "14": 1.0,
    "15": 1.0,
    "16": 1.0
  }
}
```

#### In-Game Settings (Party Leader)

* **Share XP with Party**: Toggle XP sharing on/off for the party

***

### MMOSkillTree Integration

**Config File:** `PartyPro/MMOSkillTree_x_PartyPro.json`

#### Configuration Options

| Option                        | Type    | Default           | Description                                                                                |
| ----------------------------- | ------- | ----------------- | ------------------------------------------------------------------------------------------ |
| `enabled`                     | boolean | `true`            | Enable/disable skill XP sharing globally                                                   |
| `groupMultiplier`             | double  | `1.0`             | Fallback XP multiplier (used if no party size multiplier is set)                           |
| `maxShareDistance`            | double  | `-1`              | Maximum distance (blocks) for XP sharing. `-1` = unlimited                                 |
| `killerGetsFullXP`            | boolean | `false`           | If `true`, earner keeps 100% XP + others get multiplied XP. If `false`, XP is split evenly |
| `defaultEnabledForNewParties` | boolean | `true`            | Default state of "Share MMO Skill XP" checkbox for new parties                             |
| `defaultShareAllSkills`       | boolean | `false`           | Default state of "Share All Skills" checkbox for new parties                               |
| `pollingIntervalMs`           | int     | `500`             | How often to check for XP changes (milliseconds)                                           |
| `partySizeMultipliers`        | object  | `{"2": 1.0, ...}` | XP multiplier per party size (2-16 players)                                                |

#### Example Config

```json
{
  "enabled": true,
  "groupMultiplier": 1.0,
  "maxShareDistance": 100,
  "killerGetsFullXP": true,
  "defaultEnabledForNewParties": true,
  "defaultShareAllSkills": false,
  "pollingIntervalMs": 500,
  "partySizeMultipliers": {
    "2": 2.0,
    "3": 1.8,
    "4": 1.6,
    "5": 1.4,
    "6": 1.2,
    "7": 1.0,
    "8": 1.0,
    "9": 1.0,
    "10": 1.0,
    "11": 1.0,
    "12": 1.0,
    "13": 1.0,
    "14": 1.0,
    "15": 1.0,
    "16": 1.0
  }
}
```

#### In-Game Settings (Party Leader)

* **Share MMO Skill XP**: Toggle skill XP sharing on/off for the party
* **Share All Skills**: When enabled, ALL skills are shared regardless of selected skill

***

### How XP Distribution Works

#### killerGetsFullXP = false (Split Mode)

```
Player A earns 100 XP, Party has 4 members, Multiplier = 1.5

Total XP Pool = 100 × 1.5 = 150 XP
Each member gets = 150 / 4 = 37.5 XP

Player A: Gets 37.5 XP (already got 100, so gets -62.5 adjustment... wait, they already got 100 from the game)
Actually: Player A keeps original 100 XP, others get 37.5 XP each
```

#### killerGetsFullXP = true (Bonus Mode)

```
Player A earns 100 XP, Party has 4 members, Multiplier = 1.5

Player A: Keeps 100 XP + gets bonus (100 × 1.5 - 100 = 50 XP) = 150 XP total
Other members: Each gets 100 × 1.5 = 150 XP
```

***

### Party Size Multipliers

Use `partySizeMultipliers` to balance XP based on party size:

```json
"partySizeMultipliers": {
  "2": 2.0,   // 2 players = 200% XP
  "3": 1.5,  // 3 players = 150% XP
  "4": 1.25, // 4 players = 125% XP
  "5": 1.0,  // 5+ players = 100% XP
  ...
}
```

This allows you to:

* Reward smaller parties with bonus XP
* Prevent large parties from being too powerful
* Create custom balancing for your server

***

### MMOSkillTree: Share All Skills

When **Share All Skills** is **OFF**:

* Only players with the SAME skill selected receive shared XP
* Example: Player A (Swords) kills mob → Only party members with Swords selected get XP

When **Share All Skills** is **ON**:

* ALL party members receive XP regardless of their selected skill
* Example: Player A (Swords) kills mob → Everyone gets Swords XP, even if they have Mining selected
* ALL skills are monitored for XP gains (not just the selected one)

***

### Tips

1. **Distance Limiting**: Set `maxShareDistance` to prevent AFK players from getting XP
2. **Balancing**: Use `partySizeMultipliers` to prevent large parties from leveling too fast
3. **Performance**: Increase `pollingIntervalMs` if you have many players (MMOSkillTree only)
4. **Defaults**: Set `defaultEnabledForNewParties` to `false` if you want XP sharing opt-in


---

# 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://pro-hytale-mods.gitbook.io/pro-hytale-mods-docs/server-administrators/partypro-xp-sharing-configuration-guide.md?ask=<question>&goal=<endgoal>
```

`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.