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](https://github.com/yangzijian52/csworld) * [Downloads](https://github.com/yangzijian52/csworld/releases) * [English Support and Issues](https://github.com/yangzijian52/csworld/issues) * [MIT License](https://github.com/yangzijian52/csworld/blob/main/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.