UltimateVirtualSpawner
适用于 Minecraft 服务器的虚拟刷怪笼。受管理的刷怪笼不会生成任何真实生物——每个周期它都会掷骰掉落表并将结果直接存入其自身的虚拟存储中,因此一个拥有 100,000 组的刷怪笼农场在实体方面对服务器毫无开销。
支持的服务器
| 软件 |
Minecraft 版本范围 |
| Paper / Spigot / Bukkit |
1.21.10 – 26.2 |
| Folia |
1.21.11 – 26.2 |
兼容性逃生机制位于 config.yml 下的 COMPATIBILITY 部分:
STRICT: false — 如果无法解析版本号字符串,则发出警告并允许通过,而不是阻止启动。
ENABLED: false — 完全跳过检查门控并在任何服务器上启动。不受支持,无保证。
功能
- 可堆叠的刷怪笼 — 单个方块内最多可放置
MAX_STACK_PER_BLOCK 个,潜行放置和潜行破坏以移动整组,使用 /spawner split 分解一组。
- 虚拟存储 — 每个刷怪笼都有一个真实且可点击的容器 GUI。左键/右键/Shift 点击均遵循原版行为,此外 Shift+右键可切换物品的过滤状态。
- 掉落过滤器 — 针对每个刷怪笼、每个掉落的开关,并提供启用全部/禁用全部的快捷方式。
- 经验值生成 — 刷怪笼与物品一同积累经验值,可从主菜单领取。
- 内置经济系统 — 余额存储在该插件自己的数据库中,提供
/balance、/baltop、/pay 和 /eco 命令。无需安装经济类插件;可选择发布到 Vault 以便其他插件共享同一货币。
- 出售功能 — 将存储的战利品出售换取金钱,出售界面会显示 payout(收益),并支持基于权限的出售倍率。
- 漏斗提取 — 可选地将从刷怪笼下方抽取存储战利品至漏斗中。
- 反透视 (Anti-ESP) — 超出玩家揭示半径(或被方块遮挡)的刷怪笼会以伪装方块的形式发送,使得 X-ray 客户端无法绘制其他玩家的农场地图。
- 管理面板 — 浏览世界中每一个受管理的刷怪笼并传送至其位置。
- 原生支持 Folia — 所有世界访问均通过区域调度器进行;不依赖主线程假设。
截图
命令
所有命令均以 /spawner 开头(别名 /spawners、/uvs、/virtualspawner)。
| 命令 |
描述 |
/spawner |
打开管理面板 |
/spawner info |
检查你正注视的刷怪笼 |
/spawner panel |
打开管理面板 |
/spawner give <player> <type> [amount] |
给予一个刷怪笼物品 |
/spawner split <amount> |
分解手中持有的刷怪笼物品 |
/spawner types |
列出已配置的刷怪笼类型 |
/spawner remove |
移除你正注视的刷怪笼 |
/spawner reload |
重新加载所有配置文件 |
/spawner version |
显示版本及兼容性信息 |
经济系统
当 ECONOMY.PROVIDER 设置为 INTERNAL(或在没有外部经济的情况下为 AUTO)时生效。若由外部经济系统接管,这些命令将委托给拥有货币权的插件处理。
| 命令 |
描述 |
/balance [player] (/bal, /money) |
显示余额 |
/baltop [size] (/balancetop) |
最富有的玩家列表 |
/pay <player> <amount> |
向其他玩家转账 |
/eco give|take|set <player> <amount> |
调整余额 |
/eco reset <player> |
重置为初始余额 |
金额接受 K/M/B/T 后缀:例如 /eco give Steve 1.5M。
权限
| 节点 |
默认值 |
描述 |
ultimatevirtualspawner.command.spawner |
everyone |
使用 /spawner 命令 |
ultimatevirtualspawner.admin.spawner |
op |
完全访问所有受管理的刷怪笼 |
ultimatevirtualspawner.admin.spawner.seeall |
op |
绕过反透视隐藏 |
ultimatevirtualspawner.spawner.bypass |
op |
无需精准采集即可破坏刷怪笼 |
ultimatevirtualspawner.sell.multiplier.* |
— |
出售倍率,在 spawners.yml 中配置 |
ultimatevirtualspawner.command.balance |
everyone |
查看自己的余额 |
ultimatevirtualspawner.command.balance.others |
op |
查看他人的余额 |
ultimatevirtualspawner.command.baltop |
everyone |
查看最富有的玩家 |
ultimatevirtualspawner.command.pay |
everyone |
转账金钱 |
ultimatevirtualspawner.command.eco |
op |
给予/扣除/设置/重置余额 |
配置
| 文件 |
内容 |
config.yml |
兼容性开关、数据库、货币格式化 |
spawners.yml |
刷怪笼行为、反 ESP、售价、按类型划分的掉落表 |
menus.yml |
所有 GUI 布局:尺寸、槽位、材质、标题、描述 |
messages.yml |
所有聊天消息 |
sounds.yml |
每种刷怪笼操作对应的音效 |
缺失的键会在每次加载时从内置默认值中回填,因此更新插件不会覆盖自定义值。
经济系统
金钱由插件自身处理。config.yml 中的 ECONOMY.PROVIDER 用于选择后端:
| 模式 |
行为 |
INTERNAL(默认) |
余额存储在该插件的数据库中。无需安装其他内容。 |
VAULT |
通过 Vault 委托给外部经济插件(如 EssentialsX、CMI 等)。 |
AUTO |
当注册了经济提供者时使用 Vault,否则回退到内部经济。 |
更改模式需要完全重启服务器,仅使用 /spawner reload 无效。
在 REGISTER_WITH_VAULT: true(默认值)且已安装 Vault 的情况下,内置经济会作为 Vault 提供者发布——这样商店、任务和其他类似插件可以读取和写入这些相同的余额,避免服务器出现两个互不相连的资金池。Vault 不是必需的;如果没有它,经济系统将仅保留在此插件内部。
每次余额变动时,数值会根据 DECIMAL_PLACES 进行四舍五入,以防止重复运算导致小数位漂移至分以下;同时每个玩家的余额都在各自的锁下进行操作,确保并发出售不会因交错执行而导致数据丢失。
依赖项
均为可选:
- Vault — 仅在需要与其他插件共享经济,或通过
PROVIDER: VAULT 使用外部经济时才需要。即使没有它,出售功能也能正常工作。
- PlaceholderAPI — 注册
uvs 扩展。
JDBC 驱动(SQLite、MySQL)在 plugin.yml 中被声明为 libraries,并在服务器首次启动时自动下载,从而保持插件 jar 包体积小巧。
占位符
需要 PlaceholderAPI。
| 占位符 |
值 |
%uvs_total% |
全服管理的刷怪笼总数 |
%uvs_types% |
配置的刷怪笼类型数量 |
%uvs_balance% |
玩家余额,原始数值 |
%uvs_balance_formatted% |
带货币符号的余额 |
%uvs_balance_short% |
简化版余额(如 $1.5K) |
%uvs_owned% |
玩家拥有的刷怪笼数量 |
%uvs_owned_stack% |
其刷怪笼中堆叠物品的总量 |
%uvs_owned_stored% |
其刷怪笼中存储的物品总量 |
%uvs_owned_xp% |
其刷怪笼中存储的经验总值 |
%uvs_world% |
玩家所在世界中管理的刷怪笼数量 |
%uvs_looking_type% 等 |
玩家面前刷怪笼的 type、owner、stack、stored、xp、access 信息 |
命令与权限有哪些?
请查阅官方文档以获取完整的命令和权限列表。
如果需要支持怎么办?
如果你需要任何帮助,可以加入我们的 Discord 服务器,我们将为你提供协助 :)
如果发现 bug 怎么办?
如果你发现任何错误,可以在 GitHub Issues 上报告它们。
捐赠
我们提供了 PayPal 和 SocialBuzz 捐赠链接,以持续支持本项目 :)
UltimateVirtualSpawner
Virtual mob spawners for Minecraft servers. A managed spawner never spawns a real mob — every
cycle it rolls its drop table and deposits the result straight into its own virtual storage, so a
100,000-stack spawner farm costs the server nothing in entities.
Supported servers
| Software |
Minecraft range |
| Paper / Spigot / Bukkit |
1.21.10 – 26.2 |
| Folia |
1.21.11 – 26.2 |
Escape hatches live in config.yml under COMPATIBILITY:
STRICT: false — a version string that cannot be parsed is allowed through with a warning
instead of blocking start-up.
ENABLED: false — skip the gate entirely and start on any server. Unsupported, no guarantees.
Features
- Stackable spawners — up to
MAX_STACK_PER_BLOCK in a single block, sneak-place and
sneak-break to move whole stacks, /spawner split to break a stack apart.
- Virtual storage — a real, clickable container GUI per spawner. Left/right/shift click all
behave like vanilla, plus shift-right to toggle a material's filter.
- Drop filters — per-spawner, per-drop toggles with enable-all / disable-all shortcuts.
- XP generation — spawners accumulate XP alongside items, claimed from the main menu.
- Built-in economy — balances stored in this plugin's own database, with
/balance, /baltop,
/pay and /eco. No economy plugin required; optionally published to Vault so other plugins
share the same money.
- Selling — sell stored loot for money, with a confirmation screen showing the payout, and
per-permission sell multipliers.
- Hopper extraction — optionally pull stored loot into a hopper under the spawner.
- Anti-ESP — spawners outside a player's reveal radius (or behind blocks) are sent as
camouflage blocks, so X-ray clients cannot map other players' farms.
- Admin panel — browse every managed spawner per world and teleport to it.
- Folia-native — all world access goes through the region scheduler; no main-thread assumptions.
Screenshots
Commands
All under /spawner (aliases /spawners, /uvs, /virtualspawner).
| Command |
Description |
/spawner |
Open the admin panel |
/spawner info |
Inspect the spawner you are looking at |
/spawner panel |
Open the admin panel |
/spawner give <player> <type> [amount] |
Give a spawner item |
/spawner split <amount> |
Split the held spawner item |
/spawner types |
List the configured spawner types |
/spawner remove |
Remove the spawner you are looking at |
/spawner reload |
Reload every config file |
/spawner version |
Show version and compatibility info |
Economy
Active while ECONOMY.PROVIDER is INTERNAL (or AUTO with no external economy). With an
external economy in charge, these defer to the plugin that owns money.
| Command |
Description |
/balance [player] (/bal, /money) |
Show a balance |
/baltop [size] (/balancetop) |
Richest players |
/pay <player> <amount> |
Send money to another player |
/eco give|take|set <player> <amount> |
Adjust a balance |
/eco reset <player> |
Reset to the starting balance |
Amounts accept K/M/B/T suffixes: /eco give Steve 1.5M.
Permissions
| Node |
Default |
Description |
ultimatevirtualspawner.command.spawner |
everyone |
Use /spawner |
ultimatevirtualspawner.admin.spawner |
op |
Full access to every managed spawner |
ultimatevirtualspawner.admin.spawner.seeall |
op |
Bypass anti-ESP concealment |
ultimatevirtualspawner.spawner.bypass |
op |
Break spawners without Silk Touch |
ultimatevirtualspawner.sell.multiplier.* |
— |
Sell multipliers, configured in spawners.yml |
ultimatevirtualspawner.command.balance |
everyone |
Check your own balance |
ultimatevirtualspawner.command.balance.others |
op |
Check someone else's balance |
ultimatevirtualspawner.command.baltop |
everyone |
View the richest players |
ultimatevirtualspawner.command.pay |
everyone |
Send money |
ultimatevirtualspawner.command.eco |
op |
Give / take / set / reset balances |
Configuration
| File |
Contents |
config.yml |
Compatibility gate, database, currency formatting |
spawners.yml |
Spawner behaviour, anti-ESP, sell prices, drop tables per type |
menus.yml |
Every GUI layout: sizes, slots, materials, titles, lore |
messages.yml |
Every chat message |
sounds.yml |
Sound effect for each spawner action |
Missing keys are back-filled from the packaged defaults on every load, so updating the plugin
never wipes customised values.
Economy
Money is handled by the plugin itself. ECONOMY.PROVIDER in config.yml picks the backend:
| Mode |
Behaviour |
INTERNAL (default) |
Balances live in this plugin's database. Nothing else to install. |
VAULT |
Defer to an external economy plugin (EssentialsX, CMI, ...) through Vault. |
AUTO |
Use Vault when an economy provider is registered, otherwise fall back to internal. |
Changing the mode needs a full server restart, not /spawner reload.
With REGISTER_WITH_VAULT: true (the default) and Vault installed, the built-in economy is
published as a Vault provider — so shops, jobs and similar plugins read and write these same
balances instead of the server ending up with two disconnected pots of money. Vault is not
required; without it the economy simply stays internal to this plugin.
Balances are rounded to DECIMAL_PLACES on every change so repeated arithmetic cannot drift into
fractions of a cent, and each player's balance is mutated under its own lock so two concurrent
sells cannot interleave into a lost update.
Dependencies
Both optional:
- Vault — only needed to share the economy with other plugins, or to use an external economy
via
PROVIDER: VAULT. Selling works without it.
- PlaceholderAPI — registers the
uvs expansion.
JDBC drivers (SQLite, MySQL) are declared as libraries in plugin.yml and downloaded by the
server on first start, so the plugin jar stays small.
Placeholders
Requires PlaceholderAPI.
| Placeholder |
Value |
%uvs_total% |
Managed spawners server-wide |
%uvs_types% |
Configured spawner types |
%uvs_balance% |
The player's balance, raw number |
%uvs_balance_formatted% |
Balance with the currency symbol |
%uvs_balance_short% |
Balance, compact ($1.5K) |
%uvs_owned% |
Spawners owned by the player |
%uvs_owned_stack% |
Total stack size across their spawners |
%uvs_owned_stored% |
Total stored loot across their spawners |
%uvs_owned_xp% |
Total stored XP across their spawners |
%uvs_world% |
Managed spawners in the player's world |
%uvs_looking_type% etc. |
type, owner, stack, stored, xp, access of the spawner in front of them |
What are the Commands and Permissions?
Read the official documentation for a list of commands and permissions.
What if I need support?
If you need any support you can join our Discord server, so we can help you out :)
What if I find a bug?
if you find any bugs, you can report them on GitHub issues
Donation
We provide a PayPal and SocialBuzz donation link to keep supporting this project :)
评论 0
登录后参与评分
还没有评论,来抢沙发吧