VextolyWorlds

插件

· 作者 vextoly

一款简单而强大的 Paper 多世界插件。通过一条简单的命令创建、导入、传送、管理和删除世界,并可通过任意插件扩展自定义的世界类型。

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

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 文件即可覆盖整个版本范围。

安装方法

  1. 下载 jar 文件。
  2. 将 VextolyWorlds-1.0.0.jar 放入服务器的 plugins/ 文件夹中。
  3. 启动服务器。系统将在 plugins/VextolyWorlds/ 目录下生成 config.yml、messages.yml 和 worlds.yml。
  4. 在游戏中运行 /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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源