CSworld

CSworld

Cross-Server Teleportation with Free, One-Time Unlock and Per-Use Payment Modes Language notice: The SpigotMC resource page, documentation and support channel are English-only. Chinese-language support is not provided on SpigotMC. The plugin itself currently uses Chinese for default configuration comments, player messages, administrator feedback and console messages.

About CSworld

CSworld is a lightweight cross-server teleport plugin for Paper proxy networks. Players can view configured destinations and connect by entering either the proxy server name or its configured display name. Vault integration provides three operating modes: completely free transfers, a one-time payment that permanently unlocks a destination, or a charge on every transfer. The plugin sends the standard BungeeCord Connect plugin message. It is intended for an existing proxy network; it does not create or manage backend servers.

Compatibility

• Server software: Paper 26.2 only
• Paper API used to build: 26.2.build.56-alpha
• Java: 25 or newer
• Plugin API declaration: 1.21
• Proxy requirement: A proxy network that accepts the BungeeCord Connect plugin message
• Build validation: Maven package build completed successfully
• Testing status: No automated test sources are included and no live Paper 26.2 server test has been performed for this release
• Spigot server compatibility has not been tested and is not claimed

Free Resource

CSworld is published as a free resource at USD 0.00. The project is compact, open source under the MIT License, uses no proprietary online service and is best suited to transparent community distribution. The source code and release downloads are publicly available on GitHub.

Main Features

• Cross-server connection through the BungeeCord plugin messaging channel
• Destination list available with /cs
• Destination lookup by proxy server key or configured display name
• Three-second countdown and per-player duplicate-transfer guard
• Manual current-server check to prevent selecting the configured local server
• Global free-transfer mode
• One-time payment mode with permanent destination unlocks
• Per-transfer payment mode
• Vault economy integration
• Configuration reload without a full server restart

Transfer and Safety Behaviour

Only destinations explicitly listed under servers in config.yml can be selected. CSworld blocks a second request while the same player is already in the three-second countdown and rejects the destination configured as current-server. The current-server value is manual; the plugin does not query the proxy to discover the actual backend server. CSworld asks the proxy to connect the player after the countdown. It does not verify that the destination exists or is online, and it cannot confirm that the proxy completed the connection.

Payments and Unlock Data

• Free mode: No economy transaction is attempted.
• One-time payment: Vault withdraws the configured amount once, then the player's UUID is stored for that destination in plugins/CSworld/data.yml. Later transfers to that destination are free.
• Per-use payment: Vault withdraws the configured amount before every connection request; no unlock record is stored.
• If Vault has no registered economy provider, the plugin falls back to free mode for that runtime.
• The unlock record is saved immediately after a successful withdrawal and before the proxy connection request.
• There is no automatic refund or rollback if the proxy connection fails after payment.

Dependencies

• Vault: Required by plugin.yml
• Economy provider: Required when using one-time or per-use payments
• Proxy network: Required for cross-server connections
• Paper API and Vault API are provided dependencies and are not bundled inside the release jar

Links

• Source Code
• Downloads
• English Support and Issues
• MIT License

Important Notes

• CSworld is designed for Paper 26.2 proxy networks, not standalone single-server teleportation.
• Vault is declared as a required plugin and must be installed even when free-mode is enabled.
• Paid modes require a Vault-compatible economy provider.
• Use non-negative whole numbers for destination costs.
• Destination display names should not contain spaces because the command reads one destination argument.
• Back up plugins/CSworld/data.yml before replacing or editing unlock data.
• No automatic refund is available when a proxy transfer fails after a successful charge.
• The plugin interface is currently Chinese, while the SpigotMC page, documentation and support are English-only.