VRandomItemBattle
适用于 Paper 和 Purpur 服务器的完整随机物品大乱斗小游戏插件。
玩家进入竞技场后,会投票选择地图,并按可配置的间隔接收随机物品。每次物品交付都可能改变战局:武器、方块、实用道具、附魔甚至可投掷的刷怪蛋应有尽有。最后存活的玩家或队伍获胜。
VRandomItemBattle 专为单服多游戏服务器以及完整的代理网络设计。它将引导式设置、自动世界还原、多地图竞技场、并行回合、持久化统计数据和深度可配置界面整合到一个独立的插件中。
一个通用 JAR: 以下列出的所有当前已发布的 Paper 1.21.x 和 26.x 版本均可运行同一个文件。
由 Veldran Studios 开发。
为什么选择 VRandomItemBattle?
- 快速设置: 交互式设置向导指导管理员完成每一项必要决策
- 每局不同: 加权掉落、稀有度配置、地图专属池和可选修饰符确保比赛充满不可预测性
- 为真实网络构建: 运行多个竞技场和并行回合,或在 Velocity/BungeeCord 后方分离大厅和游戏服务器
- 安全的竞技场重置: 每个基于模板的比赛都在新的地图副本中运行,不会破坏原始世界
- 高度可配置: 菜单、快捷栏物品、消息、告示牌、记分板、音效、标题、效果和游戏规则均可编辑
- 持久化统计数据: 使用本地文件存储或共享异步 MySQL,并拥有独立的可见性控制
- 无需依赖项: 安装 JAR,重启服务器即可开始设置
核心玩法
- 支持单人及团队战斗,可配置队伍规模并实现自动平衡
- 随机物品交付,支持配置间隔、禁用材料、稀有度权重、数量和附魔
- 可选的防重复保护和平等性规则
- 每张地图独立配置掉落池、图标、出生点、边界和玩家容量
- 可投掷的刷怪蛋,命中时生成对应的生物
- 拥有的生物、投射物、TNT、钓鱼拉力和延迟效果均保留正确的击杀归属
- 队友、拥有生物、爆炸和玩家建造的凋灵提供友军伤害保护
- 可配置坠落、虚空和环境淘汰的击杀归属判定
- 战斗开始前有五秒同步出生冻结期
- 可配置的中场休息和平局加时扩展
- 清理背包、控制天气、永久白天和隔离的竞技场难度
修饰符与突然死亡模式
可以单独启用可选的回合修饰符:
- 双倍物品 (Double Items)
- 快速物品 (Fast Items)
- 仅限快捷栏 (Hotbar Only)
- 禁止再生 (No Regeneration)
- 加速 (Speed)
- 发光 (Glowing)
- 爆炸投射物 (Explosive Projectiles)
突然死亡模式支持更快的掉落、幸存者发光、缩小的世界边界,以及可选的专用最终竞技场及其独立的出生列表。在最终阶段可以停止新物品交付,让每一次决策都至关重要。
多地图竞技场与投票
每个竞技场可以包含多个独立的战斗地图。玩家在回合开始前进行投票,而不可用或已满员的地图会被自动排除。
地图投票器保持紧凑布局:
- 1-9 张地图使用一行物品槽
- 10-18 张地图使用两行物品槽
- 19-27 张地图使用三行物品槽
- 超出数量时自动添加更多行
- 使用默认布局时,仅当存在超过 45 张地图时才开启分页导航
打开的投票菜单在每次投票后立即更新,并与正确的并行回合保持关联。取消“添加另一张地图”设置步骤会安全地恢复之前的选择,而不是让该地图变得不可用。
引导式设置工作室
运行 /setup 并仅回答当前问题。设置流程包括:
- 品牌化聊天面板、面包屑导航和可点击的操作
- 每个输入项都有清晰的验证和示例
- 分别的大厅、规则、地图、网络和可选系统部分
- 精确的世界坐标、地图角点、出生点、图标和物品池
- 十二个明确的可选系统决策点
- 在任何内容激活或重启之前的完整最终审查
change 操作允许在不重新启动整个设置的情况下修正各个部分
- 安全的支持重复、取消和恢复行为
现有安装将接收非破坏性的配置迁移。自定义值和竞技场数据将被保留,并在不兼容的配置更改之前创建备份。
统计与存储
VRandomItemBattle 可以追踪:
- 游戏场次
- 胜利次数
- 击杀与死亡数
- 造成伤害与受到的伤害
- 获得的物品数
- 断开连接次数
- 当前连胜记录与最佳连胜记录
每项统计数据均可独立配置:
- 是否收集
- 是否存储
- 是否在
/stats 中显示
- 是否可用于
/top
- 其显示名称、排序和格式化方式
可选择优化的本地 FILE 存储或共享的 MySQL 存储。数据库工作和批量写入均在异步线程中运行,因此正常游戏不会因统计数据持久化而被阻塞。
观察者、重连与私人游戏
- 可配置的重连宽限期,涵盖大厅、战斗和结束阶段
- 正确恢复背包、位置和玩家状态
- 带分页和实时玩家信息的观察者传送菜单
- 上下位玩家切换控制、飞行、隐身和隔离的观察者聊天
- 可配置的“再来一局”和“返回”物品
- 基于代码和邀请的私人比赛,支持房主设置
- 可配置的最佳三局/五局系列赛锦标赛模式
界面与展示
界面并非硬编码。管理员可以自定义:
- GUI 标题、大小、条目、槽位和分页控件
- 物品材质、名称、描述、发光、模型数据和标志
- 大厅快捷栏布局和每次点击的音效
- 游戏内标题、副标题、动作栏和聊天消息
- 大厅、战斗、中场休息、观察者和结束阶段的记分板
- 胜利烟花、粒子、音效和时机
- 加入告示牌的行内容、颜色、发光、蜡封状态和占位符
- 设置面板、提示、示例、进度指示器和答案标签
侧边栏使用差异更新来避免不必要的闪烁。重复的记分板、告示牌和统计操作在可能的情况下会被缓存或批量处理。
服务器与代理模式
VRandomItemBattle 支持两种部署方式:
MULTIGAME
在一个 Paper/Purpur 服务器上同时运行大厅和对战。多个竞技场和并行回合池可以同时运作。
PROXY NETWORK
在 Velocity 或兼容 BungeeCord 的消息中间件后端,使用专用大厅和游戏后端。插件支持:
- 引导式 LOBBY/GAME 角色设置
- 可配置的后端和大厅名称
- 后端竞技场分配与自动加入
- 关机或重启前可靠地转移玩家
- 按竞技场划分的服务器池
- 实时路由验证与管理控制
- 当代理转移无法完成时安全地踢出玩家
自动世界处理
- 为基于模板的回合异步复制全新的运行时世界
- 为并行会话提供专属的世界预留
- 恢复方块、容器、流体、活塞、爆炸效果及已生成的实体
- 正确清理门、床等多方块结构
- 静默准备地图,不向玩家显示技术性消息
- 原始模板世界保留供后续回合复用
快速开始
- 将
VRandomItemBattle.jar 放入服务器的 plugins/ 目录。
- 重启服务器。
- 以管理员身份运行
/setup。
- 选择
multigame 或 bungee 部署模式。
- 完成引导式的大厅、规则与地图步骤。
- 查看生成的设置摘要并输入
confirm。
- 玩家现在可以加入、投票选择地图并开始对战。
要创建物理接入点,在第一行放置包含 [rib] 的告示牌,第二行填写竞技场名称。该告示牌会自动更新,点击即可让玩家加入。
主要命令
/rib - 打开竞技场浏览器
/rib join <arena> - 加入某个竞技场
/rib leave - 离开当前竞技场
/rib vote [map] - 为对战地图投票
/stats [player] - 查看已配置的统计数据
/top [stat] [amount] - 查看已配置的排行榜
/private ... - 管理私人对战
/tournament ... - 管理锦标赛系列
/setup - 打开引导式设置工作室
/setup <arena> [map] - 编辑特定竞技场或地图
/rib map ... - 管理地图、图标与可用性
/rib loot ... - 管理地图专属的物品池
/rib template ... - 创建、测试和管理世界模板
/rib round ... - 检查或控制单个并行回合
/rib maintenance ... - 安全地关闭或重新开放地图
/rib network ... - 检查与配置代理路由
/rib storage - 检查 FILE/MySQL 存储状态
/rib reload - 重新加载配置与竞技场
设置与管理需要 vrandomitembattle.admin 权限,默认授予管理员。
兼容性
| 平台 |
支持情况 |
| Paper |
完全支持,已在运行时测试 |
| Purpur |
作为兼容 Paper 的分叉版本受支持 |
| Spigot |
不支持;缺少所需的 Paper API |
| Folia |
未宣称支持 |
支持的 Paper 版本
1.21
1.21.1
1.21.3 至 1.21.11
26.1.1
26.1.2
26.2
支持的 Purpur 版本
1.21
1.21.1
1.21.3 至 1.21.11
26.1.2
26.2
Paper 并未发布 Minecraft 1.21.2 或 26.1 的服务器构建。Purpur additionally 没有发布的 26.1.1 构建,因此该目标仅支持 Paper。
Java 要求
- Java 21 用于 Minecraft 1.21.x 服务器
- Java 25 用于 Minecraft 26.x 服务器
Paper 兼容性矩阵已在所有 14 个已发布目标上使用相同的通用发布 JAR 进行验证。Purpur 继承了所需的 Paper API,但未被纳入该独立的 14 服务器运行时矩阵中。
配置
配置文件被拆分为独立文件:
config.yml - 核心玩法与竞技场行为
network.yml - 部署与代理路由
messages.yml 与 language.yml - 面向玩家与设置的文本
scoreboard.yml - 阶段特定的侧边栏布局
interface.yml - 菜单、快捷栏物品、音效与视觉呈现
storage.yml - FILE/MySQL 存储与每项统计的行为
loot-profiles.yml - 加权物品档案与稀有度
modifiers.yml - 可选的回合修饰符
matches.yml - 私人对战、锦标赛与可选系统
在对战或界面更改后使用 /rib reload。更改存储后端连接后需重启服务器。
指标
VRandomItemBattle 使用匿名的 bStats 指标来帮助了解插件的使用情况。可以通过标准的 bStats 配置禁用指标。
VRandomItemBattle
A complete Random Item Battle minigame for Paper and Purpur servers.
Players enter an arena, vote for a map and receive random items at a configurable interval. Every delivery can change the fight: weapons, blocks, utilities, enchantments and even throwable spawn eggs are available. The final surviving player or team wins.
VRandomItemBattle is designed for both a single multigame server and full proxy networks. It combines guided setup, automatic world restoration, multi-map arenas, parallel rounds, persistent statistics and a deeply configurable interface in one standalone plugin.
One universal JAR: the same file runs on every currently published Paper 1.21.x and 26.x version listed below.
Developed by Veldran Studios.
Why VRandomItemBattle?
- Fast to set up: an interactive setup studio guides administrators through every required decision
- Different every round: weighted loot, rarity profiles, map-specific pools and optional modifiers keep matches unpredictable
- Built for real networks: run multiple arenas and parallel rounds or split lobby and game servers behind Velocity/BungeeCord
- Safe arena resets: each template-backed match runs in a fresh map copy without destroying the original world
- Highly configurable: menus, hotbar items, messages, signs, scoreboards, sounds, titles, effects and gameplay rules are editable
- Persistent statistics: use local file storage or shared asynchronous MySQL with independent visibility controls
- No required dependencies: install the JAR, restart and begin setup
Core gameplay
- Solo and team battles with configurable team sizes and automatic balancing
- Random item deliveries with configurable intervals, blocked materials, rarity weights, amounts and enchantments
- Optional duplicate protection and fairness rules
- Per-map loot profiles, icons, spawn positions, boundaries and player capacities
- Throwable spawn eggs that create their matching mob on impact
- Owned mobs, projectiles, TNT, fishing pulls and delayed effects retain correct kill attribution
- Friendly-fire protection for teammates, owned mobs, explosions and player-built Withers
- Configurable combat attribution for fall, void and environmental eliminations
- Five-second synchronized spawn freeze before combat begins
- Configurable halftime and tied-match extensions
- Clean inventories, controlled weather, permanent daytime and isolated arena difficulty
Modifiers and Sudden Death
Optional round modifiers can be enabled individually:
- Double Items
- Fast Items
- Hotbar Only
- No Regeneration
- Speed
- Glowing
- Explosive Projectiles
Sudden Death supports faster loot, survivor glowing, a shrinking world border and an optional dedicated final arena with its own spawn list. New item deliveries can stop during the final phase so every decision matters.
Multi-map arenas and voting
Each arena can contain multiple independent battle maps. Players vote before the round begins, while unavailable or full maps are excluded automatically.
The map voter stays compact:
- 1-9 maps use one inventory row
- 10-18 maps use two rows
- 19-27 maps use three rows
- Additional rows are added automatically
- With the default layout, page navigation begins only when more than 45 maps exist
Open voting menus update immediately after every vote and remain linked to the correct parallel round. Cancelling the Add another map setup step safely restores the previous selection instead of leaving that map unavailable.
Guided setup studio
Run /setup and answer only the current question. The setup flow includes:
- Branded chat panels, breadcrumbs and clickable actions
- Clear validation and examples for every input
- Separate lobby, rules, map, network and optional-system sections
- Exact world positions, map corners, spawns, icons and item pools
- Twelve explicit optional-system decisions
- A complete final review before anything is activated or restarted
change actions for correcting individual sections without restarting the complete setup
- Safe repeat, cancellation and recovery behavior
Existing installations receive non-destructive configuration migrations. Custom values and arena data are preserved, with backups created before incompatible configuration changes.
Statistics and storage
VRandomItemBattle can track:
- Games played
- Wins
- Kills and deaths
- Damage dealt and received
- Items received
- Disconnects
- Current and best win streaks
Every statistic can be configured independently:
- Whether it is collected
- Whether it is stored
- Whether it appears in
/stats
- Whether it can be used in
/top
- Its display name, order and formatting
Choose between optimized local FILE storage or shared MySQL storage. Database work and batched writes run asynchronously so normal gameplay is not blocked by statistics persistence.
Spectators, reconnects and private games
- Configurable reconnect grace periods for lobby, combat and ending phases
- Correct restoration of inventory, position and player state
- Spectator teleport menu with pagination and live player information
- Next/previous player controls, flight, invisibility and isolated spectator chat
- Configurable Play Again and Return items
- Code- and invite-based private matches with owner settings
- Configurable best-of tournament series
Interface and presentation
The interface is not hard-coded. Administrators can customize:
- GUI titles, sizes, entries, slots and page controls
- Item materials, names, lore, glow, model data and flags
- Lobby hotbar layout and every click sound
- Gameplay titles, subtitles, actionbars and chat messages
- Lobby, fight, halftime, spectator and ending scoreboards
- Winner fireworks, particles, sounds and timing
- Join-sign lines, colors, glow, wax state and placeholders
- Setup panels, prompts, examples, progress indicators and answer labels
The sidebar uses differential updates to avoid unnecessary flicker. Repeated scoreboard, sign and statistics work is cached or batched where possible.
Server and proxy modes
VRandomItemBattle supports two deployment styles:
MULTIGAME
Run lobby and matches on one Paper/Purpur server. Multiple arenas and parallel round pools can operate at the same time.
PROXY NETWORK
Use dedicated lobby and game backends behind Velocity or BungeeCord-compatible messaging. The plugin supports:
- Guided LOBBY/GAME role setup
- Configurable backend and lobby names
- Backend arena assignment and automatic joining
- Reliable player transfer before shutdown or restart
- Per-arena server pools
- Live routing validation and administrative controls
- Safe fallback kicks when a proxy transfer cannot finish
Automatic world handling
- Fresh asynchronously copied runtime worlds for template-backed rounds
- Exclusive world reservations for parallel sessions
- Restoration of blocks, containers, fluids, pistons, explosions and spawned entities
- Correct cleanup of doors, beds and other multi-block structures
- Silent map preparation without technical player-facing messages
- Original template worlds remain reusable for future rounds
Quick start
- Place
VRandomItemBattle.jar in the server's plugins/ directory.
- Restart the server.
- Run
/setup as an operator.
- Select
multigame or bungee deployment.
- Complete the guided lobby, rules and map steps.
- Review the generated setup summary and type
confirm.
- Players can now join, vote for a map and start the battle.
To create a physical join point, place a sign with [rib] on the first line and the arena name on the second. The sign updates automatically and joins players when clicked.
Main commands
/rib - open the arena browser
/rib join <arena> - join an arena
/rib leave - leave the current arena
/rib vote [map] - vote for a battle map
/stats [player] - view configured player statistics
/top [stat] [amount] - view a configured leaderboard
/private ... - manage private matches
/tournament ... - manage tournament series
/setup - open the guided setup studio
/setup <arena> [map] - edit a specific arena or map
/rib map ... - manage maps, icons and availability
/rib loot ... - manage map-specific item pools
/rib template ... - create, test and manage world templates
/rib round ... - inspect or control an individual parallel round
/rib maintenance ... - drain or reopen maps safely
/rib network ... - inspect and configure proxy routing
/rib storage - inspect FILE/MySQL storage status
/rib reload - reload configuration and arenas
Setup and administration require vrandomitembattle.admin, which is granted to operators by default.
Compatibility
| Platform |
Support |
| Paper |
Fully supported and runtime-tested |
| Purpur |
Supported as a Paper-compatible fork |
| Spigot |
Not supported; required Paper APIs are unavailable |
| Folia |
Not advertised as supported |
Supported Paper versions
1.21
1.21.1
1.21.3 through 1.21.11
26.1.1
26.1.2
26.2
Supported Purpur versions
1.21
1.21.1
1.21.3 through 1.21.11
26.1.2
26.2
Paper did not publish server builds for Minecraft 1.21.2 or 26.1. Purpur additionally has no published 26.1.1 build, so that target is Paper-only.
Java requirements
- Java 21 for Minecraft 1.21.x servers
- Java 25 for Minecraft 26.x servers
The Paper compatibility matrix was validated using the same universal release JAR on all 14 published targets. Purpur inherits the required Paper APIs but was not part of that separate 14-server runtime matrix.
Configuration
Configuration is separated into focused files:
config.yml - core gameplay and arena behavior
network.yml - deployment and proxy routing
messages.yml and language.yml - player-facing and setup text
scoreboard.yml - phase-specific sidebar layouts
interface.yml - menus, hotbar items, sounds and visual presentation
storage.yml - FILE/MySQL and per-statistic behavior
loot-profiles.yml - weighted item profiles and rarities
modifiers.yml - optional round modifiers
matches.yml - private matches, tournaments and optional systems
Use /rib reload after gameplay or presentation changes. Restart the server after changing the storage backend connection.
Metrics
VRandomItemBattle uses anonymous bStats metrics to help understand how the plugin is used. Metrics can be disabled through the standard bStats configuration.
评论 0
登录后参与评分
还没有评论,来抢沙发吧