VextolyWorlds
一个简单但功能强大的多世界 Paper 插件。
使用一条简单的命令即可创建、导入、传送、管理和删除世界,并可通过任何插件扩展自定义的世界类型。
设计初衷是让首次搭建服务器的管理员能在两分钟内上手操作,
同时提供旗帜(flags)、游戏规则(gamerules)、传送前摇、自定义生成器以及
整洁的 Java API 以满足更高级的需求。
功能特性
- 多世界管理 — 创建、导入、加载、卸载和删除世界
- 7 种内置世界类型 — 普通、超平坦、增强型、虚空、下界、末地,以及任意外部生成器
- 通过 API 自定义世界类型 — 其他插件注册的类型可立即在
/vw create 和 /vw types 中使用
- 按世界设置标志 — pvp、火蔓延、生物破坏、爆炸、树叶腐烂、自动加载
- 按世界设置难度和游戏规则 — 直接从聊天框设置,无需切换原版命令
- 带前摇、冷却和移动取消功能的传送 — 安全地进行跨维度传送
- 所有配置均为纯 YAML —
config.yml、messages.yml(完全可翻译)和 worlds.yml
- 安全的删除操作 —
/vw delete 在擦除任何内容前需要二次确认
- 完整的标签页补全 和颜色编码的
/vw help 菜单
- 细粒度的权限控制,默认值合理
- 无需数据库,无额外依赖,世界不会锁定为特定插件格式
环境要求
- 服务器:Paper(或 Paper 分支)1.21.11 – 26.3,包括 25.x/26.x 版本
- Java 21 或更高版本
该插件针对 api-version: 1.21 开发,每个更新的 Paper 构建均支持此版本,
因此单个 jar 文件即可覆盖整个版本范围。
安装方法
- 下载 jar 文件。
- 将
VextolyWorlds-1.0.0.jar 放入服务器的 plugins/ 文件夹中。
- 启动服务器。系统将在
plugins/VextolyWorlds/ 目录下生成 config.yml、messages.yml 和 worlds.yml。
- 在游戏中运行
/vw help。
快速入门(60 秒)
/vw create parkour flat → 创建一个用于建造的平坦世界
/vw tp parkour → 传送到该世界
/vw setspawn → 站在玩家应到达的位置,然后运行此命令
/vw flag parkour pvp false → 禁止在该世界进行战斗
/vw flag parkour leaf-decay false
/vw spawn parkour → 随时返回该世界的出生点
犯错了?运行 /vw delete parkour 后,如果要在 30 秒内再次运行该命令才会真正删除,否则撤销操作。
命令
所有命令均可在游戏聊天栏和控制台中使用。别名:/vw、/vworlds、/vextolyworlds。
| 命令 |
描述 |
/vw help |
显示命令菜单 |
/vw create <name> [type] [seed] |
创建世界(/vw types 列出所有类型) |
/vw import <name> [type] |
添加服务器上现有的世界文件夹 |
/vw delete <name> |
永久删除世界(会请求确认) |
/vw load <name> |
加载一个已卸载的管理世界 |
/vw unload <name> |
卸载一个世界(将内部玩家安全移出) |
/vw list |
显示所有管理和服务器世界 |
/vw types |
显示所有注册的世界类型,包括 API 注册的类型 |
/vw info [world] |
查看类型、环境、种子、难度、出生点、标志、在线玩家 |
/vw tp <world> [player] |
传送自己(或其他玩家)到某个世界 |
/vw spawn [world] |
传送到某个世界的出生点 |
/vw setspawn |
将当前所在位置的出生点设置为你的当前位置 |
/vw flag <world> <flag> [value] |
显示或设置标志 — 省略值则切换状态 |
/vw difficulty <world> <value> |
peaceful、easy、normal 或 hard |
/vw gamerule <world> <rule> [value] |
显示或设置任意原版游戏规则 |
示例:
/vw create survival normal 12345
/vw create creative flat
/vw create darkness void
/vw create mining generator:MyPlugin:cave
/vw flag creative pvp off
/vw gamerule survival keepInventory true
/vw tp mining Notch
游戏规则名称支持多种风格:keepInventory、keep_inventory 和
minecraft:keep_inventory 均被接受,因此你可以按照在任何受支持的服务器版本上最容易记住的方式输入。
权限
| 权限节点 |
默认值 |
允许操作 |
vextolyworlds.help |
op |
/vw help |
vextolyworlds.create |
op |
/vw create |
vextolyworlds.delete |
op |
/vw delete |
vextolyworlds.import |
op |
/vw import |
vextolyworlds.load |
op |
/vw load |
vextolyworlds.unload |
op |
/vw unload |
vextolyworlds.list |
op |
/vw list |
vextolyworlds.info |
op |
/vw info |
vextolyworlds.types |
op |
/vw types |
vextolyworlds.tp |
op |
/vw tp (自身) |
vextolyworlds.tp.others |
op |
/vw tp <world> <player> |
vextolyworlds.spawn |
op |
/vw spawn |
vextolyworlds.setspawn |
op |
/vw setspawn |
vextolyworlds.flag |
op |
/vw flag |
vextolyworlds.difficulty |
op |
/vw difficulty |
vextolyworlds.gamerule |
op |
/vw gamerule |
vextolyworlds.reload |
op |
/vw reload |
vextolyworlds.bypass.teleport |
op |
跳过传送前摇和冷却时间 |
vextolyworlds.admin |
op |
以上所有权限 |
vextolyworlds.* |
op |
所有权限 |
每个子命令都会检查权限 — 甚至 /vw help 和标签页补全仅显示玩家实际有权使用的命令。
如果没有明确授予权限,任何操作都无法执行,因此玩家只能通过
你的权限设置获得访问权(例如 luckperms:为玩家组分配
vextolyworlds.tp、vextolyworlds.spawn、vextolyworlds.list 和
vextolyworlds.help 以开放基本的世界旅行功能)。
世界类型
| 类型 |
别名 |
获得内容 |
normal |
overworld, default |
原版地形:生物群系、洞穴、结构 |
flat |
superflat |
平坦草地,非常适合建造 |
amplified |
|
极端山脉 |
void |
empty |
空世界,可选黑曜石出生平台 |
nether |
the_nether, hell |
下界维度 |
end |
the_end |
末地维度 |
generator:<plugin>:<name> |
|
其他插件提供的任意区块生成器 |
通过 API 注册的外部类型会自动显示在此处。
按世界设置的标志(Flags)
标志会实时生效并存储在 worlds.yml 中。省略值可切换状态。
| 标志 |
false 时的效果 |
pvp |
玩家无法互相伤害(包括箭矢) |
fire-spread |
火焰不蔓延且不燃烧方块 |
mob-griefing |
生物无法改变方块(末影人、僵尸开门、绵羊吃草等) |
explosions |
爆炸不会破坏世界 |
leaf-decay |
树叶永不消失 |
mob-spawning |
生物不生成(由其他插件触发的生成仍有效) |
hunger |
玩家永远不会失去饥饿值 |
weather |
天气永不变化 |
autoload |
服务器启动时加载(或不加载)该世界 |
插件可以通过 API 添加自定义标志——详见下方的 Custom flags。
未管理的世界(如主 world)使用 config.yml 中的默认设置。
配置文件
所有文件位于 plugins/VextolyWorlds/ 目录下。
config.yml
settings:
teleport:
warmup-seconds: 3 # 传送完成前需静止站立的时间(0 = 关闭)
cooldown-seconds: 5 # 两次传送之间的等待时间(0 = 关闭)
cancel-on-move: true # 移动会取消正在进行的预热倒计时
join:
teleport-to-spawn: false
flags:
defaults: # 新创建 + 未管理世界的默认值
pvp: true
fire-spread: true
mob-griefing: true
explosions: true
leaf-decay: true
void:
spawn-platform: true # 黑曜石平台,防止玩家掉落
messages.yml
插件发送的所有消息,包含 & 颜色代码和 &#RRGGBB 十六进制颜色。
可自由编辑,然后运行 /vw reload。
worlds.yml
由插件写入。每个受管理的世界占一条记录,包含类型、种子、环境、难度、标志、出生点和自动加载设置。
你可以在服务器离线时编辑它,但通常你无需触碰它。
开发者 API
VextolyWorlds 提供了一套小型且稳定的 API,用于外部世界类型和世界生命周期事件。将其添加到你的项目中:
git clone https://github.com/vextoly/VextolyWorlds
cd VextolyWorlds && mvn install
<dependency>
<groupId>dev.vextoly</groupId>
<artifactId>vextolyworlds</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
记得在你的 plugin.yml 中添加 softdepend: [VextolyWorlds]。
注册自定义世界类型
public final class SkylandsType implements WorldType {
@Override
public String id() {
return "skylands";
}
@Override
public String displayName() {
return "Skylands";
}
@Override
public String description() {
return "Floating island paradise.";
}
@Override
public ChunkGenerator generator() {
return new SkylandsGenerator();
}
@Override
public Location spawnLocation(World world) {
return new Location(world, 0.5, 120, 0.5);
}
}
@Override
public void onEnable() {
if (VextolyWorldsAPI.isEnabled()) {
VextolyWorldsAPI.registerWorldType(new SkylandsType());
}
}
就是这样:执行 /vw create sky skylands 即可生效,/vw types 会列出它,并且它会像任何内置类型一样持久化保存到 worlds.yml 中。
事件
| 事件 |
触发时机 |
可取消 |
PreWorldCreateEvent |
世界创建之前 |
是 |
WorldCreatedEvent |
世界创建并注册之后 |
否 |
PreWorldDeleteEvent |
世界删除之前 |
是 |
WorldDeletedEvent |
世界删除之后 |
否 |
@EventHandler
public void onCreate(WorldCreatedEvent event) {
getLogger().info("World " + event.worldName() + " was created with type " + event.worldType().id());
}
自定义标志(API)
你的插件可以注册自己的世界标志。VextolyWorlds 会将它们存储在 worlds.yml 中,在 /vw flag <world> 命令中显示,支持自动补全,并允许管理员像切换任何内置标志一样切换它们——至于这些标志具体做什么,由你的插件自行决定。
import dev.vextoly.worlds.api.VextolyWorldsAPI;
import dev.vextoly.worlds.api.flag.SimpleWorldFlag;
import dev.vextoly.worlds.api.flag.WorldFlag;
public final class MyPlugin extends JavaPlugin implements Listener {
public static final WorldFlag DUELS = new SimpleWorldFlag("duels", true, "Allows players to duel.");
@Override
public void onEnable() {
if (VextolyWorldsAPI.isEnabled()) {
VextolyWorldsAPI.registerFlag(DUELS);
}
Bukkit.getPluginManager().registerEvents(this, this);
}
@EventHandler
public void onDamage(EntityDamageByEntityEvent event) {
if (event.getEntity() instanceof Player && event.getDamager() instanceof Player
&& !VextolyWorldsAPI.flag(event.getEntity().getWorld(), DUELS)) {
event.setCancelled(true);
}
}
}
这就是完整的集成方式。注册此标志后:
- 执行
/vw flag arena duels false 将在世界 arena 中关闭决斗功能
- 该值会在重启后通过
worlds.yml 持久保存
- 执行
/vw flag arena 将在内置标志旁边列出 duels=false
VextolyWorldsAPI.flag(world, DUELS) 是你在运行时进行查询的方式
Flag 键必须为小写。如果你的插件缺失,存储的值会被保留,并在它重新出现时再次显示。你也可以通过 VextolyWorldsAPI.worldManager().setFlag(...) 以编程方式设置 flag。
FAQ
如何添加服务器上已存在的世界?
将其文件夹放入服务器根目录(与 world/ 同级),然后执行 /vw import name。
VextolyWorlds 此后便会记住该世界。
我可以将其与 Multiverse 一起使用吗?
可以,但不建议同时用两者管理相同的世界。请二选一。
如何重置一个世界?
先执行 /vw delete name,然后使用相同的类型和种子执行 /vw create name ...。
世界文件在哪里?
取决于服务器本身存储它们的位置:在旧版本中位于服务器根目录,
而在 26.x+ 版本中位于 <level-name>/dimensions/minecraft/<world> 下(Mojang 将维度存储移动到了此处)。VextolyWorlds 会自动检测这两种布局——无论哪种方式,创建、导入和删除的操作都相同。无需特殊文件夹,也没有锁定的格式——卸载插件后,你的世界仍能正常工作。
传送预热是否适用于操作员(OP)?
拥有 vextolyworlds.bypass.teleport 权限的操作员可跳过预热和冷却时间。
移除世界的生成器插件后,世界加载失败。
世界条目仍保留在 worlds.yml 中;重新安装生成器插件,或将世界以 normal 类型加载即可。此操作绝不会触碰已有的区块。
版本支持
基于 Paper API 构建并验证,涵盖从 1.21.11 到 26.3 的 API 线,
包括基于日期的 25.x/26.x 版本。插件声明了 api-version: 1.21,该范围内所有构建均接受此设置,因此同一个 jar 包可在该范围内的所有版本上运行。插件已为你处理以下版本差异:snake_case 和带命名空间的 gamerule 名称,以及旧的和新两种维度存储布局。如果未来 Paper 的变更导致兼容性问题,将会发布兼容性更新。
许可证
Apache License 2.0 — Copyright 2026 vextoly.
请参阅 LICENSE。
VextolyWorlds
A simple but powerful multi-world plugin for Paper.
Create, import, teleport, manage and delete worlds with one easy command
and extend it with your own world types from any plugin.
Designed so that a first-time server owner can be productive in two minutes,
while still offering flags, gamerules, teleport warmups, custom generators and
a clean Java API when you need them.
Features
- Multi-world management — create, import, load, unload and delete worlds
- 7 built-in world types — normal, superflat, amplified, void, nether, end, plus any external generator
- Custom world types via API — other plugins register types that instantly work with
/vw create and /vw types
- Per-world flags — pvp, fire-spread, mob-griefing, explosions, leaf-decay, autoload
- Per-world difficulty and gamerules — set them from chat, no vanilla command juggling
- Teleports with warmup, cooldown and move-cancel — safe cross-dimension teleporting
- Everything in plain YAML —
config.yml, messages.yml (fully translatable) and worlds.yml
- Safe deletes —
/vw delete requires a second confirmation before erasing anything
- Full tab completion and a color-coded
/vw help menu
- Fine grained permissions with sensible defaults
- No database, no extra dependencies, no worlds locked into a plugin format
Requirements
- Server: Paper (or a Paper fork) 1.21.11 – 26.3, including the 25.x/26.x releases
- Java 21 or newer
The plugin targets api-version: 1.21, which every newer Paper build accepts,
so one jar covers the whole version range.
Installation
- Download jar.
- Drop
VextolyWorlds-1.0.0.jar into your server's plugins/ folder.
- Start the server.
plugins/VextolyWorlds/ is created with config.yml, messages.yml and worlds.yml.
- Run
/vw help in game.
Quick start (60 seconds)
/vw create parkour flat → a flat world for building
/vw tp parkour → teleport to it
/vw setspawn → stand where players should arrive, then run this
/vw flag parkour pvp false → no fighting there
/vw flag parkour leaf-decay false
/vw spawn parkour → back to that world's spawn any time
Made a mistake? /vw delete parkour asks you to run it again within 30 seconds
before anything is actually deleted.
Commands
All commands work from in-game chat and the console. Aliases: /vw, /vworlds, /vextolyworlds.
| Command |
Description |
/vw help |
Show the command menu |
/vw create <name> [type] [seed] |
Create a world (/vw types lists all types) |
/vw import <name> [type] |
Add an existing world folder on the server |
/vw delete <name> |
Delete a world forever (asks for confirmation) |
/vw load <name> |
Load an unloaded managed world |
/vw unload <name> |
Unload a world (players inside are moved out safely) |
/vw list |
Show all managed and server worlds |
/vw types |
Show every registered world type, including API ones |
/vw info [world] |
Type, environment, seed, difficulty, spawn, flags, players |
/vw tp <world> [player] |
Teleport yourself (or another player) to a world |
/vw spawn [world] |
Teleport to a world's spawn |
/vw setspawn |
Set the spawn of your current world to where you stand |
/vw flag <world> <flag> [value] |
Show or set a flag — omit the value to toggle |
/vw difficulty <world> <value> |
peaceful, easy, normal or hard |
/vw gamerule <world> <rule> [value] |
Show or set any vanilla gamerule |
Examples:
/vw create survival normal 12345
/vw create creative flat
/vw create darkness void
/vw create mining generator:MyPlugin:cave
/vw flag creative pvp off
/vw gamerule survival keepInventory true
/vw tp mining Notch
Gamerule names work in every style: keepInventory, keep_inventory and
minecraft:keep_inventory are all accepted, so you can type them however
you remember them on any supported server version.
Permissions
| Permission |
Default |
Allows |
vextolyworlds.help |
op |
/vw help |
vextolyworlds.create |
op |
/vw create |
vextolyworlds.delete |
op |
/vw delete |
vextolyworlds.import |
op |
/vw import |
vextolyworlds.load |
op |
/vw load |
vextolyworlds.unload |
op |
/vw unload |
vextolyworlds.list |
op |
/vw list |
vextolyworlds.info |
op |
/vw info |
vextolyworlds.types |
op |
/vw types |
vextolyworlds.tp |
op |
/vw tp (self) |
vextolyworlds.tp.others |
op |
/vw tp <world> <player> |
vextolyworlds.spawn |
op |
/vw spawn |
vextolyworlds.setspawn |
op |
/vw setspawn |
vextolyworlds.flag |
op |
/vw flag |
vextolyworlds.difficulty |
op |
/vw difficulty |
vextolyworlds.gamerule |
op |
/vw gamerule |
vextolyworlds.reload |
op |
/vw reload |
vextolyworlds.bypass.teleport |
op |
Skip teleport warmup and cooldown |
vextolyworlds.admin |
op |
All of the above |
vextolyworlds.* |
op |
Everything |
Every single subcommand is permission-checked — even /vw help and
tab completion only show the commands a player is actually allowed to use.
Nothing works without an explicit grant, so players get access only through
your permission setup (e.g. luckperms: give a player group
vextolyworlds.tp, vextolyworlds.spawn, vextolyworlds.list and
vextolyworlds.help to open up basic world travel).
World types
| Type |
Aliases |
What you get |
normal |
overworld, default |
Vanilla terrain: biomes, caves, structures |
flat |
superflat |
Flat grass, great for building |
amplified |
|
Extreme mountains |
void |
empty |
Empty world with an optional obsidian spawn platform |
nether |
the_nether, hell |
The nether dimension |
end |
the_end |
The end dimension |
generator:<plugin>:<name> |
|
Any chunk generator another plugin provides |
External types registered through the API show up here automatically.
Per-world flags
Flags are enforced live and stored in worlds.yml. Omit the value to toggle.
| Flag |
Effect when false |
pvp |
Players cannot hurt each other (arrows included) |
fire-spread |
Fire does not spread or burn blocks |
mob-griefing |
Mobs cannot change blocks (endermen, zombie doors, sheep eating grass...) |
explosions |
Explosions do not damage the world |
leaf-decay |
Leaves never disappear |
mob-spawning |
Mobs do not spawn (spawns triggered by other plugins still work) |
hunger |
Players never lose hunger |
weather |
Weather never changes |
autoload |
World is (not) loaded on server start |
Plugins can add their own flags through the API — see
Custom flags below.
Unmanaged worlds (like your main world) use the defaults from config.yml.
Configuration files
All files live in plugins/VextolyWorlds/.
config.yml
settings:
teleport:
warmup-seconds: 3 # stand still before a teleport finishes (0 = off)
cooldown-seconds: 5 # wait between teleports (0 = off)
cancel-on-move: true # moving cancels a running warmup
join:
teleport-to-spawn: false
flags:
defaults: # defaults for new + unmanaged worlds
pvp: true
fire-spread: true
mob-griefing: true
explosions: true
leaf-decay: true
void:
spawn-platform: true # obsidian platform so players don't fall
messages.yml
Every message the plugin sends, with & color codes and &#RRGGBB hex colors.
Edit freely and run /vw reload.
worlds.yml
Written by the plugin. One entry per managed world with type, seed,
environment, difficulty, flags, spawn point and autoload setting.
You can edit it while the server is offline, but normally you never touch it.
API for developers
VextolyWorlds ships a small, stable API for external world types and world
lifecycle events. Add it to your project:
git clone https://github.com/vextoly/VextolyWorlds
cd VextolyWorlds && mvn install
<dependency>
<groupId>dev.vextoly</groupId>
<artifactId>vextolyworlds</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
Remember softdepend: [VextolyWorlds] in your plugin.yml.
Register a custom world type
public final class SkylandsType implements WorldType {
@Override
public String id() {
return "skylands";
}
@Override
public String displayName() {
return "Skylands";
}
@Override
public String description() {
return "Floating island paradise.";
}
@Override
public ChunkGenerator generator() {
return new SkylandsGenerator();
}
@Override
public Location spawnLocation(World world) {
return new Location(world, 0.5, 120, 0.5);
}
}
@Override
public void onEnable() {
if (VextolyWorldsAPI.isEnabled()) {
VextolyWorldsAPI.registerWorldType(new SkylandsType());
}
}
That's it: /vw create sky skylands works, /vw types lists it, and it
persists in worlds.yml like any built-in type.
Events
| Event |
When |
Cancellable |
PreWorldCreateEvent |
before a world is created |
yes |
WorldCreatedEvent |
after a world was created and registered |
no |
PreWorldDeleteEvent |
before a world is deleted |
yes |
WorldDeletedEvent |
after a world was deleted |
no |
@EventHandler
public void onCreate(WorldCreatedEvent event) {
getLogger().info("World " + event.worldName() + " was created with type " + event.worldType().id());
}
Custom flags (API)
Your plugin can register its own world flags. VextolyWorlds stores them in
worlds.yml, shows them in /vw flag <world>, tab-completes them, and lets
admins toggle them like any built-in flag — your plugin just decides what
they do.
import dev.vextoly.worlds.api.VextolyWorldsAPI;
import dev.vextoly.worlds.api.flag.SimpleWorldFlag;
import dev.vextoly.worlds.api.flag.WorldFlag;
public final class MyPlugin extends JavaPlugin implements Listener {
public static final WorldFlag DUELS = new SimpleWorldFlag("duels", true, "Allows players to duel.");
@Override
public void onEnable() {
if (VextolyWorldsAPI.isEnabled()) {
VextolyWorldsAPI.registerFlag(DUELS);
}
Bukkit.getPluginManager().registerEvents(this, this);
}
@EventHandler
public void onDamage(EntityDamageByEntityEvent event) {
if (event.getEntity() instanceof Player && event.getDamager() instanceof Player
&& !VextolyWorldsAPI.flag(event.getEntity().getWorld(), DUELS)) {
event.setCancelled(true);
}
}
}
That's the whole integration. With this registered:
/vw flag arena duels false turns duels off in the world arena
- the value persists across restarts in
worlds.yml
/vw flag arena lists duels=false next to the built-in flags
VextolyWorldsAPI.flag(world, DUELS) is your query at runtime
Flag keys must be lowercase. If your plugin is absent, stored values are
kept and simply show up again when it returns. You can also set flags
programmatically with VextolyWorldsAPI.worldManager().setFlag(...).
FAQ
How do I add a world that already exists on the server?
Put its folder in the server root (next to world/), then /vw import name.
VextolyWorlds remembers it from then on.
Can I use it together with Multiverse?
You can, but you shouldn't manage the same worlds with both. Pick one.
How do I reset a world?
/vw delete name then /vw create name ... with the same type and seed.
Where are the world files?
Wherever the server itself keeps them: in the server root on older versions,
and under <level-name>/dimensions/minecraft/<world> on 26.x+ (Mojang moved
dimension storage there). VextolyWorlds detects both layouts automatically —
creating, importing and deleting works the same either way. No special
folders, no locked-in format — delete the plugin and your worlds keep working.
Do teleport warmups apply to operators?
Operators with vextolyworlds.bypass.teleport skip warmup and cooldown.
A world failed to load after I removed its generator plugin.
The world entry stays in worlds.yml; reinstall the generator plugin or load
the world as normal. Existing chunks are never touched by that.
Version support
Built and verified against the Paper API line used by 1.21.11 through 26.3,
including the date-based 25.x/26.x versions. The plugin uses
api-version: 1.21, which all of those builds accept, so the same jar runs
everywhere in that range. Version differences the plugin already handles for
you: snake_case and namespaced gamerule names, and both the old and the new
dimension storage layout. If a future Paper change ever breaks something, a
compatibility release will follow.
License
Apache License 2.0 — Copyright 2026 vextoly.
See LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧