SpyInventories
SpyInventories 是一款面向 Paper 和 Purpur(1.21+)的多世界库存管理与状态同步插件。作为 SpyCore 的配套扩展,它在不同的世界组之间隔离并管理玩家的物品栏、盔甲、副手物品、末影箱、生命值、饥饿值、药水效果及游戏模式。
功能特性
- 世界分组:将多个世界归为一组以共享库存数据。例如,
survival、survival_nether和survival_the_end可以共用一套库存,而creative或minigames则完全独立。 - 完整状态隔离:管理物品栏槽位、盔甲、副手物品、末影箱、生命值、饥饿等级、活跃的药水效果以及游戏模式。
- 首次进入新组时的清理:当玩家首次进入一个此前没有数据的新区时,其物品栏和药水效果会被彻底清空,以防止物品溢出或重复生成。
- 异步保存:玩家库存文件通过异步方式保存,从而防止玩家在切换世界或断开连接时导致主线程卡顿。
- 自动移交 SpyCore 控制权:当 SpyInventories 与 SpyCore 同时安装时,SpyCore 会自动将其内部的库存处理器移交给 SpyInventories,以避免双重加载或保存冲突。
要求与安装
- 环境要求:
- Paper 或 Purpur 1.21+
- Java 21+
- SpyCore 1.1.0 或更高版本
- 安装步骤:
- 将
spycore-1.1.0.jar和spyinventories-1.0.7.jar放入服务器的plugins/目录中。 - 重启服务器。
- 将
配置
世界组在 plugins/SpyInventories/config.yml 中进行配置。
同一组内列出的世界将共享相同的库存池。遵循标准命名规则(_nether 和 _the_end)的维度会自动处理:
groups:
survival:
worlds:
- survival
- survival_nether
- survival_the_end
creative:
worlds:
- creative
minigames:
worlds:
- bedwars
- skywars
玩家数据按玩家存储在 plugins/SpyInventories/players/<UUID>/<group>.yml 中。
相关插件
- SpyCore:多世界管理引擎及 VFS 容器系统。
- SpyNetherPortals:为多世界架构提供自定义的下界与末地传送门路由功能。
许可证
本项目依据 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 (CC BY-NC-SA 4.0) 进行授权。
SpyInventories
SpyInventories is a multi-world inventory management and state-sync plugin for Paper and Purpur (1.21+). Built as a companion extension for SpyCore, it isolates and manages player inventories, armor, offhand items, ender chests, health, food, potion effects, and gamemodes across different world groups.
Features
- World Grouping: Group worlds together so they share inventory data. For example,
survival,survival_nether, andsurvival_the_endcan share one inventory, whilecreativeorminigamesare kept completely separate. - Full State Separation: Manages inventory slots, armor, offhand, ender chest, health, food levels, active potion effects, and gamemodes.
- Clean First-Time Joins: When a player enters a new world group for the first time without prior data, their inventory and effects are cleanly cleared to prevent item bleeding or duplication.
- Asynchronous Saving: Player inventory files are saved asynchronously to prevent main-thread lag spikes when players switch worlds or disconnect.
- Automatic SpyCore Handoff: When SpyInventories is installed alongside SpyCore, SpyCore automatically hands off its internal inventory handler to SpyInventories to prevent double-loading or conflicting saves.
Requirements & Installation
- Requirements:
- Paper or Purpur 1.21+
- Java 21+
- SpyCore 1.1.0 or newer
- Installation:
- Put both
spycore-1.1.0.jarandspyinventories-1.0.7.jarinto your server'splugins/directory. - Restart the server.
- Put both
Configuration
World groups are configured in plugins/SpyInventories/config.yml.
Worlds listed in the same group share the same inventory pool. Dimensions following standard naming (_nether and _the_end) are handled automatically:
groups:
survival:
worlds:
- survival
- survival_nether
- survival_the_end
creative:
worlds:
- creative
minigames:
worlds:
- bedwars
- skywars
Player data is stored per-player in plugins/SpyInventories/players/<UUID>/<group>.yml.
Sibling Plugins
- SpyCore: Multi-world management engine and VFS container system.
- SpyNetherPortals: Custom Nether and End portal routing for multi-world setups.
License
This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpyInventories
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.0.9] - 2026-09-06
Added
- 无损旧版自动迁移:在加载玩家数据时,增加了自动检测并迁移旧版 SpyCore 库存文件(
plugins/SpyCore/players/<UUID>/<group>.yml)的功能。 - 别名感知的组解析:
GroupManager现在通过SpyAPI.getAliasForWorld(world)解析世界别名,以无缝支持容器世界的分组功能。 - 继承的基础维度分组:维度世界(
_nether、_the_end)现在会自动继承其基础世界在groups.yml中分配的任何自定义组。 - 药水效果键兼容:支持加载存储在
potion-effects和旧版potion_effects下的药水效果。
Changed
- 权威库存管理器:已提升为 SpyCore 生态系统中唯一的权威多世界库存管理器。
- 核心依赖:更新为 SpyCore 1.1.2。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧