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 或更高版本)。
- 设置:
- 从 Releases 下载最新的
spycore-1.1.1.jar。 - 将
.jar文件放入服务器的plugins/目录中。 - 重启服务器。服务器根目录中现有的世界将被自动检测并注册。
- 从 Releases 下载最新的
快速命令指南
所有命令均在 /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) 进行许可。
SpyCore
SpyCore is a multi-world management plugin for Paper and Purpur (1.21+).
Traditional multi-world plugins dump every single world folder directly into your server root, which gets messy quickly on larger servers or minigame networks. SpyCore organizes worlds into categorized subfolders (called containers) using a virtual file system (VFS), while still letting you reference them with clean, simple world names in commands and APIs.
It also comes with built-in world hibernation to save RAM, fast template cloning for minigame arenas, per-world rule toggles (PVP, hunger, flight, autoheal), and target selector support (@a, @p, @s, @r, @e).
Features
- Folder-based World Organization (VFS): Keep your worlds organized. Group minigames, arenas, or seasonal worlds into subdirectories like
spycore-worlds/Bedwars/Solo1while players and scripts simply refer toSolo1. - World Hibernation: Inactive worlds with zero players can automatically unload from memory to conserve RAM and CPU. Hubs and main survival worlds can be whitelisted to stay permanently loaded.
- Fast Arena & Minigame Templating: Clone template worlds on the fly with lazy chunk generators that skip Bukkit's slow spawn chunk loading. Ideal for disposable match worlds.
- Per-World Rule Control: Configure PVP, hunger depletion, natural regeneration, survival flight, time/weather cycles, and bed respawn behavior independently per world without needing extra rule plugins.
- Target Selector Support: Teleport commands natively accept standard Minecraft selectors (
/spy world tp @a Arena1,/spy tp @p lobby, etc.). - Chat & Tablist Isolation: Optionally isolate local chat, death messages, advancements, and tablist visibility to the world a player is currently in.
- PlaceholderAPI Hook: Includes placeholders like
%spycore_world_alias%and%spycore_world_name%. - Ecosystem Integration: Pairs directly with SpyInventories for per-world inventory grouping and SpyNetherPortals for custom portal links.
Requirements & Setup
- Server: Paper or Purpur 1.21+ (Java 21 or newer required).
- Setup:
- Download the latest
spycore-1.1.1.jarfrom Releases. - Put the
.jarinto your server'splugins/directory. - Restart your server. Existing worlds in the server root will be detected and registered automatically.
- Download the latest
Quick Command Guide
All commands run under the /spy base command (requires spy.admin or specific sub-permissions).
Creating & Managing Worlds
# Create a standard survival world in the server root
/spy create world survival normal
# Create a void world inside a "Bedwars" container folder
/spy container Bedwars create world Arena1 normal --generator voidgen
# Clone an arena template into a match instance
/spy clone Arena1 Matches Match_01 voidgen
# Load an existing world from disk / unload an inactive world
/spy load survival
/spy unload Arena1
# Permanently delete a world folder from disk
/spy delete Match_01
Teleportation & Player Movement
# Teleport yourself to a world
/spy world tp survival
# Teleport another player or a target selector
/spy world tp Steve survival
/spy world tp @a Arena1
# Set the world spawn to your current coordinates
/spy world setspawn
World Rules & Hibernation
# Disable PVP and hunger in a lobby or arena
/spy world modify lobby set pvp false
/spy world modify lobby set hunger false
# Allow survival flight in a creative world
/spy world modify creative set fly true
# Prevent lobby from being unloaded by the hibernation task
/spy whitelist add lobby
For the full list of subcommands, permission nodes, generator flags, and storage file schemas, check out DOCUMENTATION.md.
Developer API
If you are developing plugins on top of SpyCore, add the dependency to your pom.xml:
<dependency>
<groupId>com.spygamingog</groupId>
<artifactId>spycore</artifactId>
<version>1.1.1</version>
<scope>provided</scope>
</dependency>
Make sure to add depend: [SpyCore] (or softdepend: [SpyCore]) in your plugin.yml.
Example Usage
import com.spygamingog.spycore.api.SpyAPI;
import org.bukkit.World;
import org.bukkit.entity.Player;
// Fetch or wake a world by alias
World world = SpyAPI.getWorld("Arena1", true);
// Create a new void world inside a container
World arena = SpyAPI.createWorld("Bedwars", "Arena_02", World.Environment.NORMAL, "voidgen");
// Safely teleport a player
SpyAPI.teleportToSafeLocation(player, world);
// Attach custom metadata tags to a world
SpyAPI.setWorldTag(arena, "game_state", "WAITING");
String state = SpyAPI.getWorldTag(arena, "game_state");
Related Plugins
- SpyInventories: Multi-world inventory and player state separation (inventories, ender chests, health, gamemodes).
- SpyNetherPortals: Custom Nether & End portal routing for container worlds and custom dimensions.
License
This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyCore
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.1.2] - 2026-09-06
变更与精简
- 模块化库存分离:从
PlayerManager和PlayerProfile中移除了重复的玩家库存序列化、加载以及<group>.yml生成操作。SpyCore现在严格管理世界 VFS 生命周期、游戏规则以及导航配置(profile.yml中的last_locations)。 - 权威伙伴委托:专用的多世界库存管理和维度间库存同步现已清晰委派给
SpyInventories处理(若未安装 SpyInventories,则使用标准的原版单库存行为)。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
评论 0
登录后参与评分
还没有评论,来抢沙发吧