ItemShuffleRoyale
中文说明
适用于 Spigot/Paper 的基于回合制的物品搜寻大逃杀迷你游戏。
本插件由 YusufTe 制作。
简介
每轮中,每位存活玩家都会获得一个随机目标物品。在计时器耗尽前找到该物品的玩家将进入下一轮;失败者将被淘汰并变为旁观者。最后存活的玩家获胜。
所有游戏内文本均为中文。
每轮开始时,会播放一种老虎机风格的动画来展示玩家的新目标。在搜寻过程中,两种特殊物品可以提供帮助:
- 跳过道具(默认:下界之星)—— 右键点击可重新掷出当前目标(有冷却时间,消耗 1 个)。
- 玩家指南针(默认:指南针)—— 右键点击可在其他存活玩家之间循环切换并追踪他们。
进行中的游戏会被保存;即使在游戏中途重启服务器,也能自动恢复。
命令与权限
游戏内命令:/shuffle <start|stop|pause|resume|whitelist>
| 子命令 |
描述 |
权限 |
start |
开始一场新游戏 |
itemshuffle.start |
stop |
停止当前进行中的游戏 |
itemshuffle.stop |
pause |
暂停当前回合计时器 |
itemshuffle.pause |
resume |
恢复已暂停的回合 |
itemshuffle.resume |
whitelist |
打开白名单管理界面(移除物品、保存) |
itemshuffle.whitelist |
执行该命令本身需要基础权限 itemshuffle.use。所有权限默认仅对 op(管理员)开放。
回合时间缩放
随着游戏推进,回合倒计时会逐渐缩短。从 duration_seconds 设定的初始值开始,每经过 duration_decrease_every_rounds 个回合,时间减少 duration_decrease_seconds 秒,且永远不会低于 min_duration_seconds 设定的最低值。
使用默认设置(初始 600 秒,每 3 回合减少 60 秒,下限 180 秒):
| 回合数 |
剩余时间 |
| 1–3 |
10:00 |
| 4–6 |
9:00 |
| 7–9 |
8:00 |
| … |
… |
| 19–21 |
4:00 |
| 22–24 |
3:00 |
| 25+ |
3:00 (固定) |
若希望保持时间不变,请将 duration_decrease_every_rounds 设置为 0。
配置
所有游戏设置均在 config.yml 中;玩家可见的所有文本均在 messages.yml 中。
config.yml 中每个键上方都有详细的注释说明。概要如下:
round.*
| 键名 |
含义 |
duration_seconds |
回合初始时长(秒)。 |
duration_decrease_every_rounds |
每隔 N 个回合减少一次时长(0 = 不减少)。 |
duration_decrease_seconds |
每次减少的秒数(60 = 1 分钟)。 |
min_duration_seconds |
回合时长的最低限制值。 |
animation_duration_seconds |
老虎机风格的目标确定动画持续时间。 |
animation_interval_ticks |
动画刷新间隔(20 tick = 1 秒;数值越小 = 动画越快)。 |
animation_sound |
动画期间播放的声音(Bukkit Sound 枚举名称)。 |
animation_sound_pitch_min |
动画开始时的音调。 |
animation_sound_pitch_max |
动画结束时的音调(随进度逐渐升高至该值)。 |
spawn_location.*
| 键名 |
含义 |
world |
每轮玩家传送到的世界(使用该世界的默认出生点)。 |
skip_item.* / compass_item.*
| 键名 |
含义 |
material |
物品的 Bukkit Material 类型。 |
name |
显示名称(支持 & 颜色代码)。 |
lore |
描述(tooltip)行。 |
amount |
(仅限 skip_item)游戏开始时发放的数量。 |
whitelist
允许作为目标的 Bukkit Material 名称列表。可以通过手动编辑或在游戏内使用 /shuffle whitelist 进行修改。
English Explanation
A round-based item-hunt battle royale minigame for Spigot/Paper (Java 21, Minecraft API 1.21).
What is it?
Every round, each living player is assigned a random target item. Find it before the timer
runs out and you advance to the next round; fail and you are eliminated to spectator. The last
survivor wins. All in-game text is Turkish.
A slot-machine style animation reveals each player's new target at the start of every round, and
two special items help during the hunt:
- Skip item (default: Nether Star) — right-click to reroll your current target (cooldown + consumes one).
- Player compass (default: Compass) — right-click to cycle through and track other living players.
Live games are persisted, so a mid-game server restart is recovered automatically.
Commands & permissions
In-game command: /shuffle <start|stop|pause|resume|whitelist>
| 子命令 |
描述 |
权限 |
start |
开始一场新游戏 |
itemshuffle.start |
stop |
停止正在运行的游戏 |
itemshuffle.stop |
pause |
暂停当前轮次计时器 |
itemshuffle.pause |
resume |
恢复已暂停的轮次 |
itemshuffle.resume |
whitelist |
打开白名单编辑器 GUI(移除物品、保存) |
itemshuffle.whitelist |
执行该命令本身需要基础权限 itemshuffle.use。所有权限默认仅给予 OP。
轮次时长缩放
随着游戏进行,轮次计时会逐渐缩短。从 duration_seconds 开始,每经过 duration_decrease_every_rounds 轮,持续时间减少 duration_decrease_seconds,但不会低于 min_duration_seconds。
使用默认值(起始 600 秒,每 3 轮减少 60 秒,最低 180 秒):
| 轮次范围 |
持续时间 |
| 1–3 |
10:00 |
| 4–6 |
9:00 |
| 7–9 |
8:00 |
| … |
… |
| 19–21 |
4:00 |
| 22–24 |
3:00 |
| 25+ |
3:00(固定) |
将 duration_decrease_every_rounds 设为 0 可保持持续时间不变。
配置
所有游戏玩法调整均位于 config.yml 中;所有面向用户的字符串均位于 messages.yml 中。config.yml 中的每个键上方都有内联注释说明。摘要如下:
round.*
| 键 |
含义 |
duration_seconds |
初始轮次长度(秒)。 |
duration_decrease_every_rounds |
每 N 轮缩短一次轮次时长(0 = 永不缩短)。 |
duration_decrease_seconds |
每次缩减步骤减少的秒数(60 = 1 分钟)。 |
min_duration_seconds |
轮次长度可降低到的最低值。 |
animation_duration_seconds |
老虎机目标揭示动画的持续时间。 |
animation_interval_ticks |
动画刷新间隔(20 ticks = 1 秒;数值越低越快)。 |
animation_sound |
动画期间播放的声音(Bukkit Sound 名称)。 |
animation_sound_pitch_min |
动画开始时的音调。 |
animation_sound_pitch_max |
动画结束时的音调(随着动画进行,音调会向此值升高)。 |
spawn_location.*
| 键 |
含义 |
world |
玩家每轮被传送到的世界(使用该世界自己的出生点)。 |
skip_item.* / compass_item.*
| 键 |
含义 |
material |
物品的 Bukkit Material 类型。 |
name |
显示名称(支持 & 颜色代码)。 |
lore |
工具提示行。 |
amount |
(仅限 skip_item)游戏开始时发放的数量。 |
whitelist
可作为目标选择的 Bukkit Material 名称列表。可通过手动编辑或使用 /shuffle whitelist 在游戏内编辑。
ItemShuffleRoyale
Türkçe Anlatım
Spigot/Paper için tur bazlı item avı battle royale mini oyunu.
Eklenti YusufTe için yapılmıştır.
Nedir?
Her turda, hayatta kalan her oyuncuya rastgele bir hedef eşya verilir. Süre dolmadan eşyayı
bulan oyuncu bir sonraki tura geçer; bulamayan elenir ve izleyici olur. Son kalan oyuncu kazanır.
Tüm oyun içi metinler Türkçedir.
Her turun başında, oyuncunun yeni hedefini gösteren bir slot makinesi animasyonu oynar. Av sırasında
iki özel eşya yardımcı olur:
- Atlama eşyası (varsayılan: Nether Star) — sağ tıklayınca mevcut hedefi yeniden atar (bekleme süreli, 1 adet tüketir).
- Oyuncu pusulası (varsayılan: Pusula) — sağ tıklayınca diğer canlı oyuncular arasında gezip onları takip eder.
Devam eden oyun kaydedilir; oyun ortasında sunucu yeniden başlasa bile
otomatik olarak kurtarılır.
Komutlar ve yetkiler
Oyun içi komut: /shuffle <start|stop|pause|resume|whitelist>
| Alt komut |
Açıklama |
Yetki |
start |
Yeni bir oyun başlatır |
itemshuffle.start |
stop |
Devam eden oyunu durdurur |
itemshuffle.stop |
pause |
Mevcut tur sayacını duraklatır |
itemshuffle.pause |
resume |
Duraklatılmış turu devam ettirir |
itemshuffle.resume |
whitelist |
Whitelist düzenleme arayüzünü açar (eşya çıkar, kaydet) |
itemshuffle.whitelist |
Komutun kendisi için temel itemshuffle.use yetkisi gerekir. Tüm yetkiler varsayılan olarak op'tur.
Tur süresi ölçeklemesi
Tur sayacı oyun ilerledikçe kısalır. duration_seconds değerinden başlayarak, her
duration_decrease_every_rounds turda bir süre duration_decrease_seconds kadar azalır ve hiçbir
zaman min_duration_seconds değerinin altına inmez.
Varsayılan ayarlarla (başlangıç 600 sn, her 3 turde −60 sn, taban 180 sn):
| Turlar |
Süre |
| 1–3 |
10:00 |
| 4–6 |
9:00 |
| 7–9 |
8:00 |
| … |
… |
| 19–21 |
4:00 |
| 22–24 |
3:00 |
| 25+ |
3:00 (sabit) |
Süreyi sabit tutmak için duration_decrease_every_rounds: 0 yapın.
Yapılandırma
Tüm oyun ayarları config.yml içindedir; oyuncuya görünen her metin messages.yml içindedir.
config.yml içindeki her anahtarın üstünde açıklayıcı bir yorum satırı vardır. Özet:
round.*
| Anahtar |
Anlamı |
duration_seconds |
Turun başlangıç süresi (saniye). |
duration_decrease_every_rounds |
Tur süresi her N turde bir azaltılır (0 = hiç azalmaz). |
duration_decrease_seconds |
Her azalma adımında düşülen saniye (60 = 1 dakika). |
min_duration_seconds |
Tur süresinin inebileceği en düşük değer. |
animation_duration_seconds |
Slot makinesi hedef belirleme animasyonunun süresi. |
animation_interval_ticks |
Animasyonun yenilenme aralığı (20 tick = 1 sn; düşük = daha hızlı). |
animation_sound |
Animasyon sırasında çalınan ses (Bukkit Sound adı). |
animation_sound_pitch_min |
Animasyonun başındaki ses perdesi. |
animation_sound_pitch_max |
Animasyonun sonundaki ses perdesi (ilerledikçe bu değere yükselir). |
spawn_location.*
| Anahtar |
Anlamı |
world |
Her tur oyuncuların ışınlanacağı dünya (dünyanın kendi spawn noktası kullanılır). |
skip_item.* / compass_item.*
| Anahtar |
Anlamı |
material |
Eşyanın Bukkit Material değeri. |
name |
Görünen ad (& renk kodlarını destekler). |
lore |
Açıklama (tooltip) satırları. |
amount |
(yalnızca skip_item) Oyun başında verilecek adet. |
whitelist
Hedef olarak seçilebilecek Bukkit Material adlarının listesi. Elle ya da oyun içinde
/shuffle whitelist ile düzenleyebilirsiniz.
Explanation in English
A round-based item-hunt battle royale minigame for Spigot/Paper (Java 21, Minecraft API 1.21).
What is it?
Every round, each living player is assigned a random target item. Find it before the timer
runs out and you advance to the next round; fail and you are eliminated to spectator. The last
survivor wins. All in-game text is Turkish.
A slot-machine style animation reveals each player's new target at the start of every round, and
two special items help during the hunt:
- Skip item (default: Nether Star) — right-click to reroll your current target (cooldown + consumes one).
- Player compass (default: Compass) — right-click to cycle through and track other living players.
Live games are persisted, so a mid-game server restart is recovered automatically.
Commands & permissions
In-game command: /shuffle <start|stop|pause|resume|whitelist>
| Subcommand |
Description |
Permission |
start |
Start a new game |
itemshuffle.start |
stop |
Stop the running game |
itemshuffle.stop |
pause |
Pause the current round timer |
itemshuffle.pause |
resume |
Resume a paused round |
itemshuffle.resume |
whitelist |
Open the whitelist editor GUI (remove items, save) |
itemshuffle.whitelist |
Base permission itemshuffle.use is required for the command itself. All permissions default to op.
Round duration scaling
The round timer shortens as the game goes on. Starting from duration_seconds, every
duration_decrease_every_rounds rounds the duration drops by duration_decrease_seconds, never
going below min_duration_seconds.
With the defaults (start 600 s, −60 s every 3 rounds, floor 180 s):
| Rounds |
Duration |
| 1–3 |
10:00 |
| 4–6 |
9:00 |
| 7–9 |
8:00 |
| … |
… |
| 19–21 |
4:00 |
| 22–24 |
3:00 |
| 25+ |
3:00 (fixed) |
Set duration_decrease_every_rounds: 0 to keep the duration constant.
Configuration
All gameplay tuning lives in config.yml; every user-facing string lives in messages.yml. Each
key in config.yml is documented with an inline comment above it. Summary:
round.*
| Key |
Meaning |
duration_seconds |
Starting round length (seconds). |
duration_decrease_every_rounds |
Shorten the round every N rounds (0 = never shorten). |
duration_decrease_seconds |
Seconds removed per decrease step (60 = 1 minute). |
min_duration_seconds |
Lowest the round length can drop to. |
animation_duration_seconds |
Length of the slot-machine target reveal animation. |
animation_interval_ticks |
Refresh interval of the animation (20 ticks = 1 s; lower = faster). |
animation_sound |
Sound played during the animation (Bukkit Sound name). |
animation_sound_pitch_min |
Pitch at the start of the animation. |
animation_sound_pitch_max |
Pitch at the end (pitch rises toward this as it progresses). |
spawn_location.*
| Key |
Meaning |
world |
World players are teleported to each round (its own spawn point is used). |
skip_item.* / compass_item.*
| Key |
Meaning |
material |
The item's Bukkit Material. |
name |
Display name (supports & color codes). |
lore |
Tooltip lines. |
amount |
(skip_item only) How many are given on game start. |
whitelist
List of Bukkit Material names that can be chosen as targets. Edit it by hand or in-game with
/shuffle whitelist.
评论 0
登录后参与评分
还没有评论,来抢沙发吧