Cross-Server Duels

Cloud provides a way to sync duel requests across an entire network of servers using Velocity, allowing users to duel anyone on the network.

Note: Cross-server duels are an add-on for Cloud and are not included in the base plugin.

Setup

Proxy Setup

1. Download the cloud-velocity-<version>.jar file and place it in your plugins folder.

2. Restart the server.

3. Navigate to the plugins/cloud-velocity/config.yml file.

4. List the allowed server names and save the file.

5. Copy the generated authentication key.

6. Restart the server.

✅ Done! The proxy has been successfully configured.

auth-key: <key>
allowed-servers:
- duels1
- duels2
- duels3
settings:
  transfer-timeout-seconds: 30

Backend Setup

1. Navigate to the plugins/Cloud/cross_communication.yml file.

2. Set the proxy.enabled field to true.

3. Paste the copied authentication key from the proxy.

4. Configure the current server name.

5. Configure the allowed servers list.

6. Save the file.

7. Restart the server.

✅ Done! The backend has been successfully configured.

proxy:
  enabled: true
  auth-key: <key>
  server-name: "duels1"
  allowed-servers:
    - duels1
    - duels2
    - duels3

(Repeat this process for all backend servers.)

Note

All backend servers must have the same configured kits, arenas, and locations. Copy-pasting all configurations and duel arenas is highly recommended for consistency.

✅ Done! You have successfully configured both the proxy and the backends.

Test it out by having two players on different servers and sending a duel request to a player on another server. For example:

Darkxx is on the Duel1 server, and Floret is on Duel2. Darkxx sends a duel request to Floret using /duel Floret, and Floret receives the request while on Duel2.

If Floret accepts the request, both players will be automatically transferred to the target server, where the duel will take place!

Limitations

Currently, there are a few limitations:

• A player must be active on a backend server for a duel to occur. For example, if Darkxx and Floret are on Duel1, and Darkxx sends a duel request to Floret to take place on Duel2, but Duel2 has no active players, the duel will not start. The target server must have at least one active player for the duel to initialize properly.

• The /duel <player> command updates its tab completions every 10 seconds to display all network-wide players.

• Wager/Money Betting is not currently available in cross-server duels.

We are actively working to overcome these limitations.