Mods / Bullseye

Category: #Tweak #Weapons
Author: TeacupAngel
Side: Both
Created: Sep 6th 2021 at 6:58 PM
Last modified: May 14th at 12:49 PM
Downloads: 6297
Follow Unfollow 55

-= NOTE: Due to a game bug, compatibility with other mods is partly broken unless you use this mod: CompatibilityFix. =-
-= I highly recommend it if you play with Weapons Pack Gamma, AnMiTech, or compatible mods that add extra arrows (Primitive Tools, Lichen, Ore Crystals) =-

Latest release - 2.3.2 (14-05-2022)

As requested, this branch brings compatibility with WeaponPack Gamma, AnMiTech, and Primitive Tools. More bows and arrows for everyone! Be aware that Bullseye tries to respect balance changes in these mods however, so especially in the case of WeaponPack Gamma, you end up with bows vastly more powerful than vanilla or pretty much any mod out there expects.

This is where the second change may come in handy: new server commands to change the damage of arrows, spears, and slings, either separately or all together! Type /bullseye set arrowDamage 0.5 to cut arrow damage to half, as an example. For the rest of the commands, see the full changelog below!


  • New server commands:
    • `/bullseye set arrowDamage 0-1000` - set a multiplier to arrow damage
    • `/bullseye set spearDamage 0-1000` - set a multiplier to spear damage
    • `/bullseye set slingDamage 0-1000` - set a multiplier to sling damage
    • `/bullseye set allDamage 0-1000` - set the arrowDamage, spearDamage, and slingDamage multipliers in one command
  • Added mod compatibility for Primitive Tools, AnMiTech, and WeaponPack Gamma
  • Fixed vanilla break chance appearing 100 times too low in arrow description
  • Weapon ammo type now exposed in json instead of being hardcoded
  • Added mod icon
  • Minor code improvements
Last major release - 2.3.0 (01-05-2022)

Most importantly among the new changes, the sling has got the Bullseye treatment! It behaves in a very different way from the bows you are used to, and you'll have to deal with its upwards swinging motion to use it. Like other Bullseye weapons, it is also slower but deals greater damage than in vanilla.

Next is movement mechanics and a rebalance for the longbow and recurve bow. It's no longer possible to spring when aiming a bow, and even just walking is much slower. The mod now also recognises when you are mounted on an entity (such as a horse, Vies' airship, a rowboat, and so on) and adjusts your accuracy appropriately. The longbow and recurve bow now also switched places, balance wise - the new longbow is an infantry sniper bow, slow but with a massive +60% damage bonus - strong enough that Hunters with good enough arrows can one-shot surface drifters! The recurve bow is its opposite, dealing less damage but shooting faster and emphasising mobility over damage and range, with much lower movement penalties than any other ranged weapon. It also makes an excellent cavalry bow, much like it did in history - get yourself a horse mod and emulate your favourite horse archers of the past!

Speaking of bows, new smooth first-person animations for bows have been added! These currently work only in first person. In addition, the arrow you are shooting is now physically represented in the bow model too. This may come in handy, because:

You can now press F to pick the ammunition to shoot. This works with all bows and the sling, and displays a small window listing all the kinds of ammunition you currently carry, and even helpfully writes out how much total damage each projectile deals after weapon and class bonuses.

Other smaller changes and bug fixes can be found below. Enjoy!


Full changelog:

  • New Features
  • Basic sling implementation with smoother animation
  • Fully animated bows in first person view
  • Bows show the arrow you are shooting
  • Ability to choose ammo type for bows and slings (press F to select)
  • Support for shooting while mounted on an entity (horse, Vies airship, etc.)
  • Rebalance
  • Spears have slightly higher running aim penalty
  • Spears have less vertical aim sway, to make judging throw distance easier
  • Spears no longer have any random spread
  • Slightly reduced aim sway for simple and crude bows
  • Increased longbow damage bonus to +60%
  • Increased longbow movement accuracy penalty to 130%
  • Reduced recurve bow damage bonus to +35%, but made it charge slightly faster (still has the best sustained damage of all bows)
  • Reduced recurve bow movement accuracy penalty to 50%
  • Reduced aim sway of recurve bow
  • Can no longer sprint when aiming a bow
  • Walking when aiming is now slower (slowest with longbow, fastest with recurve bow)
  • Other
  • Better compatibility with Lichen
  • Now also compatible with Ore Crystals, Useful Stuff, Feverstone Horses, and ViesCraft Machines
  • "globalAccuracy" setting renamed to "aimDifficulty" ("globalAccuracy" is still recognised, too)
  • Major code refactor
  • Fix: less intrusive patching of arrow and spear damage
  • Fix: now respects armour ranged penalties properly
  • Fix: texture leak related to crosshairs
  • Fix: removed old world migration from version 2.1.0 popping up even in worlds that never used the mod
  • Fix: no longer try to pointlessly patch items, blocks and entities on the client


Hello and welcome to Bullseye! This mod is aiming to overhaul and rebalance ranged weapons in a vanilla-friendly way.

  • A new aiming system, relying on player input rather than randomness
  • A specific role and handling for each bow
  • Obsidian and bamboo arrows, iron and steel spears, spear head clay molds
  • Broad rebalance - higher damage for spears and arrows, decreased arrow break chance, spear durability higher in melee and lower when throwing, and more
  • Other minor features (throw your spears with a running start to make them go farther!)

For a more thorough guide through the changes, be sure to check out the wiki!

All feedback is greatly appreciated and helps improve the mod. Let me know in a Github issue or in this Vintage Story forums thread!

Compatibility with other mods

Lichen: COMPATIBLE - since Bullseye v. 2.2.4
MoreMetals: COMPATIBLE - since MoreMetals v1.0.9
Ore Crystals: COMPATIBLE - since Bullseye v. 2.3.0
Useful Stuff: COMPATIBLE - since Bullseye v. 2.3.0
Feverstone Horses: COMPATIBLE - since Bullseye v. 2.3.0
ViesCraft Machines: COMPATIBLE - since Bullseye v. 2.3.0
Primitive Tools: COMPATIBLE - since Bullseye v. 2.3.2
AnMiTech: COMPATIBLE - since Bullseye v. 2.3.2
WeaponPack Gamma: COMPATIBLE - since Bullseye v. 2.3.2

XSkills: PARTIALLY COMPATIBLE - Sniper skill works, Archer and Spearman skills do not.

Ranged Weapons: NOT COMPATIBLE - changes weapon code too much to work with Bullseye


Licensed under the MIT No Attribution License.
MIT No Attribution
MIT No Attribution

Copyright (c) 2021-2022 Rahjital

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.

The intent of this license is to allow Vintage Story developers to take this mod apart and use it in development of Vintage Story, should they so desire, and to let any interested mod developers maintain the mod in case of my disappearance.


Version For Game version Downloads Release date Changelog Download
v2.3.2 974 May 14th at 12:49 PM Show Bullseye
v2.3.1 288 May 7th at 9:13 AM Show Bullseye
v2.3.0 210 May 1st at 6:54 PM Show Bullseye
v2.2.4 2481 Jan 6th at 11:14 PM Show Bullseye
v2.2.3 231 Dec 15th 2021 at 7:14 PM Show Bullseye 2.2.3
v2.2.2 764 Oct 21st 2021 at 1:56 PM Show Bullseye
v2.2.1 270 Oct 13th 2021 at 10:01 PM Show Bullseye
v2.2.0 231 Oct 8th 2021 at 4:12 PM Show Bullseye
v2.1.1 313 Sep 22nd 2021 at 4:47 PM Show Bullseye
v2.1.0 204 Sep 20th 2021 at 10:56 AM Show
v2.0.0 330 Sep 10th 2021 at 11:53 AM Show

28 Comments (oldest first | newest first)

micko0o, Jun 18th at 4:22 AM

I am having a bug where when i try thow a spear it gets stuck in the air and I cannot pick it back up? I dont have any other weapon mods on

ManaWei, May 25th at 7:42 PM

Absolutely love this mod !! <3 

TeacupAngel, May 18th at 1:35 PM

PSA, part 2 - I just released a mod to fix the compatibility issue below: With it installed, I believe compatibility with Weapons Pack Gamma, AnMiTech, and others should now work fine! :)

TeacupAngel, May 17th at 8:09 AM

PSA - because of a game bug (, compatibility with other mods doesn't always work. This is true for all mods Bullseye has compatibility with, but Weapons Pack Gamma is affected the most. In singleplayer, you can make the problem go away by exiting your world and loading it again. Sadly for servers, I don't know of a way to do that.

I'm looking into ways of solving this issue. Thank you for your patience <3

ThePionier, May 14th at 1:13 PM


Many thanks for your effort! And the patch! Rahjital

TeacupAngel, May 14th at 12:54 PM

Bullseye 2.3.2 just released, with more mod compatibility and customisation through server commands! See the full changelog for more.

ThePionier You might be interested in this! :)

ThePionier, May 7th at 10:43 PM


Thank you for the time you sacrifice for it! And of course thanks for your answer :)

I'll just wait as long as it takes ;)

TeacupAngel, May 7th at 10:25 PM


I'm actually working on it right now! Unfortunately the Gamma Pack changes pretty much every single thing relating to bows, and does it in a way that's quite unfriendly to other mods (it also breaks mods like Lichen or Ore Crystals, and those just try to add one arrow each!). So I have some work cut out for me there :)

I took a look at AnMiTech, and fortunately it looks like it should be a lot easier to create compatibility for. I'm hoping that if everything goes well, I might have a patch out in the next few days :)

ThePionier, May 7th at 10:51 AM

Hello Rahjital!
Is there any news when there might be a compatibility patch for the Gamma Weapon pack? I would love to use the mod on my server, the AnMiTech mod is also used, which also adds javelins and spears.

TeacupAngel, May 7th at 9:23 AM

Bullseye 2.3.1 is out now with a multiplayer crash fix!

TeacupAngel, Apr 17th at 8:57 AM


Haven't seen your comment, it definitely didn't get posted neither here nor on the forums. If by poison you mean poisoned arrows from the Ranged Weapons mod, then yes, that mod is unfortunately not compatible with Bullseye and will not work alongside it.

FireFrost, Apr 15th at 11:38 AM

Sorry it was ranged weapons - Idk why I posted here lol - it was throwing an error with poison on arrow release - when not using poison . - I took that out and added your mod sorry for the mix up , no wonder I couldnt see the post . lol sorry  my bad

TeacupAngel, Feb 24th at 7:16 PM

For anyone playing Bullseye with VS 1.16.4-rc.3 and wondering about the arrow break chance percentage not seeming right, especially for obsidian arrows - those are not accurate when playing with Bullseye! The mod calculates the chance differently, and the vanilla value is unused.

This is already fixed in the next release of Bullseye, which should hopefully come soon!

TeacupAngel, Jan 11th at 9:10 PM

Just a reminder, Bullseye v. 2.2.4 is out and working with VS 1.16.0! If drifters deserve a ranged upgrade, so do you!

TeacupAngel, Dec 20th 2021 at 12:27 PM


The pre-release version is not compatible with 1.15, but other than compatibility there were no changes at all. You can keep using Bullseye version 2.2.2 (the last 1.15 release) without missing out on any features :)

Travisplo, Dec 20th 2021 at 10:56 AM

So, any idea if the new pre-release version will be backwards compatible with 1.15 versions still?

Abed, Oct 31st 2021 at 4:51 PM

Rahjital Thanks for the tip. 👍

TeacupAngel, Oct 30th 2021 at 9:41 AM


That's more of a vanilla game question, but yes, there is! If you place a hand basket or any other bag on the ground, bowstaves will dry in it just fine. You can place bags from your inventory the same way you place a skep with bees inside.

Abed, Oct 28th 2021 at 11:29 AM

Is there a way to dry bowstaves without having to carry them in the inventory for days and days at a time? They're not drying out in boxes.

TeacupAngel, Oct 21st 2021 at 2:04 PM

SingABrightSong Thanks for the report! I just released Bullseye 2.2.2 to fix that bug. :)

SingABrightSong, Oct 21st 2021 at 4:43 AM

Hey, there appears to be a bug where a player will crash to the main menu if they're killed while holding a readied spear. 

TeacupAngel, Oct 13th 2021 at 10:11 PM

Oh that is a strange crash WickedSchnitzel, it seems related to a spear breaking during a throw, but that's never been an issue in testing and I can't see why it would happen yet. Could be a conflict with another mod? Either way, Bullseye 2.2.1 is now released, and should hopefully stop this crash from happening again. Apologies for the inconvenience again!

WickedSchnitzel, Oct 12th 2021 at 7:56 PM

12.10.2021 20:58:59 [Error] System.NullReferenceException: Object reference not set to an instance of an object.
at Bullseye.ItemSpear.GetProjectileDamage(EntityAgent byEntity, ItemSlot weaponSlot)
at Bullseye.ItemRangedWeapon.Shoot(ItemSlot slot, EntityAgent byEntity, Vec3d targetVec)
at Bullseye.ItemRangedWeapon.ServerHandleFire(String eventName, EnumHandling& handling, IAttribute data)
at Vintagestory.Server.ServerEventAPI.PushEvent(String eventName, IAttribute data)
at Vintagestory.Server.NetworkAPI.HandleCustomPacket(_pZfqca2BJhMktch0CcWjLhsEFXc packet, ConnectedClient client)
at Vintagestory.Server.ServerMain.ProcessNetMessage(NetIncomingMessage msg, NetServer mainSocket)


TeacupAngel, Oct 8th 2021 at 4:28 PM

Bullseye v. 2.2.0 just released! This brings several quality-of-life improvements, a config setting to adjust aiming difficulty, and an important bugfix; you can find the full change long in the files section as usual.


WickedSchnitzel I believe this patch should fix the issue that crashed your server. Sorry for the inconvenience!

TeacupAngel, Oct 8th 2021 at 8:17 AM

WickedSchnitzel Apologies for the crash, and thank you very much for the report! It was really helpful. I'll try to release a fix tonight :)

WickedSchnitzel, Oct 7th 2021 at 7:38 PM

21:33:56 [Server Fatal] System.NullReferenceException: Object reference not set to an instance of an object.

at Bullseye.ItemBow.OnShotCancelled(ItemSlot slot, EntityAgent byEntity)

at Bullseye.ItemRangedWeapon.<>c__DisplayClass21_0.b__0(Single ms)

at Vintagestory.Common.EventManager.TriggerGameTick(Int64 ellapsedMilliseconds, IWorldAccessor world)

at Vintagestory.Server.CoreServerEventManager.TriggerGameTick(Int64 ellapsedMilliseconds, IWorldAccessor world)

at Vintagestory.Server.ServerMain.Process()


Your mod just crashed our server Rahjital

TeacupAngel, Sep 16th 2021 at 8:44 PM

Thanks for trying the mod and for the feedback!

I might add an option to reduce the movement of the reticle. Drifters and animals are rather slow and move around so little that it'd make aiming at far distances very easy. I'll consider what to do about it, but in the meanwhile you'd have an option to reduce it for yourself :) I'm not quite sure what you mean in the part about spears, are you asking for them to do less damage than arrows? Spears have longer cooldown than bows, and better bows have large damage bonuses that make them stronger than spears, especially with iron and steel arrows.

And thank you for letting me know about the Movement mod issue, I'll take a look what's happening there!

Lyte, Sep 15th 2021 at 2:05 AM

I tried this, here's my take :  Archery - Crosshair moved around too much to be enjoyable ; Spear - Less damage compared to Arrows , VSMovement (mod) Dash occurs while attempting to Throw Spear , doesn't affect it too much , but is a bit of a nuisance.  With some tweaks , especially to Archery and aiming , I'll Reinstall this mod.

delete edit