跳到主要内容

安装与获取

下载与授权（免费）​

  1. 打开 资源中心，注册并登录。
  2. 在 CloudWorlds 云世界 点「免费领取」，永久授权码会加入你的会员中心。
  3. 打开详情，下载最新的 CloudWorlds-<版本>-簡體授權版.jar。

运行环境​

项目要求
服务端Paper / Purpur 1.20 – 26.x（1.20 – 1.21 用 Java 21；26.x 用 Java 25）
前置插件无
可选Vault（金币入场费、传送门收费）、PlaceholderAPI（变量）、BungeeCord / Velocity（跨服目的地）
不支持Folia、原生 Spigot
26.x 的世界文件夹位置

从 26.1 开始，Paper 把所有世界都放进主世界文件夹：world/dimensions/minecraft/<世界名称小写>（主世界、地狱、末地分别是 overworld、the_nether、the_end）。 升级时根目录的旧世界文件夹会被自动迁移并删除，这是正常现象。云世界 1.0.4 起两种位置都认得，开服照常自动加载。

全新安装​

  1. 把插件放进 plugins/，启动服务器。
  2. 打开 plugins/CloudWorlds/token.yml，填入授权码，重启（首次启动自动绑定本机）。
  3. 输入 /cw list，看到世界列表就成功了。
控制台显示「无法连接授权服务器」

第一次启动必须连上 license.plugins.wiki 验证一次。控制台会写出原因：

原因处理
DNS 解析不到换 DNS（例如 223.5.5.5 / 119.29.29.29）后重启
连线被拒绝或无法建立主机商 / 面板的防火墙放行对外 HTTPS；本机电脑检查杀毒软件是否拦截 java.exe
连线超时网络太慢或被拦截；稍后重启再试
HTTPS 握手失败关闭会拦截 HTTPS 的代理或网络设备

本机电脑如果是靠加速器 / 代理（例如 Clash）才打得开网站：浏览器会走代理，但 Java 不会。请开启加速器的「TUN / 虚拟网卡」模式， 或在启动参数加 -Djava.net.useSystemProxies=true。验证成功一次后，断网也能离线运行 72 小时。

1.0.3 起开服时连不上会每 60 秒自动重试，连上就解锁，不需要重启；HTTPS 被网络拦截时也会自动改用 HTTP 验证。

还没填授权码时

世界仍会照常加载（避免领地等插件出问题），只有 /cw 管理指令会被锁定，控制台会提示领取方式。

从 My_Worlds / Multiverse 换过来​

  1. 关服，备份 plugins/ 与世界文件夹（好习惯）。
  2. 放入 CloudWorlds，移除 My_Worlds 或 Multiverse-Core（以及 Multiverse-Portals、NetherPortals、Inventories、SignPortals）。 My_Worlds 的前置 BKCommonLib，如果没有其他插件需要也可以一起移除。
  3. 开服。第一次启动时，云世界会读取旧插件留下的 worlds.yml，控制台出现：
[CloudWorlds] 已从 My_Worlds / Multiverse-Core 导入 4 个世界的设置（旧插件的文件没有改动）
  1. /cw list 确认所有世界都是 ● 已加载；/cw info <世界> 检查设置。

会被导入的设置：

来源导入内容
My_Worlds自动加载、环境、生成器、强制模式、锁定时间、记住上次位置、PvP、饥饿、结冰积雪、难度、人数上限、成就、床重生、自然回血、地狱 / 末地门连结、重生世界、禁止生物
Multiverse 5别名、隐藏、自动加载、环境、生成器、种子、调整出生点、成就、飞行、天气、重生锚、床重生、难度、入场费、模式、饥饿、人数上限、传送门形成、PvP、重生世界、比例、黑名单、出生点、生物生成
Multiverse 4别名（含颜色）、自动加载、环境、生成器、种子、PvP、比例、重生世界、天气、难度、入场费、饥饿、模式、人数上限、飞行、黑名单、出生点、动物 / 怪物生成

世界的维度（普通 / 地狱 / 末地）以世界文件夹为准：设置文件写错时会按文件夹导入并在控制台提示，不会用错误的环境加载世界。 名称含不支持字符、或找不到文件夹的世界会在控制台说明原因后跳过。

Multiverse 附加插件的资料不会自动导入：Multiverse-Inventories 的分组背包、Multiverse-Portals 的传送门、锚点需要用 /cw group、/cw portal、/cw anchor 重新设置； NetherPortals 的连结如果世界名称是 名称_nether / 名称_the_end 会自动配对，其他用 /cw link 设置。

之后也可以手动重新导入：/cw migrate myworlds 或 /cw migrate multiverse（加 --overwrite 覆盖已有设置）。

不要同时运行两个多世界插件

两个插件都管理世界时会互相覆盖设置。云世界检测到 My_Worlds / Multiverse-Core 还在运行时会在控制台提醒。

文件说明​

plugins/CloudWorlds/
├── config.yml          # 全局设置（传送、进服、强制规则、传送门、性能、分世界背包开关）
├── worlds.yml          # 每个世界的设置（建议用 /cw set 修改）
├── messages.yml        # 全部提示文字
├── inventories.yml     # 分世界背包的群组
├── portals.yml         # 区域传送门
├── anchors.yml         # 锚点
├── token.yml           # 授权码
├── inventories/        # 各群组的玩家背包资料
├── templates/          # 世界模板（自动重置用）
├── backups/            # /cw backup 的 zip
└── trash/              # 删除 / 重新生成 / 还原前的旧世界（默认保留 7 天）
最后于 更新