Speed Builders - · 建筑竞速小游戏插件

Speed Builders

Speed Builders 是一款面向现代 Minecraft 服务器的记忆建造小游戏插件。玩家需要记住随机展示的建筑，并在限时内尽可能准确地复原；系统会自动评判建造结果并淘汰进度最低的玩家，直到决出最终赢家。

⭐插件亮点

• 支持 Minecraft 1.21+
• 多竞技场系统，可创建不限数量的竞技场
• 支持 FAWE、BungeeCord、PlaceholderAPI、MVdWPlaceholderAPI 和 MySQL
• 自动评判建造结果，支持 Allay Judge 动画
• 动态记分板、Action Bar 计时器和 BungeeCord MOTD
• 支持连胜、完美建造、最快建造和胜场排行榜全息图
• 支持每日挑战、MVP 与等级系统
• 支持淘汰阶段的岛屿动画
• Discord：#Ludovito

🔧视频教程

• 视频教程：帮助用户快速、正确地配置插件，演示推荐的设置流程。
• 视频教程：新版多平台建筑模板系统。
• 视频教程：13.0.0 新版本，包含全新动画和建筑模板验证功能。

🎮截图与展示

以下截图展示了作者的个人配置，并针对演示进行了自定义。插件默认配置中的颜色、消息和视觉设置可能有所不同，也可以调整为相同效果。

• 新版动态记分板：可在 scoreboard.yml 中配置。
• 新版 Action Bar 计时器：可在 messages.yml 中配置。
• 新版 BungeeCord MOTD：可在 messages.yml 中配置。
• 新版 Top 10 排行全息图：支持连胜、胜场、完美建造和最快建造排行榜，可在 holograms.yml 中配置。
• 新版每日挑战：可在 dailychallenges.yml 中配置。
• 新版 MVP 与等级系统

💡游戏玩法

• 记住建筑：玩家有短暂时间观察系统选中的建筑模板。
• 复原建筑：建造阶段开始后，每位玩家都要在自己的平台上重建建筑。
• 接受扫描：Allay Judge 扫描各玩家的建造，并计算完成度。
• 避免淘汰：完成度最低的玩家将被淘汰。
• 赢得比赛：留到最后的玩家获胜。

每回合开始时，系统会向所有玩家展示一个随机建筑模板。记忆阶段结束后，玩家必须在时间耗尽前完成建造。建造阶段结束后，插件会逐个方块比较玩家的作品，并自动计算进度。

✨核心功能

• 游戏玩法：记忆建造回合、随机选择建筑模板、自动淘汰、飞行建造模式、可配置计时器、淘汰时的岛屿动画、每日挑战。
• 竞技场：多竞技场系统、无限创建竞技场、竞技场选择 GUI。
• 自定义选项：可配置消息、记分板、竞技场菜单和游戏设置；支持自定义建筑模板。
• 排行榜：自定义 Top 10 连胜、胜场、完美建造和最快建造排行榜全息图。
• 服务器支持：Minecraft 1.21+、Spigot、Paper、BungeeCord、PlaceholderAPI 和 MySQL。

⭐智能 Allay Judge

每回合结束后，动画版 Allay Judge 会扫描玩家的建筑，检查复原准确度。插件逐方块对比建筑，并据此自动计算玩家进度和淘汰结果。

🎮配置文件

插件支持灵活配置，几乎所有游戏环节都可以调整。

• config.yml：游戏设置、计时器和插件选项。
• messages.yml：可完全自定义的聊天消息和标题。
• scoreboard.yml：适用于不同游戏状态的动态记分板。
• arenamenu.yml：竞技场选择 GUI 和物品自定义。
• holograms.yml：可完全自定义的连胜全息图。
• mysql.yml：配置 MySQL 数据库，用于保存玩家数据。
• dailychallenges.yml：每日挑战配置。

config.yml 示例

update-check: true
settings:
  bungeecord: false
  toserver: "Lobby"
  min-players: 2
  max-players: 8
  start-countdown: 15
  memorize-time: 10
  build-time: 20
  build-time-decrease-per-round: 2
  minimum-build-time: 15
  next-round-delay: 3
  ending-countdown: 10
  restart-command: "restart"
world:
  always-day: true
  clear-weather: true
judge:
  enabled: true
  name: "&b&lAllay Judge"
  height-above-area: 10
  scan-delay-ticks: 40
  result-delay-ticks: 30
  return-delay-ticks: 40
  animation-ticks-per-segment: 12
  particle-refresh-ticks: 6
  particles: true
island-animation:
  enabled: true
  displays: 75
  duration: 30
  teleport-height: 10
  explosion-sound: true
  particles: true
items:
  arena-menu:
    enabled: true
    slot: 0
    material: NETHER_STAR
    name: "&b&lSpeed Builders &8>> &7Arenas"
  leave-item:
    enabled: true
    slot: 8
    material: RED_BED
    name: "&c&lLeave Arena"
rewards:
  winner-commands:
  - "eco give %player% 100"
  - "say JUST TEST MESSAGE! :)"

dailychallenges.yml 示例

settings:
  enabled: true
  # Time zone used for selecting the current day
  # and calculating the next daily reset.
  timezone: "Europe/Prague"
  # Time when the challenges reset.
  # Format: HH:mm
  reset-time: "00:00"
  # Sends a reminder after the player joins.
  join-reminder: true
  # Shows challenge progress in the action bar.
  progress-actionbar: true
  # Automatically gives rewards immediately after completing a challenge.
  # If false, the player must click the completed challenge in the GUI.
  auto-claim-rewards: true
  # Executes reward commands from the console.
  # If false, the player executes the commands.
  reward-commands-as-console: true
gui:
  title: "&8Daily Challenges"
  size: 54
  challenge-slots:
  - 10
  - 12
  - 14
  - 16
  - 28
  - 30
  - 32
  - 34
  filler:
    enabled: true
    material: "GRAY_STAINED_GLASS_PANE"
    name: " "
  information-item:
    slot: 49
    material: "CLOCK"
    name: "&6&lDaily Challenges"
    lore:
    - ""
    - "&7Complete today's challenges"
    - "&7before the daily reset."
    - ""
    - "&7Current day: &f%day%"
    - "&7Time left: &f%time_left%"
    - "&7Reset time: &f%reset_time%"
    - ""
    - "&7Page: &f%page%&7/&f%pages%"
  previous-page-item:
    slot: 45
    material: "ARROW"
    name: "&ePrevious Page"
    lore:
    - ""
    - "&7Click to open the previous page."
  close-item:
    slot: 50
    material: "BARRIER"
    name: "&cClose"
  next-page-item:
    slot: 53
    material: "ARROW"
    name: "&eNext Page"
    lore:
    - ""
    - "&7Click to open the next page."
formats:
  progress-bar:
    length: 10
    completed-symbol: "■"
    remaining-symbol: "■"
    completed-color: "&a"
    remaining-color: "&7"
    completed-status: "&a&lCOMPLETED"
    incomplete-status: "&e%current%&7/&e%required%"
    claimed-status: "&6&lREWARD CLAIMED"
    click-to-claim: "&eClick to claim your reward!"
  default-lore:
  - ""
  - "%description%"
  - ""
  - "&7Progress: &f%progress%"
  - "%progress_bar%"
  - ""
  - "&7Reward:"
  - "%rewards%"
  - ""
  - "%status%"
messages:
  progress-actionbar: "&eDaily Challenge: &f%challenge% &7- &e%current%&7/&e%required%"
  completed:
    chat: "%prefix%&aYou completed the daily challenge &e%challenge%&a!"
    actionbar: "&a&lCHALLENGE COMPLETED! &f%challenge%"
    title: "&a&lCHALLENGE COMPLETED!"
    subtitle: "&f%challenge%"
  reward-claimed: "%prefix%&aYou claimed the reward for &e%challenge%&a!"
  reward-already-claimed: "%prefix%&cYou have already claimed this reward."
  challenge-not-completed: "%prefix%&cYou have not completed this challenge yet."
  all-completed:
  - ""
  - "%prefix%&6You completed all daily challenges!"
  - ""
join-reminder:
- ""
- "%prefix%&eYou have &f%unfinished% &eunfinished daily challenges."
- "%prefix%&7Use &f/sb challenges &7to view them."
- ""
days:
  monday:
    enabled: true
    challenges:
      complete-builds:
        enabled: true
        type: "COMPLETE_BUILDS"
        name: "&a&lBuilder's Start"
        material: "BRICKS"
        description:
        - "&7Complete &f10 builds&7."
        - "&7Only fully completed builds count."
        required: 10
        rewards:
          display:
          - "&6+250 Coins"
          - "&e+1 Vote Key"
          commands:
          - "eco give %player% 250"
          - "crate key give %player% vote 1"
      win-games:
        enabled: true
        type: "WIN_GAMES"
        name: "&6&lDaily Winner"
        material: "GOLDEN_APPLE"
        description:
        - "&7Win &f3 Speed Builders games&7."
        required: 3
        rewards:
          display:
          - "&6+500 Coins"
          commands:
          - "eco give %player% 500"
      fastest-build:
        enabled: true
        type: "COMPLETE_BUILD_UNDER_TIME"
        name: "&b&lSpeed Builder"
        material: "CLOCK"
        description:
        - "&7Complete a build in under"
        - "&f20 seconds&7."
        required: 1
        options:
          maximum-time-milliseconds: 20000
        rewards:
          display:
          - "&6+750 Coins"
          commands:
          - "eco give %player% 750"
  tuesday:
    enabled: true
    challenges:
      perfect-builds:
        enabled: true
        type: "PERFECT_BUILDS"
        name: "&e&lPerfect Builder"
        material: "NETHER_STAR"
        description:
        - "&7Complete &f5 perfect builds&7."
        required: 5
        rewards:
          display:
          - "&6+400 Coins"
          commands:
          - "eco give %player% 400"
      play-games:
        enabled: true
        type: "PLAY_GAMES"
        name: "&b&lActive Player"
        material: "COMPASS"
        description:
        - "&7Play &f8 Speed Builders games&7."
        required: 8
        rewards:
          display:
          - "&6+300 Coins"
          commands:
          - "eco give %player% 300"
      place-blocks:
        enabled: true
        type: "PLACE_BLOCKS"
        name: "&a&lBlock Placer"
        material: "STONE"
        description:
        - "&7Place &f150 blocks"
        - "&7during active building phases."
        required: 150
        rewards:
          display:
          - "&6+350 Coins"
          commands:
          - "eco give %player% 350"
  wednesday:
    enabled: true
    challenges:
      high-accuracy:
        enabled: true
        type: "REACH_PROGRESS"
        name: "&d&lAccuracy Expert"
        material: "TARGET"
        description:
        - "&7Reach at least &f95% progress"
        - "&7in &f5 different rounds&7."
        required: 5
        options:
          minimum-progress: 95.0
        rewards:
          display:
          - "&6+500 Coins"
          commands:
          - "eco give %player% 500"
      complete-builds:
        enabled: true
        type: "COMPLETE_BUILDS"
        name: "&a&lMidweek Builder"
        material: "CRAFTING_TABLE"
        description:
        - "&7Complete &f15 builds&7."
        required: 15
        rewards:
          display:
          - "&6+450 Coins"
          commands:
          - "eco give %player% 450"
      play-games:
        enabled: true
        type: "PLAY_GAMES"
        name: "&b&lKeep Playing"
        material: "DIAMOND_BOOTS"
        description:
        - "&7Play &f6 games&7."
        required: 6
        rewards:
          display:
          - "&6+300 Coins"
          commands:
          - "eco give %player% 300"
  thursday:
    enabled: true
    challenges:
      win-streak:
        enabled: true
        type: "REACH_WIN_STREAK"
        name: "&c&lOn Fire"
        material: "BLAZE_POWDER"
        description:
        - "&7Reach a win streak of &f3&7."
        required: 3
        rewards:
          display:
          - "&6+700 Coins"
          commands:
          - "eco give %player% 700"
      fastest-build:
        enabled: true
        type: "COMPLETE_BUILD_UNDER_TIME"
        name: "&b&lFast Hands"
        material: "SUGAR"
        description:
        - "&7Complete &f3 builds"
        - "&7in under &f25 seconds&7."
        required: 3
        options:
          maximum-time-milliseconds: 25000
        rewards:
          display:
          - "&6+650 Coins"
          commands:
          - "eco give %player% 650"
      perfect-builds:
        enabled: true
        type: "PERFECT_BUILDS"
        name: "&e&lPrecise Builder"
        material: "BEACON"
        description:
        - "&7Complete &f6 perfect builds&7."
        required: 6
        rewards:
          display:
          - "&6+500 Coins"
          commands:
          - "eco give %player% 500"
  friday:
    enabled: true
    challenges:
      place-blocks:
        enabled: true
        type: "PLACE_BLOCKS"
        name: "&a&lMaster Builder"
        material: "GRASS_BLOCK"
        description:
        - "&7Place &f250 blocks"
        - "&7during active games."
        required: 250
        rewards:
          display:
          - "&6+400 Coins"
          commands:
          - "eco give %player% 400"
      perfect-builds:
        enabled: true
        type: "PERFECT_BUILDS"
        name: "&e&lFriday Perfection"
        material: "BEACON"
        description:
        - "&7Complete &f8 perfect builds&7."
        required: 8
        rewards:
          display:
          - "&6+600 Coins"
          commands:
          - "eco give %player% 600"
      win-games:
        enabled: true
        type: "WIN_GAMES"
        name: "&6&lFriday Winner"
        material: "GOLD_INGOT"
        description:
        - "&7Win &f4 games&7."
        required: 4
        rewards:
          display:
          - "&6+700 Coins"
          commands:
          - "eco give %player% 700"
  saturday:
    enabled: true
    challenges:
      weekend-wins:
        enabled: true
        type: "WIN_GAMES"
        name: "&6&lWeekend Champion"
        material: "DIAMOND"
        description:
        - "&7Win &f5 games&7."
        required: 5
        rewards:
          display:
          - "&6+1000 Coins"
          - "&e+2 Vote Keys"
          commands:
          - "eco give %player% 1000"
          - "crate key give %player% vote 2"
      complete-builds:
        enabled: true
        type: "COMPLETE_BUILDS"
        name: "&a&lWeekend Builder"
        material: "BRICK"
        description:
        - "&7Complete &f25 builds&7."
        required: 25
        rewards:
          display:
          - "&6+750 Coins"
          commands:
          - "eco give %player% 750"
      high-accuracy:
        enabled: true
        type: "REACH_PROGRESS"
        name: "&d&lWeekend Accuracy"
        material: "SPYGLASS"
        description:
        - "&7Reach at least &f98% progress"
        - "&7in &f5 rounds&7."
        required: 5
        options:
          minimum-progress: 98.0
        rewards:
          display:
          - "&6+650 Coins"
          commands:
          - "eco give %player% 650"
  sunday:
    enabled: true
    challenges:
      sunday-builder:
        enabled: true
        type: "COMPLETE_BUILDS"
        name: "&b&lSunday Builder"
        material: "CRAFTING_TABLE"
        description:
        - "&7Complete &f20 builds&7."
        required: 20
        rewards:
          display:
          - "&6+750 Coins"
          commands:
          - "eco give %player% 750"
      sunday-winner:
        enabled: true
        type: "WIN_GAMES"
        name: "&6&lSunday Winner"
        material: "GOLD_BLOCK"
        description:
        - "&7Win &f4 games&7."
        required: 4
        rewards:
          display:
          - "&6+800 Coins"
          commands:
          - "eco give %player% 800"
      play-games:
        enabled: true
        type: "PLAY_GAMES"
        name: "&b&lSunday Player"
        material: "CLOCK"
        description:
        - "&7Play &f12 games&7."
        required: 12
        rewards:
          display:
          - "&6+500 Coins"
          commands:
          - "eco give %player% 500"

🎮占位符

以下占位符仅可用于 Speed Builders 文件。

%prefix% - 插件前缀
%arena% - 竞技场名称
%player% - 玩家名称
%players% - 当前玩家人数
%max% - 最大人数
%max_players% - 竞技场最大玩家数
%time% - 剩余时间
%countdown% - 倒计时
%round% - 当前回合
%schematic% - 当前建筑模板/建筑名称
%winner% - 获胜者名称
%progress% - 建造进度百分比
%state% - 竞技场状态
%bar% - 建造计时进度条（仅适用于 ActionBar）
%speedbuilders_wins% - 胜场数
%speedbuilders_losses% - 失败数
%speedbuilders_perfect_builds% - 完美建造数
%speedbuilders_win_streak% - 当前连胜
%speedbuilders_best_win_streak% - 最佳连胜
%speedbuilders_wins% - 玩家胜场数
%speedbuilders_perfect_builds% - 玩家完美建造数
%speedbuilders_best_build_time% - 玩家最佳建造时间

MVdWPlaceholderAPI 占位符

{speedbuilders_wins}
{speedbuilders_losses}
{speedbuilders_perfect_builds}
{speedbuilders_win_streak}
{speedbuilders_best_win_streak}
{speedbuilders_fastest_build}
{speedbuilders_fastest_build_milliseconds}
{speedbuilders_level}
{speedbuilders_xp}
{speedbuilders_level_xp}
{speedbuilders_needed_xp}
{speedbuilders_remaining_xp}
{speedbuilders_level_progress}
{speedbuilders_level_title}
{speedbuilders_level_prefix}

✨建筑模板系统

Speed Builders 内置建筑模板系统，管理员可直接在游戏中创建不限数量的自定义建筑挑战。每回合会随机选择一个模板，让每场比赛都有不同体验。

• 无限数量的建筑模板
• 每回合随机选择模板
• 可在游戏中创建
• 由 FAWE 提供支持

创建建筑模板

• 使用设置命令创建建筑模板：

/sb setup <arena>

• 保存的建筑模板会存放在：

plugins/SpeedBuilders/schematics/

验证建筑模板

新版建筑模板验证功能可检查已保存的模板，帮助服务器管理员快速排查问题。

/sb validateschematics

• 验证所有已保存的建筑模板。
• 检测缺失或损坏的模板。
• 检测剪贴板尺寸无效的模板。
• 通过分页 GUI 查看结果。
• 绿色表示模板有效；红色表示模板存在错误。

🎮命令

玩家命令

• /sb join <arena>：加入竞技场。
• /sb leave：离开当前竞技场。
• /sb arenas：打开竞技场选择器。
• /sb challenges：打开每日挑战 GUI。

管理员命令

• /sb create <arena>：创建新竞技场。
• /sb setup <arena>：打开竞技场设置 GUI。
• /sb holo：全息图管理命令，可用于设置、移除和更新。
• /sb validateschematics：检查所有建筑模板是否设置正确。
• /sb delete <arena>：删除竞技场。
• /sb reload：重载插件配置。
• /sb forcestart <arena>：强制开始游戏。

🎮权限

• sb.join：允许玩家加入竞技场。
• sb.leave：允许玩家离开竞技场。
• sb.arenas：允许访问竞技场选择 GUI。
• sb.admin：允许使用所有管理命令；有新版本可用时也会收到提示。
• sb.challenges：允许访问每日挑战 GUI。

✨安装

运行要求

• Minecraft 1.21+
• Spigot 或 Paper
• FastAsyncWorldEdit (FAWE)

安装步骤

• 安装 Paper 或 Spigot。
• 安装 FastAsyncWorldEdit (FAWE)。
• 将 SpeedBuilders.jar 放入 plugins 文件夹。
• 重启服务器。
• 使用设置向导创建第一个竞技场。
• 添加建筑模板。
• 开始第一场 Speed Builders 游戏。

❓常见问题

插件支持 MultiArena 吗？

支持。你可以创建并运行任意数量的竞技场。每个竞技场都有独立的配置、玩家和游戏状态。

可以创建自己的建筑吗？

可以。你可以直接在游戏中创建不限数量的自定义建筑模板，插件会在每回合随机选择。

可以一次创建多个建筑模板吗？

可以。Bulk Schematic Creator 支持在一次设置过程中保存数十甚至数百个建筑模板，让创建流程更快速、方便。

必须安装 FastAsyncWorldEdit 吗？

需要。Speed Builders 使用 FastAsyncWorldEdit (FAWE) 或 WorldEdit 高效保存和粘贴建筑模板。

插件支持 MySQL 吗？

支持。玩家数据可以保存在 stats.yml 或 MySQL 数据库中。只需在 mysql.yml 中启用 MySQL 并配置数据库凭据。

插件支持 PlaceholderAPI 吗？

支持玩家统计数据占位符，包括

• 胜场
• 失败
• 完美建造
• 当前连胜
• 最佳连胜

插件会追踪哪些玩家数据？

当前追踪的数据包括

• 胜场
• 失败
• 完美建造
• 当前连胜
• 最佳连胜

未来更新可能会加入更多统计数据。

插件支持全息图吗？

支持。插件内置可自定义的 Top 10 最佳连胜全息图。你可以在 holograms.yml 中调整每一行内容、排行榜位置、间距和格式。

可以奖励获胜玩家吗？

可以。玩家获胜时，插件可以执行自定义命令，因此可以发放金币、钥匙、权限或服务器支持的其他奖励。

支持 BungeeCord 吗？

支持。游戏结束后，可以自动将玩家传送到另一台服务器。

发布新版本后，插件会停止运行吗？

不会。插件会继续正常运行。若有新版本可用，控制台会显示通知；管理员也可以选择在加入服务器时收到游戏内通知。

可以自定义插件吗？

可以。插件的许多内容均可自定义，包括

• 消息
• 记分板
• 菜单
• 全息图
• 奖励
• 游戏设置
• 竞技场设置

支持哪些 Minecraft 版本？

Minecraft 1.21+

💡支持

需要帮助、想提出功能建议或发现了错误？欢迎随时联系作者。

• Discord：#Ludovito
• Discord 用户评价：原文提供了折叠内容，但未附具体评价。

✨感谢支持

感谢你关注 Speed Builders。如果你喜欢这款插件，请考虑留下 ★★★★★ 评价。每条评价都有助于项目发展，并推动后续更新。欢迎提供反馈和建议。

💡服务条款

下载和使用 Speed Builders，即表示你同意以下条款：

• 不得反编译、逆向工程或修改插件。
• 不得重新分发、转售、分享或上传插件到其他网站。
• 不得将本插件或其任何部分声称为自己的作品。
• 未经许可，不得在其他项目中使用插件代码或资源。
• 本插件仅可从官方 Spigot 资源页面下载。
• 开发者保留随时发布更新、修复和变更的权利。
• 本插件按“原样”提供，不附带任何保证。
• 违反上述条款可能导致支持资格和插件使用许可被取消。

© Ludovito。保留所有权利。

⭐Speed Builders

为现代 Minecraft 服务器倾力打造。

由 #Ludovito 开发。