功能
- 自动物品分发:按可配置的时间间隔,向每位在线玩家随机发放物品
- 稀有度层级:将物品划分为普通、稀有、史诗和传说等层级,每个层级拥有独立的权重、颜色、名称和掉落概率
- 稀有掉落庆祝:在聊天中公告稀有发现,并向幸运玩家显示标题、播放音效以及发射烟花
- 自定义物品:创建任意数量的特殊物品,包括专属名称、描述文本、稀有度和效果,例如即时 TNT、闪电棒和火球法杖
- 视觉倒计时:通过Boss栏显示距离下一次物品分发的剩余时间
- 统计数据:追踪每位玩家获得的物品数量、稀有物品数量以及上次获得的物品
- 排行榜:比较服务器中排名前 ten 的收藏家
- 掉落历史:查看最近的掉落记录,最新的排在前面
- 给予指令:按需向指定玩家发放随机物品
- 服务器概览:随时查看当前状态、分发间隔、下次掉落时间、生效世界及稀有度概率
- 暂停功能:在活动或服务器维护期间暂时停止物品分发
- 背包处理:选择当玩家背包已满时是跳过本次发放、将物品掉落在脚边,还是暂存并在有空位时交付
- 世界特定设置:配置哪些世界接收物品以及公告出现的位置
- 玩家控制:玩家可以自行切换 Boss 栏的可见性
- 排除物品:将危险或不想要的物品排除在掉落池之外
- 可配置间隔:可在游戏内或配置文件中设置物品分发之间的时间间隔
- 数据持久化:统计数据、最近掉落记录、Boss 栏偏好设置以及暂存的物品会在重载和重启后保留
命令
| 命令 |
描述 |
权限 |
/randomitem start |
启动随机物品分发,或在暂停后恢复 |
randomitems.admin |
/randomitem stop |
停止随机物品分发 |
randomitems.admin |
/randomitem pause [seconds] |
暂停分发指定的秒数,或使用默认时长;再次使用以恢复 |
randomitems.admin |
/randomitem setinterval <seconds> |
设置物品分发之间的间隔并保存 |
randomitems.admin |
/randomitem togglebossbar |
切换自身倒计时的 Boss 栏可见性 |
无 |
/randomitem reload |
重载配置文件并保留所有已记录的数据 |
randomitems.admin |
/randomitem stats [player] |
显示获得的物品、稀有物品、上次获得的物品及排行榜排名;检查其他玩家的统计信息需要管理员权限 |
仅对自己无需权限 |
/randomitem give <player> [amount] |
向一名在线玩家发放一个到六十四个随机物品 |
randomitems.admin |
/randomitem info |
显示状态、间隔、下次掉落时间、世界、符合条件的玩家及稀有度概率 |
无 |
/randomitem history [count] |
显示最近的掉落记录,默认为十条,最新的排在前面 |
无 |
/randomitem top |
显示收集物品最多的十名玩家 |
无 |
权限
randomitems.admin - 允许启动、停止、暂停、更改间隔、发放物品、查看其他玩家的统计数据以及重载配置文件(默认:OP)
- 每位玩家均可使用
/randomitem togglebossbar、/randomitem stats、/randomitem info、/randomitem history 和 /randomitem top,无需任何权限
配置
所有选项均位于插件配置文件中,可以在服务器运行时进行修改并重载:
- interval: 物品分发之间的时间(秒)。必须大于或等于 1,在游戏内修改时会保存
- distribution-worlds: 接收物品的世界。留空列表则使用所有世界
- excluded-materials: 永远不会从掉落池中发放的物品,即使它们列在某个稀有度层级内
- full-inventory-behavior: 当玩家没有空闲背包槽位时发生的情况。
SKIP 表示本轮不发放任何物品,DROP_AT_FEET 将物品掉落在玩家旁边的地面上,QUEUE 则暂存物品并在下次掉落或玩家带着空位重新加入时交付
- broadcast-worlds: 看到稀有掉落公告和庆祝的世界。留空列表则使用所有世界
- history-size: 为
/randomitem history 记住的最近掉落记录数量
- rarity-tiers: 物品被划分的层级,详见下文
- custom-items: 插件可以发放的特殊物品,详见下文
- pause-command-enabled: 允许或阻止使用
/randomitem pause 命令
- default-pause-duration: 在使用暂停命令但未提供数字时使用的暂停时长(秒)
- bossbar: 倒计时 Boss 栏的颜色、样式、标题和暂停时的标题,以及完全关闭它的开关
- sounds: 开启或关闭物品拾取音效和 Boss 栏切换音效
- messages: 插件发送的所有消息,包含颜色代码和占位符
稀有度层级
每个层级支持以下选项:
- display-name: 在消息、统计数据和历史记录中显示的名称
- color: 用于该名称的颜色代码
- weight: 整个层级的相对概率。权重为 80 的层级比权重为 5 的层级可能性高出十六倍
- broadcast: 在配置好的广播世界中向聊天公告来自此层级的掉落
- celebration: 向看到公告的玩家显示标题
- firework: 向找到物品的玩家发射烟花
- sound: 公告掉落时播放的音效;留空则为静音
- items: 属于该层级的物品。同一层级内的每个物品具有与其他物品相同的掉落概率
任何未列入各稀有度层级的物品都会自动归入 common(普通)层级,因此掉落池始终涵盖除已排除物品之外的所有内容。每个层级的概率为其权重除以所有包含物品的层级的总权重,游戏中的 /randomitem info 命令会显示这些概率。
自定义物品
每个自定义物品支持以下选项:
- enabled:该物品是否参与掉落池
- tier:该物品所属的稀有度层级
- material:基于的物品材质
- name:物品的显示名称
- lore:显示在名称下方的文本行
- effect:使用物品时触发的效果。提供
INSTANT_TNT、LIGHTNING 和 FIREBALL 三种选项
- explosion-power、break-blocks 和 set-fire:仅由
INSTANT_TNT 使用,用于控制爆炸范围、方块是否被破坏以及是否留下火焰
默认包含:
- Instant TNT - 放置时立即爆炸,无需等待引信
- Lightning Stick - 右键点击向准星所指的方块召唤闪电;若未瞄准方块,则对自身召唤闪电
- Fireball Wand - 右键点击朝面朝方向发射火球
自定义物品在使用时会逐个消耗,并像普通物品一样堆叠。
Boss Bar 设置
通过以下选项自定义视觉倒计时:
- Colors(颜色):BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
- Styles(样式):SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
- Titles(标题):倒计时标题与暂停标题均接受
%time% 占位符
- Visibility(可见性):玩家可以自行隐藏或显示 Boss Bar,且偏好设置会被记住
公告与庆祝
稀有掉落让全服保持兴奋:
- 可为每个层级单独选择是发布公告、举行庆祝还是两者兼有
- 广播、标题和声音仅发送至配置中的广播世界
- 烟花会在发现物品的玩家处燃放
- 公告的所有部分,包括物品、层级和玩家名称,均可在消息设置中重新措辞
统计与历史
- 每次掉落都会被记录给接收它的玩家,稀有物品会单独计数
/randomitem stats 显示玩家的总数、上次获得的物品及其排名,工作人员可以查询任何获得过物品的玩家
/randomitem top 列出拥有最多物品的十名玩家排名
/randomitem history 按最新掉落优先排序列出历史记录,最多达到配置的历史记录大小
- 所有记录均保存至磁盘,并在重载或重启后恢复
世界支持
- 支持在不同世界中配置不同的掉落分布设置
- 支持按世界控制公告
- 玩家仅在配置的分布世界中接收物品、Boss Bar 和倒计时
玩家体验
- 玩家会收到一条消息,指明获得的物品及其稀有度
- 稀有发现会向配置的世界广播,同时附带标题和音效
- 玩家可以随时查看自己的统计数据、排行榜和最近掉落
- 玩家永远不会因背包满而丢失物品:根据配置,物品会被跳过、掉落或暂存直到有空位
- 如果玩家希望界面更简洁,可以选择隐藏倒计时 Boss Bar
Features
- Automatic Item Distribution: Give random items to every online player on a configurable interval
- Rarity Tiers: Sort items into tiers such as Common, Rare, Epic and Legendary, each with its own weight, colour, name and drop chance
- Rare Drop Celebrations: Announce rare finds in chat and show a title, play a sound and launch a firework for the lucky player
- Custom Items: Create any number of special items with their own name, lore, rarity and effect, including Instant TNT, a Lightning Stick and a Fireball Wand
- Visual Countdown: Boss bar showing the time until the next item distribution
- Statistics: Track how many items each player has received, how many were rare and which item they got last
- Leaderboard: Compare the top ten collectors on the server
- Drop History: Review the most recent drops, newest first
- Give Command: Hand out random items to a chosen player on demand
- Server Overview: Check the current status, interval, next drop, active worlds and rarity chances at any time
- Pause Functionality: Temporarily pause item distribution for events or server maintenance
- Inventory Handling: Choose whether a player with a full inventory skips the item, gets it dropped at their feet, or has it held until there is space
- World-Specific Settings: Configure which worlds receive items and where announcements appear
- Player Controls: Players can toggle the boss bar visibility for themselves
- Excluded Items: Keep dangerous or unwanted items out of the drop pool
- Configurable Interval: Set the time between item distributions, in game or in the configuration
- Everything is Kept: Statistics, recent drops, boss bar preferences and held items survive reloads and restarts
Commands
| Command |
Description |
Permission |
/randomitem start |
Start the random item distribution, or resume it when paused |
randomitems.admin |
/randomitem stop |
Stop the random item distribution |
randomitems.admin |
/randomitem pause [seconds] |
Pause distribution for the given seconds, or the default duration; use it again to resume |
randomitems.admin |
/randomitem setinterval <seconds> |
Set the interval between item distributions and save it |
randomitems.admin |
/randomitem togglebossbar |
Toggle visibility of the countdown boss bar for yourself |
None |
/randomitem reload |
Reload the configuration and keep all recorded data |
randomitems.admin |
/randomitem stats [player] |
Show items received, rare items, the last item and the leaderboard rank; checking another player requires admin |
None for yourself |
/randomitem give <player> [amount] |
Give one to sixty-four random items to an online player |
randomitems.admin |
/randomitem info |
Show the status, interval, next drop, worlds, eligible players and rarity chances |
None |
/randomitem history [count] |
Show the most recent drops, ten by default, newest first |
None |
/randomitem top |
Show the ten players who have collected the most items |
None |
Permissions
randomitems.admin - Allows starting, stopping, pausing, changing the interval, giving items, checking other players' statistics and reloading the configuration (Default: OP)
- Every player can use
/randomitem togglebossbar, /randomitem stats, /randomitem info, /randomitem history and /randomitem top without any permission
Configuration
Every option lives in the plugin configuration and can be changed and reloaded while the server is running:
- interval: Time in seconds between item distributions. It must be 1 or higher and is saved when changed in game
- distribution-worlds: Worlds that receive items. Leave the list empty to use every world
- excluded-materials: Items that are never handed out by the drop pool, even when they are listed inside a rarity tier
- full-inventory-behavior: What happens when a player has no free inventory slot.
SKIP gives nothing that round, DROP_AT_FEET drops the item on the ground next to the player, and QUEUE holds the item and delivers it at the next drop or when the player rejoins with free space
- broadcast-worlds: Worlds that see rare drop announcements and celebrations. Leave the list empty to use every world
- history-size: How many recent drops are remembered for
/randomitem history
- rarity-tiers: The tiers items are sorted into, described below
- custom-items: The special items the plugin can give out, described below
- pause-command-enabled: Allows or blocks the
/randomitem pause command
- default-pause-duration: Pause length in seconds used when the pause command is used without a number
- bossbar: Colour, style, title and paused title of the countdown boss bar, plus a switch to turn it off entirely
- sounds: Turns the item pickup sound and the boss bar toggle sound on or off
- messages: Every message the plugin sends, with colour codes and placeholders
Rarity Tiers
Each tier supports these options:
- display-name: The name shown in messages, statistics and the history
- color: The colour code used for that name
- weight: The relative chance of the whole tier. A tier with weight 80 is sixteen times as likely as a tier with weight 5
- broadcast: Announces drops from this tier in chat to the configured broadcast worlds
- celebration: Shows a title to the players who see announcements
- firework: Launches a firework at the player who found the item
- sound: The sound played for an announced drop; leave it empty for silence
- items: The items belonging to the tier. Every item inside a tier has the same chance as the others in that tier
Any item that is not listed in any tier is automatically added to the common tier, so the drop pool always covers everything except excluded items. The chance of each tier is its weight divided by the total weight of all tiers that contain items, and /randomitem info shows those chances in game.
Custom Items
Each custom item supports these options:
- enabled: Whether the item is part of the drop pool
- tier: The rarity tier the item belongs to
- material: The item it is based on
- name: The display name of the item
- lore: The lines of text shown under the name
- effect: What happens when the item is used.
INSTANT_TNT, LIGHTNING and FIREBALL are available
- explosion-power, break-blocks and set-fire: Only used by
INSTANT_TNT to control the size of the blast, whether blocks break and whether fire is left behind
Included by default:
- Instant TNT - explodes the moment it is placed instead of waiting for a fuse
- Lightning Stick - right-click to call down lightning on the block you are looking at, or on yourself when you are not aiming at a block
- Fireball Wand - right-click to launch a fireball in the direction you are facing
Custom items are consumed one at a time when they are used and stack like normal items.
Boss Bar Settings
Customize the visual countdown with your choice of:
- Colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
- Styles: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
- Titles: The countdown title and the paused title both accept the
%time% placeholder
- Visibility: Players can hide or show the boss bar for themselves, and the choice is remembered
Announcements and Celebrations
Rare drops keep the whole server excited:
- Choose per tier whether a drop is announced, celebrated or both
- Broadcasts, titles and sounds only reach the configured broadcast worlds
- Fireworks are launched at the player who found the item
- Every part of the announcement, including the item, tier and player name, can be reworded in the message settings
Statistics and History
- Every drop is counted for the player who received it, with rare items counted separately
/randomitem stats shows a player's totals, their last item and their rank, and staff can look up any player who has received items
/randomitem top ranks the ten players with the most items
/randomitem history lists the newest drops first, up to the configured history size
- All records are saved to disk and restored after a reload or restart
World Support
- Support for multiple worlds with different distribution settings
- World-specific announcement control
- Players only receive items, boss bars and countdowns in configured distribution worlds
Player Experience
- Players receive a message naming the item and its rarity
- Rare finds are announced to the configured worlds, together with a title and sound
- Players can check their own statistics, the leaderboard and recent drops at any time
- Players are never left with a lost item: depending on the configuration it is skipped, dropped or held until there is space
- Players can hide the countdown boss bar if they prefer a cleaner screen
评论 0
登录后参与评分
还没有评论,来抢沙发吧