CrackShotAdditions - 增强扩展

CrackShotAdditions 为 CrackShot 和 CrackShotPlus 提供了多种增强功能，包括更真实的射击效果、弹道伪装、动态伤害计算等，极大地丰富了枪械模组的可玩性与视觉效果。

💡核心功能

• 强力缩放：为武器应用类似 Zoom++ 的强力缩放效果。（兼容 CrackShotPlus 的二级缩放与配件系统）
• 射击火光：当玩家使用配置的武器开火时，可产生临时光源以增强真实感。（需要 LightAPI）（兼容 CrackShotPlus 的配件）
• 敌对生物吸引：使射击玩家周围一定半径内的敌对生物主动攻击该玩家。（兼容 CrackShotPlus 的配件）
• 距离伤害倍率：根据弹丸飞行的距离，按比例增加或减少武器造成的伤害。（兼容 CrackShotPlus 的配件）
• 弹丸伪装：将一种弹丸实体伪装成另一种。例如，让武器射出能穿过高草的箭，但在玩家看来却是雪球。（需要 ProtocolLib）（兼容 CrackShotPlus 的配件）
• 给予命令：给予指定玩家一把 CrackShot(Plus) 武器或弹药，物品将带有“无法破坏”标签以隐藏耐久度，并隐藏其他属性信息（如攻击速度/伤害等）。
• 隐藏名称标签：用于隐藏玩家的名称标签。（可能与某些影响记分板的插件不兼容）
• 自定义音效：为配置的武器或其事件配置自定义资源包音效。目前可用于以下事件：

- `custom-sounds-out-of-ammo`（可替换 CrackShot 的 `Sounds_Out_Of_Ammo`）

- `custom-sounds-shoot-with-no-ammo`（可替换 CrackShot 的 `Sounds_Shoot_With_No_Ammo`）

- （兼容 CrackShotPlus 的配件）

🎮PlaceholderAPI 集成

支持以下占位符

• %crackshotadditons_max-range%
• %crackshotadditions_max-range-damage%

🔧配置指南

配置文件结构如下，所有 (Optional) 标记的条目均为可选配置。

# 全局光照冷却时间（毫秒），例如 500
light-cooldown: <cooldown in ms>
# 是否全局隐藏名称标签
hide-nametags: <true/false>
# 名称标签隐藏的世界黑名单
hide-nametags-world-blacklist:
  - "<world name>"

modifications:
  # 武器或配件的ID
  <weapon/attachment id>:
    # 类型：WEAPON 或 ATTACHMENT（ATTACHMENT 需要 CrackShotPlus）
    type: <type>
    
    # 弹丸伪装设置（可选）
    disguised-projectile:
      enabled: <true/false>
      entity-type: <type>
    
    # 射击火光设置（可选）
    light-on-fire:
      enabled: <true/false>
      light-level: <light level> # 光照等级，例如 12
      offset: # 光源偏移位置
        x: <x offset>
        y: <y offset>
        z: <z offset>
      multiplier: <multiplier>
      remove-delay: <delay in ticks> # 延迟（刻），例如 20
    
    # 敌对生物吸引设置（可选）
    hostile-mob-attraction:
      enabled: <true/false>
      range: <range in blocks> # 范围（格），例如 30
      blacklist: # 生物类型黑名单
        - "<mob type>"
    
    # 距离伤害倍率设置（可选）
    range-damage-multiplier:
      1: # 可配置多个距离段
        range: <range in blocks>
        multiplier: <damage multiplier> # 伤害倍率，例如 0.9
        value: <damage value> # 伤害值，例如 1.5
    
    # 强力缩放设置（可选）
    strong-zoom:
      enabled: <true/false>
      type: <type> # FIRST 或 SECOND（SECOND 需要 CrackShotPlus）
    
    # 自定义“弹药耗尽”音效（可选）
    custom-sounds-out-of-ammo:
      1: # 可配置多个音效
        sound-name: "<sound name>"
        volume: <volume>
        pitch: <pitch>
    
    # 自定义“无弹药射击”音效（可选）
    custom-sounds-shoot-with-no-ammo:
      1:
        sound-name: "<sound name>"
        volume: <volume>
        pitch: <pitch>

❓命令与权限

命令列表

• /csa reload

- **权限**：`csa.reload`

- **描述**：重载插件配置。

• /csa give <player> <weapon>

- **权限**：`csa.give`

- **描述**：给予指定玩家一把特定武器（附带无法破坏标签和隐藏属性）。

• /csa giveAmmo <player> <weapon> <amount>

- **权限**：`csa.giveAmmo`

- **描述**：给予指定玩家特定武器的弹药（附带无法破坏标签和隐藏属性）。

✨社区与支持

• Discord 服务器：https://discord.gg/ATm66qs
• 您可在此获取支持、提出建议、查看更新日志与计划中的改动。