Questions & Answers

Questions & Answers

Short answers to the questions server owners ask most, grouped by topic.

View as Markdown ·

On this page

#Setup and arenas

Why does regeneration cause lag on my server?

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) instead, which handles the same work far more efficiently.

Why are my arenas not regenerating?

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.

Why does the scoreboard stay the same when I edit it?

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.

How can I use a void world for my arenas?

Use a world generator plugin such as VoidGen, which works with Multiverse.

What is the difference between the Battle Region and the Universal Region?

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.

Why can't players place or break blocks in my arena?

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.

How do I turn off match broadcasts?

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.

#Matches and spectating

Why can't players hit each other right after a round starts?

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.

Why do matches cancel when a player is in combat?

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.

Why is nobody getting matched in ranked?

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.
How do I allow only Ranked mode?

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:

YAML
allowed-types:
- RANKED
Where did my items go after a cancelled match?

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.

Does money betting need Vault?

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.

What does the plugin do to the tab list during a duel?

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.

Can I turn off the spawn protection?

No, there is no option to disable it.

Which spectator engine should I use?

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.

circle-info

The Lite version always uses Legacy, whatever the setting says.

Why can't a player spectate a match they disconnected from?

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.

#Stats and placeholders

How do I make a top 10 leaderboard?

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%

circle-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 page. Leaderboards are cached, and leaderboard-fetch-interval controls how often they refresh.

What is global elo?

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.

What tables does the plugin create in my database?

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.

circle-exclamation

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.

#Kits, menus and messages

How can I remove the kit items from the menus?

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

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.'
How can I make NPCs queue players?

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
What does "ActionType not implemented" mean?

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.

What does the "Missing translation" warning mean?

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.

circle-exclamation

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

#Compatibility

Does PhoenixDuels work on Velocity or BungeeCord?

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

Does PhoenixDuels have an FFA mode?

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

Does PhoenixDuels support party plugins?

No, there is no hook for external party plugins such as Party and Friends. PhoenixDuels has its own party system, including /party fight, which those plugins do not provide.

Can the plugin run as a Forge or Fabric mod?

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.

Why can't a player rejoin after a duel on a hybrid server?

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.

Why isn't the newest Minecraft version supported yet?

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.

#Add-ons and purchases

Which add-ons work on the Lite version?

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.

Why do add-ons appear in my addons folder?

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.

Do you offer refunds?

No. A downloaded product is not refundable. See point 7 of the Terms and Conditions.

My Cart
Spider

Your cart is empty

Looks like the spiders padded through here. Pick a plugin and it will show up here. Continue shopping