# ⁉️ Questions & Answers

## Setup and arenas

<details id="why-regeneration-causes-lag-to-my-server">

<summary>Why does regeneration cause lag on my server?</summary>

Schematic regeneration relies on WorldEdit, and plain WorldEdit does not run its tasks asynchronously, so large pastes stall the server. Install [FAWE (Fast Async WorldEdit)](https://www.spigotmc.org/resources/fastasyncworldedit.13932/) instead, which handles the same work far more efficiently.

</details>

<details id="why-are-my-arenas-not-regenerating">

<summary>Why are my arenas not regenerating?</summary>

Work through these in order. One of them is nearly always the cause.

1. **Regeneration is switched off for the map.** Open the map in the editor and check that Regeneration is enabled. It is off by default on a new map.
2. **No schematic was generated.** Schematic regeneration needs a saved copy of the arena to paste back. Generate it from the map's regeneration menu.
3. **WorldEdit or FAWE is missing.** If the map's **Regeneration Engine** is set to WorldEdit, one of them must be installed. Switch the engine to Internal if you would rather not install either.
4. **The universal region does not cover the whole build.** Anything outside it is not part of the arena and is never restored. This is the usual cause of "most of it comes back, but not all of it".
5. **Blocks were changed outside the region.** Players who build their way out of the arena leave blocks the plugin has no record of.

By default the arena is restored when the match ends. To restore it between rounds as well, turn on **Post Round Regeneration**. If you suspect a previous regeneration silently failed, **Pre Match Regeneration** restores the arena again at the start of every match as a safety net.

See [Arena Regeneration](../../main-features/create-a-map/arena-regeneration.md).

</details>

<details id="why-does-the-scoreboard-stays-the-same-even-when-i-edit-it">

<summary>Why does the scoreboard stay the same when I edit it?</summary>

Every mode comes with its own scoreboard, and that one is shown instead of the main scoreboard. Disable the mode's scoreboard in the editor or in the mode's file in the `modes` folder, and the mode falls back to the plugin's main scoreboard.

</details>

<details id="how-can-i-use-a-void-world-for-my-arenas">

<summary>How can I use a void world for my arenas?</summary>

Use a world generator plugin such as [VoidGen](https://www.spigotmc.org/resources/voidgen.25391/), which works with Multiverse.

</details>

<details id="what-is-the-difference-between-battle-region-and-the-universal-region">

<summary>What is the difference between the Battle Region and the Universal Region?</summary>

The **Battle Region** is where the fight takes place. Players cannot leave it, and inside it they can build, break blocks and so on. The duel always happens inside the Battle Region.

The **Universal Region** is the whole arena. It is what regeneration and duplication work on.

</details>

<details id="why-cant-players-place-or-break-blocks-in-my-arena">

<summary>Why can't players place or break blocks in my arena?</summary>

Building is only allowed when the arena will regenerate, and only inside the Battle Region. If either is missing, the block is cancelled.

Enable regeneration on the arena, and make sure the Battle Region covers the area players build in. If regeneration is already enabled, disable and enable it again so the schematic is rebuilt.

Also check that no arena rule, WorldGuard flag or `spawn-protection` is blocking it. Spectators can never build.

</details>

<details id="how-do-i-turn-off-match-broadcasts">

<summary>How do I turn off match broadcasts?</summary>

Match result broadcasts are a **per-mode** setting, so there is no single switch for the whole server.

Open the mode in the editor and turn off **Broadcast Results**, or set `public-broadcast` to false in that mode's file under `modes/`. Repeat for every mode you want silent. See [Create a Mode](../../main-features/create-a-mode/README.md).

</details>

## Matches and spectating

<details id="why-cant-players-hit-each-other-right-after-a-round-starts">

<summary>Why can't players hit each other right after a round starts?</summary>

This is almost always EssentialsX's own post-teleport protection, not PhoenixDuels. Players are teleported into the arena when a round starts, and the `teleport-invulnerability` setting in Essentials' `config.yml` grants a few seconds of invulnerability after any teleport, including ones made by other plugins. Essentials does not expose it through its API, so PhoenixDuels cannot bypass it.

Lower or disable it in Essentials' `config.yml`:

```yaml
teleport-invulnerability: 0
```

The setting applies server-wide, so it also stops protecting players who teleport with `/home`, `/warp`, `/spawn` and so on.

</details>

<details id="why-do-matches-cancel-when-a-player-is-in-combat">

<summary>Why do matches cancel when a player is in combat?</summary>

You have CombatLogX installed, and one of the participants was still combat-tagged from fighting out in the world.

Phoenix Duels refuses to start a match while anyone taking part is tagged, and the cancellation message names the player responsible. Wait for their combat tag to expire and start again.

Fighting inside a duel never tags anyone, so this only comes from PvP outside the arena. There is no setting to skip the check; the only way to drop the behaviour is to remove CombatLogX.

</details>

<details id="why-is-nobody-getting-matched-in-ranked">

<summary>Why is nobody getting matched in ranked?</summary>

Ranked matchmaking will not pair two sides whose ratings are too far apart. How far is set by **tolerance** in `elo.yml`, and it defaults to 200.

With that default a player rated 500 can only be matched against someone between 300 and 700. Two players can sit in the ranked queue indefinitely if the gap between them is wider, even when they are the only two waiting.

On a small or quiet server, raise `tolerance`. Higher values fill queues faster at the cost of less even matches. It is also editable in the editor, under **Settings > Elo Settings**.

```yaml
tolerance: 500
```

Also check that:

* An arena is actually free. If every arena of every map allowing that mode is busy, nobody is matched.
* The mode allows the ranked player type being queued for, so a mode without `RANKED_DUO` never produces a ranked 2v2.
* The players meet the unranked requirement, if it is on. Players who have not met it cannot enter the ranked queue at all.

</details>

<details id="how-do-i-allow-only-ranked-mode">

<summary>How do I allow only Ranked mode?</summary>

Either disable the **Custom** and **Unranked** types in the plugin settings of the in-game editor, or set `allowed-types` in `config.yml` to Ranked only:

<figure><img src="../../.gitbook/assets/Screenshot 2025-03-03 191707.png" alt=""><figcaption></figcaption></figure>

```yaml
allowed-types:
- RANKED
```

</details>

<details id="where-did-my-items-go-after-a-cancelled-match">

<summary>Where did my items go after a cancelled match?</summary>

They are almost certainly in **Lost Items**. Run `/duellostitems` to get them back.

The plugin never drops or deletes items it owes a player. When it cannot hand them over, it stores them until the player claims them. That happens when:

* A match with item betting is cancelled and the player's inventory is full when the stakes are returned.
* Winnings are paid out while the player is offline.
* A kit or reward cannot fit in the player's inventory.

Players with something waiting are told so a few seconds after they join. See [Lost Items](../../features/lost-items.md).

</details>

<details id="does-money-betting-need-vault">

<summary>Does money betting need Vault?</summary>

Yes. Money betting needs Vault together with an economy plugin.

Without Vault the option still appears and can still be switched on, but it does nothing: no stake is taken and no payout is made. There is no startup warning about it, which is why it can look like it is working when it is not.

Item betting does not need Vault. See [Betting](../../features/betting.md).

</details>

<details id="what-does-the-plugin-do-to-the-tab-list-during-a-duel">

<summary>What does the plugin do to the tab list during a duel?</summary>

Before 4.0 it only adds a prefix and leaves the tab list global. From 4.0 the tab list can show only the players in the match plus their spectators, with prefixes you can customise.

</details>

<details id="can-i-turn-off-the-spawn-protection">

<summary>Can I turn off the spawn protection?</summary>

No, there is no option to disable it.

</details>

<details id="which-spectator-engine-should-i-use">

<summary>Which spectator engine should I use?</summary>

Use **Default** unless you have a specific reason not to.

* **Default** puts the spectator into real Minecraft spectator gamemode and restores their previous gamemode when they leave. They can fly through blocks and cannot interact with anything.
* **Legacy** keeps the spectator in survival and makes them an invisible, flying ghost instead. It exists for setups where changing a player's gamemode causes problems with another plugin.

The setting is under **Settings > Match Settings > Spectator Engine**, or `match.spectator-engine` in `config.yml`.

> **Info:**
The Lite version always uses Legacy, whatever the setting says.

</details>

<details id="why-cant-a-player-spectate-a-match-they-disconnected-from">

<summary>Why can't a player spectate a match they disconnected from?</summary>

This is deliberate and cannot be turned off.

A player who leaves a match, by disconnecting or by quitting out of it, is barred from returning to that same match as a spectator. Without the rule a player could drop out of a fight they were losing and come straight back to watch their opponents, which is an obvious way to scout or to grief.

The restriction only covers the match they left. They can spectate any other match normally.

</details>

## Stats and placeholders

<details id="how-do-i-make-a-top-10-leaderboard">

<summary>How do I make a top 10 leaderboard?</summary>

Use the leaderboard placeholders with a hologram plugin, one line per position. A placeholder ending in a rank number returns the **name** of the player at that position. Adding `_value` returns their score instead.

For the top 10 by elo:

```
%phoenixduels_ranked_elo_1%
%phoenixduels_ranked_elo_2%
%phoenixduels_ranked_elo_3%
```

...through to `_10`. To show the rating next to the name, put both on the line:

```
&e#1 &f%phoenixduels_ranked_elo_1% &7- &a%phoenixduels_ranked_elo_1_value%
```

For other metrics, swap `elo` for `totalkills`, `totaldeaths`, `totalwins`, `totallosses`, `totaldraws` or `kdratio`. Add a mode id to scope it to one mode:

```
%phoenixduels_ranked_crystal_totalkills_1%
```

Add a period in front for a rolling board:

```
%phoenixduels_weekly_ranked_totalwins_1%
```

> **Info:**
Elo is only available for the `all` period, because it is a current rating rather than something accumulated over a window.

The full grammar is on the [Placeholders](../placeholders.md) page. Leaderboards are cached, and `leaderboard-fetch-interval` controls how often they refresh.

</details>

<details id="what-is-global-elo">

<summary>What is global elo?</summary>

Global elo is the **average** of a player's ratings across every mode, not a separate rating and not a total. Each player holds an independent rating per mode, and `%phoenixduels_ranked_global_elo%` averages them into one number.

Modes the player has never touched still count toward the average, at the default rating. On a server with four ranked modes, a player rated 900 in the one mode they play and untouched in the other three has a global elo of 600, not 900, because the three defaults of 500 are averaged in.

Only modes that allow a ranked player type are counted. See [Elo](../../features/elo.md).

</details>

<details id="what-tables-does-the-plugin-create-in-my-database">

<summary>What tables does the plugin create in my database?</summary>

Six core tables, plus one for each of three add-ons. They are created automatically on first start, on both SQLite and MySQL, and every name honours your `database.table-prefix`.

* `_duels_player_table` - one row per player.
* `_ranking_score_table` - one row per player per mode, holding their elo.
* `_history_records_table` - one row per player per finished match.
* `_match_recaps_table` - the end-of-match snapshot behind the Recap option.
* `_kit_layouts_table` - custom kit layouts.
* `_virtual_storage_table` - the Lost Items storage.

> **Warning:**
Kills, deaths, wins, losses and draws are not stored as counters. They are summed live from the match history table, so there is no column to read them from.

</details>

## Kits, menus and messages

<details id="how-can-i-remove-the-kit-items-from-being-displayed-in-the-menu">

<summary>How can I remove the kit items from the menus?</summary>

Remove the `%kit%` placeholder from the `create_match`, `duel_player` and `select_arena_mode` menus (for custom, unranked and ranked).

<figure><img src="../../.gitbook/assets/image (8).png" alt="" width="563"><figcaption></figcaption></figure>

An item that uses the placeholder:

```yaml
mode-item:
  display-name: '&aPlay %display_name%'
  lore:
  - '&7%description%'
  - ''
  - ' %kit%'
  - ''
  - '&e%arenas% &aavailable arena(s)!'
  - ''
  - '&6Left-Click: &eSelect mode.'
  - '&6Right-Click: &ePreview kit.'
```

</details>

<details id="how-can-i-make-npcs-queue">

<summary>How can I make NPCs queue players?</summary>

Face the NPC and select it with `/npc select`, then give it the play command. This one queues the player for an unranked 1v1 in the classic mode when they interact with the NPC:

```
/npc command add duels play unranked solo classic
```

</details>

<details id="what-does-actiontype-not-implemented-mean">

<summary>What does "ActionType not implemented" mean?</summary>

One of your actions uses a type that does not exist, so the plugin cannot run it. Check the action against the supported list on [Action Types](../action-types.md).

</details>

<details id="what-does-the-missing-translation-warning-mean">

<summary>What does the "Missing translation" warning mean?</summary>

The plugin looked for a line in your active language file and did not find one, so it fell back to English. It is a warning rather than an error, and nothing breaks. It usually happens after an update that added new messages, since your existing translation file predates them.

The warning names the missing key. Either add that key to your translation file under `translations/`, or, if you have not customised the file, delete it and restart so the plugin writes a fresh, complete one. See [Languages & Translations](../../configurations/languages.md).

> **Warning:**
Deleting the file discards any wording you changed. Take a copy first if you have edited it.

</details>

## Compatibility

<details id="does-phoenixduels-work-on-velocity-or-bungeecord">

<summary>Does PhoenixDuels work on Velocity or BungeeCord?</summary>

Yes, but it is not a proxy plugin, and there is no Velocity or BungeeCord jar. PhoenixDuels is a Spigot/Paper plugin and runs on the **backend servers** behind your proxy, exactly as it would on a standalone server. Put it on your duels server, not on the proxy.

Point every backend at the same MySQL database and they share player statistics, elo, match history, player kits and lost items. They do **not** share live state on their own: queues, parties and matches are per-server. The paid [Cross-Server Queue](../../add-ons/cross-server-queue/README.md) add-on makes the solo unranked and ranked queues network-wide, with a small proxy jar for Velocity or BungeeCord: players queue from any server, hubs included, and are sent to the Duels server with free arenas. Parties and party matches stay per-server.

To let two separate installations share one database without colliding, give each a different `database.table-prefix`.

</details>

<details id="does-phoenixduels-have-an-ffa-mode">

<summary>Does PhoenixDuels have an FFA mode?</summary>

Party FFA is included, so a party can fight free for all between its own members. Public arenas that anyone can walk into come with the [Public FFA](../../add-ons/public-ffa/README.md) add-on.

</details>

<details id="does-phoenixduels-support-party-plugins">

<summary>Does PhoenixDuels support party plugins?</summary>

No, there is no hook for external party plugins such as Party and Friends. PhoenixDuels has its own [party system](../../features/party/README.md), including `/party fight`, which those plugins do not provide.

</details>

<details id="can-the-plugin-run-as-a-forge-or-fabric-mod">

<summary>Can the plugin run as a Forge or Fabric mod?</summary>

No, there is no mod version. Hybrid servers such as Arclight or Mohist can load it, but we do not recommend them, and faults caused by the hybrid itself, such as its own teleport handling, are not plugin issues.

</details>

<details id="why-cant-a-player-rejoin-after-a-duel-on-a-hybrid-server">

<summary>Why can't a player rejoin after a duel on a hybrid server?</summary>

On hybrid servers such as Arclight, Youer or Mohist, the player who died in a duel can get kicked with `multiplayer.disconnect.duplicate_login` every time they try to rejoin. The server still holds a ghost copy of that player, so it rejects the new login.

The plugin respawns dead players itself when a world does not respawn them automatically, and some hybrids do not clean up the old player when that happens. Turn on immediate respawn in every arena world so the server respawns players on its own:

```
/gamerule doImmediateRespawn true
```

A server restart clears any ghost players that are already stuck.

</details>

<details id="why-isnt-the-newest-minecraft-version-supported-yet">

<summary>Why isn't the newest Minecraft version supported yet?</summary>

A new release is added once it has settled, so there is a gap between launch and support. Our plugins are updated one at a time, and PhoenixDuels usually comes after PhoenixLobby and PhoenixCrates. There is no ETA, and updates are free for life. The current list is on [Version Support](../../first-installation.md#version-support).

</details>

## Add-ons and purchases

<details id="which-add-ons-work-on-the-lite-version">

<summary>Which add-ons work on the Lite version?</summary>

None. Every add-on requires PhoenixDuels Premium as its base plugin. Some add-ons are free to download, such as Floor is Lava, Pillar of Fortune and Rematch & Requeue; free refers to their price, not to the edition they run on.

An add-on placed in the `addons` folder of a Lite installation refuses to load and says so in the console on startup. The rest of the plugin keeps working normally.

</details>

<details id="why-do-add-ons-appear-in-my-addons-folder">

<summary>Why do add-ons appear in my addons folder?</summary>

The jar you downloaded is the bundle, which carries the add-ons inside it and unpacks them on startup. Log in on the product page and download the core-only jar if you do not want them.

</details>

<details id="do-you-offer-refunds">

<summary>Do you offer refunds?</summary>

No. A downloaded product is not refundable. See point 7 of the [Terms and Conditions](https://www.phoenixplugins.com/terms-and-conditions).

</details>

Source: https://www.phoenixplugins.com/docs/phoenix-duels/plugins/questions-and-answers