配置文件与变量

config.yml

改完执行 /cw reload。插件更新时会自动补上新增的项目。

配置项	默认	说明
`teleport.safe-location`	`true`	传送到出生点这类大概位置时找安全落点
`teleport.warmup-seconds`	`0`	玩家自己传送的预热秒数（移动或受伤取消）
`teleport.cooldown-seconds`	`0`	两次自我传送的冷却秒数
`join.first-join-destination`	空	第一次进服送到哪里
`join.every-join-destination`	空	每次进服送到哪里
`join.respawn-destination`	空	没有床、世界也没设 respawn-world 时的重生点
`enforce.gamemode`	`true`	进入世界时切换成世界设定的模式
`enforce.flight`	`true`	套用 allow-flight
`enforce.access`	`true`	套用 access-permission
`enforce.player-limit`	`true`	套用 player-limit
`enforce.move-players-on-unload`	`true`	卸载 / 删除 / 重置前把玩家送走
`worlds.delete-to-trash`	`true`	删除时先搬进回收区
`worlds.trash-keep-days`	`7`	回收区保留几天，`0` = 永久
`worlds.import-other-plugins`	`true`	第一次启动自动导入 My_Worlds / Multiverse 的设置
`worlds.manage-unknown-worlds`	`true`	已加载但不在 worlds.yml 的世界自动纳入管理
`bungeecord`	`true`	允许 `server:子服` 目的地
`portals.wand`	`BLAZE_ROD`	选区工具
`portals.cooldown-millis`	`1500`	走进区域传送门后多久内不再触发
`portals.search-radius` / `creation-radius`	`128` / `16`	地狱门连结时找现成门 / 建新门的范围
`portals.allow-entities`	`true`	生物、掉落物能否跟着传送门连结走
`portals.sign-marker`	`[cw]`	传送告示牌第一行
`optimize.pregen-max-mspt`	`40`	预生成时每 tick 超过几毫秒就暂停
`optimize.pregen-parallel-chunks`	`8`	预生成同时进行的区块数
`optimize.check-interval-seconds`	`30`	自动卸载 / 自动重置 / 实体上限的检查间隔
`inventories.enabled`	`false`	分世界背包

提示文字全部在 messages.yml，支持 MiniMessage 与 &a 色码，留空 '' 表示不显示。

PlaceholderAPI 变量

变量	内容
`%cloudworlds_world%`	所在世界名称
`%cloudworlds_alias%`	所在世界别名（带颜色）
`%cloudworlds_alias_plain%`	所在世界别名（无颜色）
`%cloudworlds_alias_<世界>%`	指定世界的别名
`%cloudworlds_players%` / `%cloudworlds_players_<世界>%`	所在 / 指定世界的人数
`%cloudworlds_meta_<键>%`	所在世界的自定义资料（`/cw meta`）
`%cloudworlds_inventory_group%`	所在世界的背包群组
`%cloudworlds_loaded%`	已加载的世界数量

开发者 API

把 jar 加为 compileOnly 依赖：

import dev.cloudplugins.worlds.api.CloudWorldsAPI;

if (CloudWorldsAPI.isReady()) {
    String alias = CloudWorldsAPI.alias(player.getWorld());        // 世界别名（MiniMessage）
    String cat = CloudWorldsAPI.meta(player.getWorld(), "category");
    String group = CloudWorldsAPI.inventoryGroup(player.getWorld());
    CloudWorldsAPI.teleport(player, "a:spawn");                    // 用目的地写法传送
}

config.yml​

PlaceholderAPI 变量​

开发者 API​

config.yml

PlaceholderAPI 变量

开发者 API