Throw Preview

Draws the arc of what you are about to throw. For grenades, hold the grenade key to aim with a dashed arc and a marker where it will explode, then release to throw. For held objects (a downed teammate's parts, barrels, rocks and so on), the arc and landing point show while you charge the throw.

Features

• Grenades: hold to aim, release to throw. The game normally throws the moment you press the key. With this mod, holding the key shows the arc; releasing it throws. A quick tap still throws almost at once.
• The arc uses the game's own projectile step, so gravity, bounces off walls and range match the real grenade. A marker shows where it will go off.
• The throw itself (and the throw animation other players see) is the game's own, started when you release the key.
• Held objects: while you charge a throw, the arc and landing point follow the charge.
• Revive hint (experimental): when a thrown teammate part would join another of that teammate's parts (which revives them), the arc turns green and stops where they would connect. It follows the game's own rule (part centres closer than 2 m), but has not yet been checked during a real revive.
• Dashed line with adjustable colour, thickness and dash length.

Requirements

• BepInExPack_Mycopunk
• Macaron Core (installed automatically as a dependency)

Settings

The config file is BepInEx/config/t4t5u0.mycopunk.throwpreview.cfg. Settings marked * can also be changed in game under Settings → MODS (the MODS tab is provided by Macaron Core) and take effect at once. For colours, the MODS tab picks the hue; the opacity stays as in the config.

Multiplayer

Client-side only. The arc is drawn only on your screen, and the throw is the game's own, so other players don't need the mod.

Notes

• Random spread is not included in the arc.
• Where a grenade leaves your hand is only known after it has been thrown once, so the first throw of a grenade type you have never thrown uses an estimated hand position and can be slightly off. After that, the position is remembered per grenade type in BepInEx/ThrowPreview/fire-offsets.tsv, also across launches.
• When an upgrade gives the grenade key its own hold action, the grenade keeps the game's behaviour (throw on press).
• The aim can jump when what's under your crosshair switches between near and far. The real throw does the same, so the arc follows it.
• The Photon Disc has a wavy look in flight; the arc shows its actual path, so the two can look different.

Source: https://github.com/doku-macaron/mycopunk-mods-public Author: t4t5u0 Not affiliated with Pigeons at Play or Devolver Digital.

Changelog

0.3.0

• The arc is drawn in the world (3D) instead of on the HUD.
• Thickness, DashLength and GapLength are now in world units (Thickness: 1 = 0.01 m; DashLength and GapLength: 1 = 0.05 m).
• The arc starts from where the camera is drawn this frame, and held objects (teammate parts, barrels, rocks) use the drawn camera direction, so the arc lines up better while moving.
• If grenade aiming cannot hook every method it needs, it hooks none and grenades are thrown normally.
• Code follows the Mycopunk modding wiki conventions (publicized game assembly, [HarmonyPatch] classes, no reflection by name).
• Needs doku_macaron-MacaronCore 1.1.0.

0.2.1

• Depends on doku_macaron-MacaronCore (the renamed shared library) instead of doku_macaron-ModKit. No other change in game.
• README: the teammate-part revive colour is marked experimental (not yet checked in a real revive).

0.2.0

• First release on Thunderstore.