ProjectileTweaks

ProjectileTweaks

A lightweight gameplay mod that lets you customize how firing projectiles works. Allows customization of bows, crossbows, and staffs. Uses Jotunn to sync configurations if the mod is installed on the server.

Server-Side Info: This mod works as a purely client side mod but can optionally be installed on the server to enforce custom configuration settings.

Version 1.6.0 Update Notice!

Configuration settings have changed somewhat in this version. If you experience issues please delete your config file and let the mod regenerate it.

Description

ProjectileTweaks is intended to be a lightweight and open-source mod that provides an alternative to BetterArchery and BowPlugin. Some of ProjectileTweaks features also overlap with MagicPlugin but the two are fully compatible so you can still enjoy the extra features from MagicPlugin.

Tweaks are applied separately for bows, crossbows, spears, and staffs.

Bows, Crossbows, & Spears

For bows, crossbows, and Spears you can customize:

• Spread of the projectiles (this is referred to as accuracy in BowPlugin)
• Velocity of projectiles
• Launch angle of arrows and bolts
• Position that projectiles spawn relative to the player when they are fired by changing the horizontal and vertical offsets

The default configuration adjusts bows and spears to launch projectiles at the same angle as crossbows. The spawn locations of arrows and spears are also tweaked to improve the alignment of arrow trajectory with the aiming crosshairs, so that arrows and spears fired with zero spread launch in alignment with the crosshair rather than being slightly offset towards the players left side.

Staffs

For staffs you can customize:

• Spread of projectiles
• Velocity of projectiles
• Position that projectiles spawn relative to the player when they are fired by changing the horizontal and vertical offsets

The default configuration adjusts the spawn position of projectiles fired from staffs so that if spread is set to zero the projectile is aligned with the aiming crosshair.

Ammo Counter

This mod adds an ammo counter to weapon icons in the hotkey bar and allows you to customize the appearance of the counter.

Configuration

A config file BepInEx/config/Searica.Valheim.ProjectileTweaks.cfg is created after running the game once with this mod. You can adjust the config values by editing this file using a text editor or in-game using the Configuration Manager. The mod has a built-in file watcher so either method will work and changes will be reflected in-game as you change the settings.

<table> <tbody> <tr> <th align="center">Setting</th> <th align="center">Server Sync</th> <th align="center">Description</th> </tr> <tr> <td align="center">Draw Speed Multiplier</td> <td align="center">Yes</td> <td align="left"> Multiplier for draw speed of bows. Set to 2 to draw twice as fast. Does not affect Vanilla scaling with skill level.

• Acceptable values: (0.5, 2)
• Default value: 1

</td> </tr> <tr> <td align="center">Spread Multiplier</td> <td align="center">Yes</td> <td align="left"> Multiplies the min and max projectile spread, so if you set it to zero your arrows will have zero spread.

• Acceptable values: (0, 2)
• Default value: 1

</td> </tr> <tr> <td align="center">Velocity Multiplier</td> <td align="center">Yes</td> <td align="left"> Multiplies velocity of arrows.

• Acceptable values: (0.1, 2)
• Default value: 1

</td> </tr> <tr> <td align="center">Launch Angle</td> <td align="center">Yes</td> <td align="left"> Changes the launch angle for arrows. Vanilla default for bows is 0. Negative values angle upwards, and positive values angle downwards.

• Acceptable values: (-5, 5)
• Default value: -1

</td> </tr> <tr> <td align="center">Horizontal Offset</td> <td align="center">Yes</td> <td align="left"> Offsets the location that arrows are launched from when firing them. Positive shifts it to your characters right. Negative shifts it to your characters left.

• Acceptable values: (-0.75, 0.75)
• Default value: 0.2

</td> </tr> <tr> <td align="center">Vertical Offset</td> <td align="center">Yes</td> <td align="left"> Offsets the location that arrows are launched from when firing them. Positive shifts it upwards. Negative shifts it downwards.

• Acceptable values: (-0.75, 0.75)
• Default value: 0.2

</td> </tr> <tr> <td align="center">Depth Offset</td> <td align="center">Yes</td> <td align="left"> Offsets the location that projectiles are launched from when firing them. Positive shifts it away from your character. Negative shifts it towards your character.

• Acceptable values: (-0.75, 0.75)