SnowballGame - 雪球棒球

SnowballGame 是一款让你在《我的世界》中体验棒球运动的插件。它提供了球、球棒、手套等多种定制物品，以及裁判、教练等功能实体，支持投球、击球、接球等完整的棒球玩法，并可通过配置文件高度自定义球路、特效和游戏规则。

💡核心物品

球 (Ball)

一种定制的雪球，击中方块时会反弹，击中实体时会掉落为物品。

• 五种弹力类型：最高、较高、标准、较低、最低。以标准球速为 1.0 基准，击打后的速度系数分别为：1.4, 1.2, 1.0, 0.8, 0.6。
• 投掷变化球：在铁砧中为球命名（名称在 config.yml 中定义）后投出，即可投出特定球路（如滑球、曲球）。

球棒 (Bat)

一种定制的弓，无法射出箭，但可以击打球并将其打飞。

• 在生存模式下使用需要至少准备一支箭（用于拉弓动作，但不会消耗）。

手套 (Glove)

一种定制的皮革。将其放在副手时，可以“接住”飞向你的球。

✨功能实体

裁判 (Umpire)

一个高规格的本垒板。当球从其上方通过时，它会在聊天栏喊出“STRIKE”。

• 好球区的上下边界可在配置文件中设置。

教练 (Coach)

一个定制的盔甲架，可协助你进行防守练习，将球击向你。

• 练习时，对其使用 /sbg please 命令或向其扔一个球。
• 教练会从发射器中击球，球将飞向附近随机一名副手戴着手套的玩家。

球座 (Tee)

这不是定制物品，你可以利用酿造台作为击球座。

• 手持球对酿造台右键点击，即可将球实体放置其上，然后用球棒击打。

制球师 (Ballmaker)

用球左击雪人可将其转化为制球师。你可以从他脚下的雪中挖掘出球。

• 注意：只能从他脚下自然存在或生成的雪中获取球，并非他制造的所有雪都有效。

🎮命令

• /snowballgame 或 /sbg - 显示所有命令。
• /sbg reload - 重载插件配置。
• /sbg get [ball/bat/glove] <ball_type> - 获取指定物品。<ball_type> 可选：Highest, Higher, Normal, Lower, Lowest。
• /sbg please - 让附近的教练向你击球。使用此命令时你需至少持有一个球。
• /sbg sweep - 清理周围（3格内）所有漂浮的球。
• /sbg msg [on|off] - 为你启用或禁用插件广播消息（例如 Steve HITS THE BALL ）。

🔧权限

• snowballGame.* - 所有权限。
• snowballGame.config - 允许重载配置。
• snowballGame.get - 允许获取插件物品。
• snowballGame.please - 允许使用教练练习。
• snowballGame.sweep - 允许清理漂浮的球。

⭐配置摘要

配置文件主要为 config.yml 和 bounce.yml，允许深度自定义。

主要配置 (`config.yml`)

• 球 (Ball)：启用/禁用、基础名称、冷却时间、球路类型（Fast, Slider, Curve 等）及其速度、垂直/水平位移、加速度参数。
• 球棒 (Bat)：启用/禁用、基础名称、挥棒类型（UPPER, DOWN）及其飞行角度、长度、范围和力量参数。
• 手套 (Glove)：启用/禁用、基础名称、投球姿势类型（SIDE, SUBMARINE）及其垂直/水平释放点、贴近度、接球范围参数。
• 裁判 (Umpire) & 垒包 (Base)：启用/禁用、实体名称、好球区上下限。
• 教练 (Coach)：启用/禁用、名称、命令范围。
• 广播消息 (Broadcast)：各类游戏事件（挥棒、击球、接杀、三振等）的启用、广播范围及消息格式。消息支持颜色代码（如 [[RED]]）和装饰（如 [[BOLD]]），变量如 [[PLAYER]] 会被替换。
• 粒子效果 (Particle)：为接球、投球、击球、球飞行轨迹等事件配置粒子效果。可参考 Spigot API 文档设置粒子类型。

方块反弹配置 (`bounce.yml`)

定义球击中不同方块时的物理行为。

• 类型：

- `Dampening`：软方块，显著吸收冲击并减少反弹（如铁栏杆、藤蔓）。

- `Flat`：薄方块，水平放置时总是计算为击中顶面（如各种地毯、压力板、雪）。

- `Passthrough`：球可穿透的方块（如各种花、草丛、火把、蜘蛛网）。需谨慎使用，可能导致意外行为。

• 每个类型可设置 Repulsion（反弹系数，0为无反弹）和 AlwaysTop 等属性。

自定义球路与粒子示例

配置文件的 Move: 部分允许你添加自定义球路（如 Changeup 变速球）。只需在 Type: 列表中添加新名称，并在下方定义其 Velocity, Vertical, Horizontal, Acceleration 等参数。

若想为特定球路添加专属粒子效果（如火焰球），需同时满足：

• 在 Particle: 部分启用 MovingBall: Enabled: true。
• 在该球路的参数区块中添加 Particle: 字段（例如 Particle: FLAME）。

❓视频与合成表

• 教程视频：请查看插件发布页。
• 物品合成配方：请查看插件发布页。