GunPlugin 5.0.0 更新日志 / Release Notes

发布日期 / Release date： 2026-05-11

---

1. 多语言支持 / Multi-Language Support

中文

• 扩充语言资源文件（messages/*.yml）：商店、配件、命令提示、物品 Lore、调试与日志字符串等与模板键对齐。
• 多套语种并行维护（含简体 / 英文 / 日文 / 韩文 / 繁体中文等）；缺失键回退默认语言。
• 统一射速等单位在各语言下的表述（如 RPM）。

English

• Expanded locale packs (messages/*.yml): shop, attachments, commands, item lore, debug/log strings aligned with keys.
• Multiple locales shipped (e.g. zh_CN, en_US, ja_JP, ko_KR, zh_TW); missing keys fall back to default.
• Consistent fire-rate labeling (e.g. RPM) across languages.

---

2. 配置文件大改与自定义枪械 / Configuration Overhaul & Custom Guns

中文

• guns.yml：枪械完全由数据驱动（伤害、rate（RPM）、弹匣、换弹、sounds、recoil、behavior/category 等），新增枪械仅需添加条目并重载。
• config.yml：default_guns 按枪械 ID 覆盖部分字段；购买与经济选项集中于配置。
• guns.yml 文件头提供中英文配置说明与必填项列表。

English

• guns.yml: Fully data-driven guns (damage, RPM rate, magazine, reload, sounds, recoil, behavior/category, etc.); add entries and reload.
• config.yml: Per-gun overrides via default_guns.<id>; economy/buy settings in config.
• Bilingual header docs in guns.yml for required keys and sections.

---

3. 后坐力调整 / Recoil Tuning

中文

• recoil：normal 参数式与 pattern 点列式；points 为按发序循环的 [水平, 垂直]。
• 区分 movement_spread（移动散布）与 recoil 内 horizontal_spread / vertical_spread（后坐视角散布）。

English

• recoil: normal vs pattern; points are cyclic [h, v] pairs per shot.
• Clear separation between movement_spread and recoil spread fields.

---

4. 持枪移速 / Hold Move Speed

中文

• 持枪减速改为 直接调整行走速度（setWalkSpeed），以进入持枪前速度为基准按倍率计算；开镜、射击/换弹惩罚为额外乘数，不再使用缓慢药水。
• guns.yml 新增 hold_move_speed（可选，默认 0.88，取值 (0,1]）；机枪 negev 示例为 0.62（移动更慢）。

English

• Gun-hold slowdown uses Player#setWalkSpeed from a baseline captured before aiming; scoped / shoot-reload penalties multiply it—no Slowness potions.
• guns.yml adds hold_move_speed (optional, default 0.88, range (0,1]); sample LMG negev uses 0.62.

---

5. 修复已知问题 / Bug Fixes & Improvements

中文

• 全自动射速：按 RPM 使用固定 tick 周期连发并首发即时射击，缓解实际射速低于配置的问题。
• default_guns.fire_rate：合并进枪械解析，与 Lore 与实战一致。
• 文案：修正部分语言下 Lore 将 RPM 显示为「秒」等问题。

English

• Full-auto cadence: Tick-based scheduling from RPM plus immediate first shot; reduces undershoot vs configured RPM.
• default_guns.fire_rate: Applied in resolved gun stats (matches lore and gameplay).
• UI copy: Fixed RPM vs seconds in some locales.

---