Mods / Bullseye

Category: #Tweak #Weapons
Author: TeacupAngel
Side: Both
Created: Sep 6th 2021 at 6:58 PM
Last modified: Oct 6th at 6:06 PM
Downloads: 11862
Follow Unfollow 136

Last major release - 2.4.0 (31-09-2022)

The stable version is finally out! 🎉🎉 While there have still been a few rare reports of the frozen spear bug happening, by and large it seems mostly gone, and the remaining occurences appear not to be caused by Bullseye itself. Huge thanks to Acouthyt for working closely with me as I was trying to fix the issue, and also to Thranos, Under, Lohn and Xorberax for the detailed info about what the bug was like, and everyone else for reporting as well! Couldn't have done it without you <3

This release is a bit lighter on features than originally planned because of all the bugfixing, but there's still some new things! Most importantly, slings can now use lead sling bullets, made by casting lead into the new bullet clay molds. Lead bullets are very powerful and allow slings to keep up with bows longer, although more advanced bows with good arrows still eclipse them eventually. For the archers out there, crude arrows can be upgraded to flint arrows by adding feathers (idea by Acouthyt!), and all other arrows can be upgraded by crafting with an arrowhead. Iron and steel spears also have a new model, based on the vanilla ornamental silver spear.

Other than that, there is now (partial) compatibility with the Black Sands Megapatch mod, some minor balance changes and other things that you can find in the changelog below. Have fun!


Changelog (since v2.3.2):

  • Add lead sling bullets, and bullet molds to cast them in
    • Lead bullets are faster, stronger, and more accurate ammunition than stones
  • Meteoric iron sling stone damage increased to 6
  • Crude arrows now have an accuracy penalty; crude bow accuracy increased to compensate
  • Crude arrows can now be upgraded to flint arrows by adding feathers
  • All other arrows can be upgraded by adding a new arrowhead (old arrowhead is lost)
  • Custom ammo item readout re-added, now shows break chance in percent instead of lifetime projectile damage
  • Compatibility with Black Sand Megapatch mod
  • Improvements in compatibility with other mods
  • Added safe guards against crashes caused by incompatible mods

  • Fixed higher FOV making it harder to aim
  • Fixed incorrect inventory and ground storage positions for iron, meteoric, and steel spears
  • Fixed incorrect reticle texture for longbow
  • Fixed spear attack sound pitch
  • Many minor bugfixes

  • No longer replaces vanilla bow/spear/sling code
  • Significantly improved debugging information
  • Codebase cleanup and major refactor
  • API: Can now define projectile entity, spread, and speed per ammo type
  • API: Renamed GetProjectileDamageOnImpact to GetProjectileDurabilityCost
  • API: Renamed GetWeaponDamageOnShot to GetWeaponDurabilityCost
  • API: JSON format standardised to work with tools not familiar with JSON5


Hello and welcome to Bullseye, the mod aiming for a more satisfying and balanced ranged play!

  • 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!)

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.4.1 1668 Oct 6th at 6:06 PM Show Bullseye
v2.4.0 346 Sep 30th at 8:04 PM Show Bullseye
v2.4.0-rc.4 596 Sep 20th at 12:38 PM Show Bullseye
v2.4.0-rc.3 62 Sep 20th at 7:32 AM Show Bullseye
v2.4.0-rc.2 721 Sep 3rd at 11:18 AM Show Bullseye
v2.4.0-rc.1 131 Sep 2nd at 10:19 PM Show Bullseye
v2.4.0-pre.2 497 Aug 4th at 8:37 PM Show Bullseye
v2.4.0-pre.1 73 Aug 4th at 7:51 PM Show Bullseye
v2.3.2 1791 May 14th at 12:49 PM Show Bullseye
v2.3.1 357 May 7th at 9:13 AM Show Bullseye
v2.3.0 274 May 1st at 6:54 PM Show Bullseye
v2.2.4 2582 Jan 6th at 11:14 PM Show Bullseye
v2.2.3 294 Dec 15th 2021 at 7:14 PM Show Bullseye 2.2.3
v2.2.2 828 Oct 21st 2021 at 1:56 PM Show Bullseye
v2.2.1 333 Oct 13th 2021 at 10:01 PM Show Bullseye
v2.2.0 287 Oct 8th 2021 at 4:12 PM Show Bullseye
v2.1.1 371 Sep 22nd 2021 at 4:47 PM Show Bullseye
v2.1.0 260 Sep 20th 2021 at 10:56 AM Show
v2.0.0 390 Sep 10th 2021 at 11:53 AM Show

89 Comments (oldest first | newest first)

💬 KelenEysi, 16 hours ago
💬 TeacupAngel, 2 days ago


I'm sorry it took me so long to reply, I'm still recovering I'm afraid, but thank you for letting me know! First time I'm seeing this issue, I'll make sure to write it down. I've done a little investigating and so far it looks like the crash is happening before Bullseye can even start doing its thing, so it'd make sense if it were a mod conflict like you say. I'll keep an eye out for that :) Here's hoping it won't get in the way too much in the meantime!

💬 NerdimusPrime, 5 days ago

Hi Teacupangel, sorry to hear about your hand and hope it heals up quickly. I'm getting this occasional crash but luckily I can restart the game and it works fine again. Seems to happen only when remapping the world after adding new mods, but thought you might want to know about it regardless. This mod is such a great improvement over the vanilla bow system. Nice work!

Running on 64 bit Windows with 16 GB RAM
Game Version: v1.17.9 (Stable)
11/30/2022 3:29:48 PM: Critical error occurred
Loaded Mods:
System.NullReferenceException: Object reference not set to an instance of an object.
at Bullseye.BullseyeItemSpear.GetHeldItemInfo(ItemSlot inSlot, StringBuilder dsc, IWorldAccessor world, Boolean withDebugInfo) in E:\VintageStory Mods\1.17\Bullseye\src\BullseyeItemSpear.cs:line 240
at Vintagestory.API.Common.ItemStack.GetDescription(IWorldAccessor world, ItemSlot inSlot, Boolean debug) in VintagestoryApi\Common\Collectible\ItemStack.cs:line 370
at Vintagestory.GameContent.GuiHandbookItemStackPage..ctor(ICoreClientAPI capi, ItemStack stack) in VSSurvivalMod\Systems\Handbook\Gui\GuiHandbookItemStackPage.cs:line 42
at Vintagestory.GameContent.GuiDialogHandbook.BuildPages_Async(List`1 allstacks) in VSSurvivalMod\Systems\Handbook\Gui\GuiDialogHandbook.cs:line 516
at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
at System.Threading.QueueUserWorkItemCallback.System.Threading.IThreadPoolWorkItem.ExecuteWorkItem()
at System.Threading.ThreadPoolWorkQueue.Dispatch()

Event Log entries containing Vintagestory.exe, the latest 3
{ TimeGenerated = 11/30/2022 3:29:54 PM, Site = , Source = Windows Error Reporting, Message = Fault bucket 2063857912588054362, type 5
Event Name: CLR20r3
Response: Not available
Cab Id: 0

Problem signature:
P1: Vintagestory.exe
P3: 63501532
P4: Bullseye
P6: cec899ad
P7: c5
P8: 0
P9: System.NullReferenceException

💬 RogueRaiden, Nov 18th at 11:00 PM


Awesome, that works. Thank you!

💬 TeacupAngel, Nov 18th at 12:21 PM


Hello! Apologies about the delay, I'm recovering from a hand injury and sadly can't release an update right now. I've tracked the issue down to an oversight in Bullseye code, but you might be able to fix it on RHAddition's end by adding an "attributes": {} tag to assets\rhadditions\itemtypes\resource\snowball.json. Hopefully this resolves your issue! :)

💬 KraftLawrence, Nov 15th at 12:50 PM

Hello there,

one of the bigger servers right now (Rogue House) has it's own mods tweaking stuff and adding a class for example.
Sadly this mod crashes when loaded with Bullseye.
The crash report is rather short and I was hoping to dive into the lines and find the problem myself to then work on a fix, sadly I don't even know where to begin or what I need to do that ^^'

Would you mind terribly looking what it could be? 
It doesn't have to be a fix, but knowing the source of the problem would help already.
I'd understand if that sort of compatability work isn't really something you would like to do, but it would enable a large server to enjoy the welcome changes you made to ranged weapons, including me of course ;)

Running on 64 bit Windows with 32 GB RAM
Game Version: v1.17.9 (Stable)
15.11.2022 12:51:33: Critical error occurred in the following mod: bullseye@2.4.1
Loaded Mods: game@1.17.9, rhadditions@2.2.0, creative@1.17.9, survival@1.17.9, bullseye@2.4.1
System.NullReferenceException: Object reference not set to an instance of an object.
at Bullseye.HarmonyPatches.ItemStonePatch.GetHeldItemInfoPostfix(ItemSlot inSlot, StringBuilder dsc) in E:\VintageStory Mods\1.17\Bullseye\src\BullseyeHarmonyPatches.cs:line 128
at Vintagestory.Common.CreativeTab.CreateSearchCache(IWorldAccessor world) in VintagestoryLib\Common\GameContent\Inventory\CreativeTab.cs:line 43
at Vintagestory.Common.CreativeTabs.CreateSearchCache(IWorldAccessor world) in VintagestoryLib\Common\GameContent\Inventory\CreativeTabs.cs:line 47
at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)
at System.Threading.QueueUserWorkItemCallback.System.Threading.IThreadPoolWorkItem.ExecuteWorkItem()
at System.Threading.ThreadPoolWorkQueue.Dispatch()

Event Log entries containing Vintagestory.exe, the latest 3
{ TimeGenerated = 15.11.2022 12:51:42, Site = , Source = Windows Error Reporting, Message = Fault bucket 1986825105190380695, type 5
Event Name: CLR20r3
Response: Nicht verfügbar
Cab Id: 0

Problem signature:
P1: Vintagestory.exe
P3: 63501532
P4: Bullseye
P6: cec899ad
P7: 12a
P8: 0
P9: System.NullReferenceException

💬 CLBob, Nov 10th at 8:41 PM

This mod is fun

💬 TeacupAngel, Oct 12th at 1:25 PM


Hello! Thank you for asking, I really ought to make a handbook page for this already haha

Crosshair colour doesn't affect velocity or damage, you are right! Yellow reticle means that you are ready to shoot but don't have a stable aim yet, and the reticle may still sway around a lot. Once it turns white, that means accuracy is at its highest. Risk vs reward kind of thing - you can make a quick shot while the reticle is still yellow, but there's always the chance an unexpected twitch can make the shot go wide.

Arrows can only break when hitting entities, yes! That's a vanilla thing that I want to change some day. Of course I'll buff arrow durability a lot if I ever do that :)

Spears not breaking at 1 durability left is a recently introduced bug, whoops! I've got it fixed for the next release now, thank you. In the meantime, I guess you get to enjoy your infinite spears, haha!

💬 Exlium, Oct 11th at 6:28 PM

I tried testing some stuff and I don't really understand some of the mechanics. What is the difference between the yellow and white crosshair? It seems like it does the same damage and velocity. The arrows chance to break is only when hitting an entity, right? Also I noticed spears rarely break if they are thrown with 1 durability. I can basically use flint spears forever if I don't melee.

💬 TeacupAngel, Oct 8th at 9:43 AM


I'll have to think about it, I like the idea since copper arrows especially are a bit of a pain to make, but at the same time I also have to consider how it would affect smithing and so on. In the meantime you could try the Additional Molds mod here: It hasn't been updated in a while, but it's also the kind of mod that is less likely to break with version updates so there's a good chance it might still work :)

💬 PhoenixMastM, Oct 7th at 10:45 PM

Any chance at a casting mold for arrowheads?

More simple arrowheads were cast and slotted into the shaft rather than forged and worked as a cap onto the shaft.

💬 TeacupAngel, Oct 6th at 7:12 PM


Hello, thank you for the translation! I'll see about adding it for the next release :)

💬 LordOri, Oct 5th at 1:07 PM

Hello, please add russian translate to mod ->


💬 OmegaHaxors, Oct 2nd at 2:31 PM

Darn, though understandable. That's just the downside of patch-based modding.

💬 TeacupAngel, Oct 2nd at 1:16 PM


Thank you again! Couldn't have done it without the feedback and reports from folks like you :) Have fun with the update!



I'm sorry but I can't really do that, it would be a lot of effort to support a version that wouldn't even do what Bullseye is meant to be in the first place. I'm honestly having trouble imagining how the new aiming system would work with the vanilla balance of being able to shoot twice a second. Feel free to make a fork of your own without the balance changes though, or you can always make a patch mod with Bullseye as a dependency too :)

💬 OmegaHaxors, Oct 1st at 1:37 AM

I don't like the balance changes and they break in my pack. Is it possible to release a version without them?

💬 Lohn, Sep 30th at 9:29 PM

Gratz on the 2.4.0 stable release! I'm glad to hear you were able to fix it up to your satisfaction! :)

I'm also pleasantly surprised by the new additions! Thanks again for all of your hard work!

💬 TeacupAngel, Sep 24th at 8:29 AM


Huh, the entity behavior that handles Bullseye things was somehow missing. I can add a safety catch to stop the crash, but it's a pretty catastrophic error to be honest, I can't make ranged weapons work if that behavior isn't there. My guess is a mod conflict of some sort, might be worth seeing the server main log to see if there's an error thrown.



So far so good, it seems, only getting other bug reports now haha! Thanks for all the help :)

💬 Xorberax, Sep 24th at 2:21 AM

Hey, I encountered a crash with Bullseye@2.4.0-rc.4 on VS 1.17.3 when I right-clicked a cobblestone slab while having a flint spear equipped.

Game Version: v1.17.3 (Stable)
9/23/2022 9:19:14 PM: Critical error occurred in the following mod: bullseye@2.4.0-rc.4
Loaded Mods: acorns@0.5.1, weaponpacka@1.3.1, ancienttools@1.4.7, tonwexp@1.1.0, attributer@1.0.1, auxiliarymod@1.0.4, bettercrates@1.5.1, betterruins@0.0.3, Ceramos@0.2.2, chiseltools@1.5.5, drdecor@1.0.0, extrachests@1.6.0, fancydoors@1.1.1, weaponpackg@1.0.1, hideandfabric@1.2.6, HumanSkinTones@0.0.2, meteoricexpansion@1.2.2, moredungeons@0.1.1, pieontheshelf@1.0.0, potontheshelf@1.0.0, primitivesurvival@3.0.5, shinglesandthethings@1.0.1, rpgitemrarity@1.0.2, rustandrails@1.0.3, sortablestorage@1.5.0, spyglass@0.4.5, survivalcats@1.2.3-rc.2, targetDot@1.0.2, thecritterpack@0.7.6, translocatorengineeringredux@1.2.0, game@1.17.3, wgenfix576@1.0.0, wildcrafttrees@1.0.1, wildcraft@1.4.3, calendar@1.0.0, captureanimals@2.2.0, carrycapacity@0.6.5, legendarymobs@1.0.7, lichen@1.6.1, miningtools@1.1.4, morepiles@1.2.2, petai@1.5.4, playercorpse@1.4.3, tprunes@1.0.5, tpnet@1.7.1, usefulstuff17@1.0.0, creative@1.17.3, vsquest@0.0.4, survival@1.17.3, xlib@0.6.10, xorberax-shader-mod@0.7.0, xorberax-bloodmod@0.3.2, xrowboat@0.0.5, knapster@2.0.0, bullseye@2.4.0-rc.4, cob@1.5.3, tradercamps@1.0.2, em@1.0.0, onestick@1.0.1, vsvillage@0.2.4, wolftaming@1.5.3, xskills@0.6.10, bricklayers@1.0.1
System.NullReferenceException: Object reference not set to an instance of an object.
at Bullseye.BullseyeItemRangedWeapon.OnHeldInteractStart(ItemSlot slot, EntityAgent byEntity, BlockSelection blockSel, EntitySelection entitySel, Boolean firstEvent, EnumHandHandling& handling) in E:\VintageStory Mods\1.17\Bullseye\src\BullseyeItemRangedWeapon.cs:line 240
at Vintagestory.Client.NoObf.SystemMouseInWorldInteractions.TryBeginUseActiveSlotItem(BlockSelection blockSel, EntitySelection entitySel, EnumHandInteract useType, EnumHandHandling& handling) in VintagestoryLib\Client\Systems\Player\MouseInWorldInteractions.cs:line 852
at Vintagestory.Client.NoObf.SystemMouseInWorldInteractions.TryBeginUseActiveSlotItem(BlockSelection blockSel, EntitySelection entitySel) in VintagestoryLib\Client\Systems\Player\MouseInWorldInteractions.cs:line 835
at Vintagestory.Client.NoObf.SystemMouseInWorldInteractions.HandleMouseInteractionsBlockSelected(Single dt) in VintagestoryLib\Client\Systems\Player\MouseInWorldInteractions.cs:line 540
at Vintagestory.Client.NoObf.SystemMouseInWorldInteractions.OnFinalizeFrame(Single dt) in VintagestoryLib\Client\Systems\Player\MouseInWorldInteractions.cs:line 86
at Vintagestory.Client.NoObf.ClientEventManager.TriggerRenderStage(EnumRenderStage stage, Single dt) in VintagestoryLib\Client\Util\ClientEventManager.cs:line 201
at Vintagestory.Client.NoObf.ClientMain.TriggerRenderStage(EnumRenderStage stage, Single dt) in VintagestoryLib\Client\ClientMain.cs:line 1174
at Vintagestory.Client.NoObf.ClientMain.RenderToDefaultFramebuffer(Single dt) in VintagestoryLib\Client\ClientMain.cs:line 1362
at Vintagestory.Client.GuiScreenRunningGame.RenderToDefaultFramebuffer(Single dt) in VintagestoryLib\Client\MainMenu\Screens\GuiScreenRunningGame.cs:line 202
at Vintagestory.Client.ScreenManager.Render(Single dt) in VintagestoryLib\Client\ScreenManager.cs:line 709
at Vintagestory.Client.ScreenManager.OnNewFrame(Single dt) in VintagestoryLib\Client\ScreenManager.cs:line 613
at Vintagestory.Client.NoObf.ClientPlatformWindows.window_RenderFrame(Object sender, FrameEventArgs e) in VintagestoryLib\Client\ClientPlatform\GameWindow.cs:line 125
at System.EventHandler`1.Invoke(Object sender, TEventArgs e)
at OpenTK.GameWindow.RaiseRenderFrame(Double elapsed, Double& timestamp) in C:\Users\Nexrem\Desktop\transfer\opentk\src\OpenTK\GameWindow.cs:line 476
at OpenTK.GameWindow.DispatchRenderFrame() in C:\Users\Nexrem\Desktop\transfer\opentk\src\OpenTK\GameWindow.cs:line 452
at OpenTK.GameWindow.Run(Double updates_per_second, Double frames_per_second) in C:\Users\Nexrem\Desktop\transfer\opentk\src\OpenTK\GameWindow.cs:line 375
at Vintagestory.Client.ClientProgram.Start(ClientProgramArgs args, String[] rawArgs)
at Vintagestory.ClientNative.CrashReporter.Start(ThreadStart start) in VintagestoryLib\Client\ClientPlatform\ClientNative\CrashReporter.cs:line 93


💬 Xorberax, Sep 23rd at 9:00 PM

Hi TeacupAngel, I'll test out the latest version on 1.17.3 and let you know if I see the issue again!

💬 Lohn, Sep 23rd at 6:27 PM


I've used Bullseye since 1.16 (and possibly earlier that I forgot now) and only encountered the frozen arrows bug just recently - it seems quite aloof and random (hence your inability to easily trigger it on demand and replicate it) but I can confirm that I've not had it happen since, and that maybe the key to it was that crosshair issue "long shot" (pardon the pun, haha)

I have since that moment, also carried my bow on me and gone to aim (and even shoot at the floor, in case the reticule no longer bugs but arrows somehow do) and have yet to replicate it for my own self. If no one has experienced it since the update, with 230+ downloads I feel like it you may have squashed it. :)

💬 TeacupAngel, Sep 22nd at 10:17 PM

Under Xorberax Lohn Qyvalar Thomas_Jefferson micko0o and everyone else who experienced the frozen spear bug-

Apologies for the ping, I have people telling me the floating spear bug is finally gone in 2.4.0-rc.4, but I can't confirm it since I still haven't seen the bug myself even once. If you are using the latest version of Bullseye, have you seen the bug at all since updating? This is the final confirmation I need to mark the latest version as stable, and come back to working on new features :)

💬 TeacupAngel, Sep 20th at 12:44 PM

Apologies about releasing again so soon, but Bullseye 2.4.0-rc.4 was just released with another potential fix for the big bad spear bug! VS also just released 1.17.4; this new version of Bullseye works with the new patch, but is still happy with 1.17.3 as well :)



If a thing can possibly go wrong, it will eventually go wrong I guess, haha. Glad you could get it working! :)

💬 iotid, Sep 20th at 11:32 AM

Checked with player getting the outright crash and they were indeed still on a 1.17.2 client, my own personal issue turned out to be a copy of rc.2 hiding in /modsbyserver/ and it was refusing to load rc.3 on demand for some strange reason (although I did have the server updated!), but cleaning up unused mods and shoving them back all into the same load dir fixed my end, all good now, ty :D

💬 TeacupAngel, Sep 20th at 11:02 AM


I would be interested in that, yes! More data is always good, and if nothing else, it can always help me improve compatibility with other mods :)



This issue is usually caused by running the mod in an older version of the game than the mod needs. Are you running the latest 1.17.3 patch of Vintage Story?

💬 iotid, Sep 20th at 10:45 AM

Finding some odd crash/mod refusal to load problems with 2.4.0-rc.3, also running a decent amt of mods, info collecting then will throw what I can find onto the issue tracker, but the most consistent error is:
System.Exception: Don't know how to instantiate collectible behavior of class 'Bullseye_AnimatableAttach' did you forget to register a mapping?

💬 Under, Sep 20th at 10:27 AM

Hi there,

I managed to make your mod work via modifying the json file (as you hinted). Since then I kept experiencing the bug from time time but did not want to complain since I am running unsupoported combination of server/mod versions.

Anyway quitting the game completely (to desktop) always solves the problem for me while only quitting to menu never worked.

I also noticed that when bug occurs there is the standard white crosshair displayed over the aiming reticule from the mod (and the reticule is no longer wobbling). This is how I know I am not supposed to throw spears or shoot arrows.

Would you be interested in the logs even though I am running non standard combination of game and version?

💬 TeacupAngel, Sep 20th at 7:39 AM

Bullseye 2.4.0-rc.3 is now out, with another try at fixing the bug, as well as some other minor bugfixes, and a new model for high-tier spears!

💬 TeacupAngel, Sep 18th at 10:03 PM

Rc.3 release coming soon. I just noticed a thing that could potentially cause issues; it's a long shot, but about the best I can do right now, without client logs or being able to reproduce the issue whatsoever.

💬 Xorberax, Sep 18th at 8:10 PM

 I've also experienced the frozen-in-air bug for spears. I also encountered a bug where throwing spears would always result in them getting thrown south, no matter where I was aiming.

💬 TeacupAngel, Sep 18th at 7:57 AM


Definitely worth noting, thank you. It's a bit unfortunate that quitting back to main menu doesn't fix it - up until now most people reporting it saw the bug happen in multiplayer where quitting and re-joining does seem to help. It's good to know and be able to give people better advice, though.

As for the floating arrows, you can try placing a block of dirt over them, if the game lets you, or letting a sand/gravel block fall into it if the game complains something is in the way. Someone reported that it made the game think the arrows hit the ground, and let them pick the arrows up :)

💬 Lohn, Sep 17th at 7:02 PM


I'm glad to hear I helped with the direction, at least - now that I'm on the lookout for it, I'll be sure to save and quit the moment it occurs and get those logs. It only occured that one session, so far. Worth noting, but maybe obvious - a main menu refresh doesn't fix it, it stays until I fully close and open the game, and another thing of note; I current have 2 crude arrows and a copper arrow in the air still, that saved through a save and quit yesterday (the others prior I think got deleted before I closed the game, but these three were still in the world when I left) I'm not sure if or when they'll disappear.

Quick edit: Oh, and I can't pick up said arrows - they're still "mid flight" and not an actual arrow after collision on the ground so I phase through them.

💬 TeacupAngel, Sep 17th at 10:28 AM


No worries, I wouldn't expect you not to play the game in the meantime, haha :) Pastebin links here are perfectly good, but feel free to send it in whatever way is the most convenient to you. Discord mention or DMs just as good ^^

And thank you for the extra info, it actually helps a lot! Seeing the default crosshair is actually a big clue no one's reported before, and means the issue is with a section of code I wasn't even suspecting before. The logs would still be very helpful because this honestly makes the error even more mysterious than it already was, but at least I'm pointed in the right direction now, haha. Thank you so much!

💬 Lohn, Sep 17th at 9:07 AM



I currently don't have a log, because I started the game as I opened the mod page - but if it occurs again I'll definitely get those logs to you. Do you prefer a pastebin link here, or another way like Discord with an @ mention?
I currently can't replicate it, but I think it occured when firing and holding an arrow, then switching to a copper spear and still holding for a half second then releasing, which threw the spear.

I do know for certain that I couldn't free aim at all, and the default crosshair + showed overtop of the Bullseye aim crosshair. The arrows immediately get stuck floating just behind the shoulders/head of the character, and generally backwards-aimed.

I hope this helps a bit.

💬 TeacupAngel, Sep 17th at 7:50 AM


Oh goodness, and here I thought I I squashed that bug in 1.17 already D: I could honestly use more info on that, yes. If you could send me the client log files (especially client-main.txt and client-debug.txt) after a game where the bug happens, that would be immensely helpful as these most likely have the data I need to actually track this bug down and fix it. You can find the log files in the same place you put mods - if you go one directory up from there, there should be a directory called Logs where the files should be.

Still, thank you for the report! It's good to have confirmation that the bug is still happening.

💬 Lohn, Sep 17th at 1:38 AM

I just had my copper arrows (shot from a simple bow) get stuck floating, as per mentioned below; so I thought I'd inform you. If you need any info or such to help squash it, please ask. I tried shooting from a crude bow (that worked fine yesterday) from my rack but it caused floating, too. I tried all combinations of crude & copper arrows with crude and simple bow, all float. Upon exiting to the main menu and reloading world, they are gone but still float when shot. I notice they seem to snap backward (i.e. they aim towards my back) I hope somehow this helps fix it!

💬 TeacupAngel, Sep 15th at 9:28 PM

Thank you so much, I'm glad you are enjoying the mod! :)

💬 Xorberax, Sep 15th at 2:39 AM

Outstanding mod! This is a must-have IMO.

💬 Under, Sep 8th at 6:50 AM


You are absolutely right, it did not occur to me that even after recent update our server is not 1.17.2. And reading the log the other way around obviously did not help :)

💬 TeacupAngel, Sep 7th at 5:13 PM


Hello! The latest version of the mod needs Vintage Story version 1.17.2, but it looks like your server is still on 1.17.1. You should update the server if you are able to, not just for the mod, but also to get the latest bugfixes from the 1.17.2 patch. :)

If that's not an option for you, it might be possible to open the mod's zip file and edit the modinfo.json file, change all references from "1.17.2" to "1.17.1", and save the file. I'd recommend not doing this unless you absolutely have to, though.

💬 Under, Sep 7th at 3:48 PM

Hi again,

we have "installed" your newest release to our MP server, but the mod is not loading. On the other hand in single player the mod works fine.

I have found following lines in the server log, maybe it will help:

7.9.2022 17:43:14 [Error] [bullseye] Could not resolve some dependencies:
7.9.2022 17:43:14 [Error] [bullseye] game@1.17.2 - Version mismatch (has 1.17.1)
7.9.2022 17:43:14 [Error] [bullseye] survival@1.17.2 - Version mismatch (has 1.17.1)

💬 TeacupAngel, Sep 3rd at 11:20 AM

Bullseye 2.4.0-rc.2 is now released, with some important bugfixes as well. If you got rc.1, this one is greatly recommended!

💬 TeacupAngel, Sep 2nd at 10:21 PM

Bullseye 2.4.0-rc.1 for 1.17.2 just released, hopefully fixing the dreaded floating spear bug! If you had issues with spears and arrows freezing in the mid-air, please tell me if you still see them or if the issue is gone now. I'd appreciate it greatly <3

💬 TeacupAngel, Aug 25th at 11:10 AM

Thank you! <3

💬 OBEDIA, Aug 21st at 11:50 PM

Great mod! On 16.5

💬 TeacupAngel, Aug 21st at 1:04 PM


No worries at all, there's no rush at all! I'm really grateful you would want to try get me these logs in the first place <3

💬 Under, Aug 21st at 10:14 AM


I am sorry, it seems that I overestimated the way VS stores logs. I though that I will be able to get you fresh logs with the bug but I was unable to reproduce it today. And the old logs have been overwritten by todays logs so I have nothing to give you :(

I will try to collect logs if I run into the problem again. Sorry for inconvenience.

💬 TeacupAngel, Aug 20th at 10:20 PM


Thank you! That's already helpful, I'll see if I can find more with this new clue.

The easiest way to send the logs would probably be to select them in File Explorer and include them in a VS forum post here, in the Bullseye topic. The browser should let you just drag and drop the logs into the text area to upload them :)

💬 Under, Aug 20th at 6:35 PM


my screen resolution is currently 1680x1050, I am playing in fullscreen mode.

How do I send the logs? I can probably recreate the issue so it should not be problem getting fresh logs.

💬 TeacupAngel, Aug 20th at 6:04 PM


Thank you! I forgot that VS doesn't have the actual resolution numbers in the options menu. If you happen to know what the resolution of your screen is that would be very helpful, as well as whether you play in fullscreen or not :) And if it's a possibility at all, the client logs as detailed in my previous comment would be much appreciated, or just client-main if that's easier. The crash logs in there would be incredibly helpful!

From what other people with the bug said, you should be able to retrieve the stuck arrows and spears by placing a block over them. That should make the game think they hit the ground, and let you pick them up.

💬 Under, Aug 20th at 2:19 PM


I also noticed that arrows and spears are getting stuck in the air. With arrows this happened when shooting from the edge of the block so I king of assumed it somehow hit the edge and did not pay too much attention to it. Then I tried throwing a spear and all of them got stuck in the air near my avatar. Both arrows and spears were impossible to reclaim (at least I did not figure out how to do it).

We are using version 2.3.2 along with other mods.

edit: Ingame resolution slider says 100% while FoV is 70°

💬 TeacupAngel, Aug 20th at 8:34 AM


Hi there! Are you actually a player who this happened to? If you are, it would be incredibly helpful if you could send me all the client logs (from the Logs directory, in the same place where the Mods directory is) after a game where the bug happens, and also tell me the resolution and Field of View settings you play with. I've only had server owners report it before, but unfortunately servers don't have the information needed to see what the issue actually is. With more clues I could fix this bug much faster :)

💬 Qyvalar, Aug 19th at 11:26 PM

Hi! Just wanted to add, also playing on 2.3.2, and it seems that no projectiles actually work. I've tried spears and sling so far, every time I throw a spear or sling the sling, the projectile is left stuck in mid air (for the sling, amusingly enough, this means I get to hit my own head if I don't immediately move out of the way).

💬 Thomas_Jefferson, Aug 17th at 11:25 PM


Thank you for your reply! I'm glad you're aware and working on it. If you ever need a server to test it, I'd be happy to oblige once 1.17 stable hits.

💬 TeacupAngel, Aug 17th at 8:06 PM


Thank you for the report! I'm aware of this bug and hope to have it fixed in the next release, though since it happens only on servers and to certain players, I can only guess whether it got fixed or not until someone else confirms it to me. The crash seems to happen at the client side, which is why you couldn't see anything in the logs. Hopefully next release on it won't be an issue anymore :)

💬 Thomas_Jefferson, Aug 16th at 10:41 PM

In version 2.3.2, sometimes when players throw spears they are not actually thrown, but float in the air where the thrower was standing. This is visible to both the thrower and other players. I have no crash log or debug information to go off, as far as I'm aware. I disabled all mods with code that affected ranged weapons, and the problem persisted. I'm sorry I'm not able to be more helpful beyond informing you of the bugs existence. If you've already crushed it for the 1.17 update, great! If not, please consider finding a way to fix it. My players and I enjoyed your mod greatly, when it worked.

💬 TeacupAngel, Aug 12th at 11:18 AM


Whoops, thank you for pointing it out! Those are in-development items that were meant to be hidden, haha. If things go well, they might not have to be hidden anymore in the next release :)

💬 ManaWei, Aug 11th at 3:39 PM

Dunno if you noticed.. a few items seem to be missing names, and is listed as filepaths in the handbook.. <3

💬 Kyrthrix, Aug 5th at 8:00 AM


Oh!! Thank you so much!! 😭😍

I really appreciate that!! I love your mod and am a hunter in my server, so I primarily use bows... but my friend is a malefactor and uses slings and couldn't use this updated version!

I'm super excited for 1.17!!

💬 TeacupAngel, Aug 5th at 7:36 AM


Sorry about that! The description could definitely use updating. Unfortunately slings are hardcoded to be, well, slings, but I'll change that once I release a stable version for 1.17, so that you can either make aiming more like bows, or just revert back to the vanilla system. You'll have to edit one file in the mod to do it, but I'll be happy to show you how :)

💬 Kyrthrix, Jul 15th at 3:35 PM

Love this mod- just wish that it was mentioned that it alters the sling!

I wish I could go into the files and delete it, but after hours of trying, I'm sure not a coder LOL.

If there was any way you could make a version updated fully, just... without the sling adjustments... that would be amazing!! 😭
(Or at least an editable config?)

💬 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.

(edit comment delete)