SpyCore

插件

· 作者 SpyGamingOG

以前所未有的方式组织你的世界。无需重启服务器,即可实时创建、克隆和管理世界。

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

需要前置:SpyInventories、SpyNetherPortals

最新 1.1.2 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

SpyCore

SpyCore 是一款适用于 Paper 和 Purpur (1.21+) 的多世界管理插件。

传统的多世界插件会将所有世界文件夹直接转储到服务器根目录中,这在大型服务器或小游戏网络中很快就会变得杂乱无章。SpyCore 使用虚拟文件系统(VFS)将世界组织到分类的子文件夹(称为 容器)中,同时允许你在命令和 API 中使用简洁、简单的世界名称来引用它们。

它还内置了世界休眠功能以节省内存、用于小游戏竞技场的快速模板克隆、每个世界的规则开关(PVP、饥饿、飞行、自动治疗),以及目标选择器支持(@a、@p、@s、@r、@e)。


功能

  • 基于文件夹的世界组织(VFS):保持世界井然有序。将小游戏、竞技场或季节性世界分组到子目录中,例如 spycore-worlds/Bedwars/Solo1,而玩家和脚本只需引用 Solo1。
  • 世界休眠:零玩家的闲置世界可以自动从内存中卸载,以节省 RAM 和 CPU 资源。主生存世界等枢纽世界可以加入白名单以保持永久加载。
  • 快速竞技场与小游戏模板化:通过惰性区块生成器即时克隆模板世界,跳过 Bukkit 缓慢的出生点区块加载。非常适合一次性比赛世界。
  • 按世界规则控制:独立配置每个世界的 PVP、饥饿消耗、自然再生、生存模式飞行、时间/天气循环和床铺重生行为,无需额外的规则插件。
  • 目标选择器支持:传送命令原生支持标准的 Minecraft 选择器(/spy world tp @a Arena1、/spy tp @p lobby 等)。
  • 聊天与标签页隔离:可选择将本地聊天、死亡消息、进度和标签页可见性隔离到玩家当前所在的世界。
  • PlaceholderAPI 钩子:包含如 %spycore_world_alias% 和 %spycore_world_name% 等占位符。
  • 生态系统集成:与 SpyInventories 直接配合使用,实现按世界分组的物品栏;与 SpyNetherPortals 配合使用,实现自定义传送门链接。

要求与设置

  • 服务器:Paper 或 Purpur 1.21+(需要 Java 21 或更高版本)。
  • 设置:
    1. 从 Releases 下载最新的 spycore-1.1.1.jar。
    2. 将 .jar 文件放入服务器的 plugins/ 目录中。
    3. 重启服务器。服务器根目录中现有的世界将被自动检测并注册。

快速命令指南

所有命令均在 /spy 基础命令下运行(需要 spy.admin 权限或特定的子权限)。

创建与管理世界

# 在服务器根目录创建一个标准生存世界
/spy create world survival normal

# 在 "Bedwars" 容器文件夹内创建一个虚空世界
/spy container Bedwars create world Arena1 normal --generator voidgen

# 将竞技场模板克隆为比赛实例
/spy clone Arena1 Matches Match_01 voidgen

# 从磁盘加载现有世界 / 卸载不活跃的世界
/spy load survival
/spy unload Arena1

# 从磁盘中永久删除一个世界文件夹
/spy delete Match_01

传送与玩家移动

# 传送到某个世界
/spy world tp survival

# 传送另一名玩家或目标选择器
/spy world tp Steve survival
/spy world tp @a Arena1

# 将世界出生点设置为你的当前位置坐标
/spy world setspawn

世界规则与休眠

# 禁用大厅或竞技场的 PVP 和饥饿
/spy world modify lobby set pvp false
/spy world modify lobby set hunger false

# 在创造世界中允许生存模式飞行
/spy world modify creative set fly true

# 防止大厅被休眠任务卸载
/spy whitelist add lobby

有关完整的子命令列表、权限节点、生成器标志和存储文件模式的详细信息,请查看 DOCUMENTATION.md。


开发者 API

如果你正在基于 SpyCore 开发插件,请将依赖项添加到你的 pom.xml 中:

<dependency>
    <groupId>com.spygamingog</groupId>
    <artifactId>spycore</artifactId>
    <version>1.1.1</version>
    <scope>provided</scope>
</dependency>

确保在你的 plugin.yml 中添加 depend: [SpyCore](或 softdepend: [SpyCore])。

示例用法

import com.spygamingog.spycore.api.SpyAPI;
import org.bukkit.World;
import org.bukkit.entity.Player;

// 通过别名获取或唤醒世界
World world = SpyAPI.getWorld("Arena1", true);

// 在容器中创建一个新的虚空世界
World arena = SpyAPI.createWorld("Bedwars", "Arena_02", World.Environment.NORMAL, "voidgen");

// 安全地传送玩家
SpyAPI.teleportToSafeLocation(player, world);

// 为世界附加自定义元数据标签
SpyAPI.setWorldTag(arena, "game_state", "WAITING");
String state = SpyAPI.getWorldTag(arena, "game_state");

相关插件

  • SpyInventories:多世界物品栏和玩家状态分离(物品栏、末影箱、生命值、游戏模式)。
  • SpyNetherPortals:为容器世界和自定义维度提供自定义下界与末地传送门路由。

许可

本项目根据 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可证 (CC BY-NC-SA 4.0) 进行许可。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源