Grenade Trajectory Renderer

## 投掷物轨迹计算模组 --- ### 📦 模组简介 **纯客户端辅助模组** —— 在手持投掷物按住右键「掐雷」时，实时绘制一条抛物线轨迹，并清晰标注落点、反弹位置与距离，让你像专业游戏一样精准预判每一颗雷的弹道。 支持 **LR Tactical** 与 **SBW（Superb Warfare）** 两大模组的投掷物，并额外为 SBW 手雷显示 **温雷倒计时**。 --- ### ✨ 功能一览 - **抛物线轨迹**：掐雷时实时绘制飞行弧线，随视角与地形动态更新 - **落点标记**：轨迹终点显示落点圆圈，并标注距离（方块数） - **反弹标记**：轨迹撞墙/撞地/撞生物时显示反弹点小球标记 - **空爆标记**：可温雷手雷在空中爆炸时，显示红色爆炸图标 - **SBW 温雷倒计时**：掐 SBW 手雷时屏幕下方显示倒计时，少于 2 秒变红闪烁 --- ### 🎮 玩法说明 #### 基本操作 - 手持投掷物（手雷/闪光弹/烟雾弹等），按住右键即可看到轨迹 - 轨迹随瞄准方向与地形实时刷新 - 松开右键或取消投掷后，轨迹立即消失 #### 蹲下投掷 按住 Shift 下蹲时，投掷速度变慢，轨迹弧线相应缩短。 #### 可烹饪手雷 - 掐雷时间越长，剩余引信越短，轨迹随之逐格缩短 - 若引信在落地前耗尽，红色空爆图标将标示空中爆炸点 #### 反弹预判 轨迹真实模拟撞墙/撞地/撞生物的反弹（含每跳衰减），可用于卡墙角雷、撞墙弹跳等战术操作。 #### SBW 投掷物 - 现支持 `rgo_grenade`、`hand_grenade`、`m18_smoke_grenade` - 掐雷时显示温雷倒计时，归零时手雷将在手中引爆，轨迹与倒计时一同消失 #### 仅本地显示 所有轨迹与标记仅你可见，不影响服务器，也不被队友/对手察觉。 --- ### ⚙️ 配置文件说明 配置文件位于：`config/lr_trajectory_renderer_1785978259-client.toml` 可调整项包括： - 轨迹颜色、透明度 - 线条/点状样式、粗细 - 落点与反弹标记开关 - 各类物理倍率 - 整体上下/左右偏移 **修改保存即热加载生效。** 建议同时下载附属文件中的配置文件，以达到最佳拟合效果。 --- ### ⚠️ 注意事项 - **纯视觉预判，非精准物理**：轨迹按当前视角与地形实时计算，实际飞行可能因服务器延迟、目标移动等出现微小偏差(约1-2像素)，请留出余量 - **计算上限**：默认最多模拟 **200 格距离**、最多 **5 次反弹**，超出部分自然截断（截断处显示落点标记） - **可隐藏部分投掷物轨迹**：在配置文件的 `lr.blacklist.entries` 中设置，命中条件的投掷物将完全不显示轨迹 - 示例：`"lrtactical:throwable{ThrowableId:\"lrtactical:flash_grenade\"}"` 表示该闪光弹不渲染 - 也可只写物品 ID（不带 `{}`）使该物品所有投掷物不渲染 - 一条规则内的 NBT 键值必须全部匹配才生效，条目写错仅使该规则失效，不影响整体 - **SBW 投掷物走独立通道**：SBW 物品在配置 ID 列表内时走独立显示逻辑（固定基准物理参数 + 可调倍率），与 LR 互不干扰，不参与 LR 黑名单 - **贴墙/匍匐**：若出手点在方块内部（如贴墙蹲着），轨迹起点会自动沿视线前移，避免被挡住 --- **让每一颗雷，都投得明明白白。** --- # Grenade Trajectory Renderer --- ### 📦 Mod Overview **A pure client-side utility mod** — while holding a throwable and right-clicking to "cook" it, a parabolic trajectory is drawn in real-time, clearly marking the landing point, bounce positions, and distance. Aim every grenade with professional precision. Supports throwables from **LR Tactical** and **SBW (Superb Warfare)**, with an extra **cook timer** displayed for SBW grenades. --- ### ✨ Features - **Parabolic trajectory** — real-time arc while cooking, updating with your aim and terrain - **Landing marker** — circle at the end of the trajectory, with distance displayed (in blocks) - **Bounce markers** — small spheres shown where the trajectory ricochets off walls, ground, or entities - **Airburst marker** — red explosion icon shown when a cooked grenade detonates mid-air - **SBW cook timer** — countdown displayed below crosshair for SBW grenades, turns red and flashes below 2 seconds --- ### 🎮 How to Use #### Basic Operation - Hold any LR Tactical throwable (grenade/flashbang/smoke, etc.) with right-click to see the trajectory - Trajectory updates dynamically with aim direction and terrain - Release right-click or cancel throw — trajectory disappears immediately #### Crouch Throw Hold Shift to crouch — throwing speed decreases, and the trajectory shortens accordingly. Aim using the shortened arc. #### Cookable Grenades - The longer you cook, the shorter the fuse — the trajectory shortens in real-time - If the fuse runs out before landing, a red airburst icon marks the explosion point #### Bounce Prediction Trajectories simulate ricochets off walls, ground, and entities (with bounce decay) — great for bank shots and ceiling bounces. #### SBW Throwables - Supports `rgo_grenade`, `hand_grenade`, `m18_smoke_grenade` - Cook timer displayed while holding; if timer reaches zero, the grenade detonates in hand — trajectory and timer disappear together #### Local-Only Display All trajectories and markers are **visible only to you** — they don't affect the server and are invisible to teammates or opponents. --- ### ⚙️ Configuration Config file location: `config/lr_trajectory_renderer_1785978259-client.toml` Adjustable settings include: - Trajectory color and opacity - Line/dot style and thickness - Landing & bounce marker toggles - Physics multipliers - Vertical/horizontal offset **Changes take effect immediately via hot-loading.** It is recommended to also download the config file from the companion resource pack for optimal fit. --- ### ⚠️ Important Notes - **Visual prediction only — not perfect physics**: Trajectory is calculated based on current aim and terrain. Actual flight may deviate due to server latency or moving targets — always leave some margin - **Calculation limits**: Default simulation is capped at **200 blocks distance** and **5 bounces** — trajectory cuts off naturally beyond that (landing marker still shown at cutoff point) - **Can hide specific throwables**: Add entries to `lr.blacklist.entries` in the config file to block trajectory rendering for specific items - Example: `"lrtactical:throwable{ThrowableId:\"lrtactical:flash_grenade\"}"` disables only that specific flashbang - You can also use just the item ID (without `{}`) to disable all throwables of that item - All NBT key-value pairs in a rule must match for it to apply — a malformed entry only breaks that rule, not the entire mod - **SBW uses separate logic**: SBW items follow independent display rules (fixed base physics + adjustable multipliers) when their IDs are listed in the config — they are not affected by the LR blacklist - **Wall/Prone handling**: If the throw origin is inside a block (e.g., crouching against a wall), the trajectory start point shifts forward along your line of sight to avoid self-blocking --- **Every throw counts.**