
Mods / Projectile Tracker
Author: MrFastZombie
Side: Both
Created: Mar 22nd 2024 at 6:53 AM
Last modified: Jan 22nd at 8:50 PM
Downloads: 2290
Follow Unfollow 75
Recommended download (for Vintage Story v1.20.x):
projectiletracker_1.0.3.zip
1-click install
My first mod for VS!
Projectile Tracker automatically creates waypoints when your fired projectiles land and deletes them when they are either picked up or despawned. Note that this mod is required serverside when playing multiplayer.
How It Works 
When a projectile is spawned the server will detect when the projectile impacts and it will create the waypoint and send it to the player that fired the projectile. Upon despawn or pickup the waypoint will be removed if the player is online, or saved to a list if not and processed the next time the player comes online.
Commands
/ptpurge -- Removes all of your PT waypoints. More specifically, it removes any waypoints that start with "Projectile ". So keep that in mind if you have any other waypoints named like that for some reason.
/ptclearorphans -- Removes any PT waypoints that no longer have an associated entity, in case any don't get removed automatically.
/ptremovepending -- Can only be called by those with ban permissions. This command removes a player from the pending waypoint update list (which is used to update waypoints for players that were offline) when supplied a playerUID, or clears the list if the input is just "all". You probably won't need to do this but it is provided just in case. Examples: /ptremovepending all, /ptremovepending BxGR+8W4FOoB+arlMpjRxNq+
Config 
"EnableProjectileTracker": true,
-- Enables or (soft) disables the mod. When the mod is disabled this way, new waypoints will not be made for the player but old ones will still be removed as normal."allowWelcomeMessage": true,
-- When joining a server, a welcome message will alert the user of waypoints that have been deleted since their last join. This setting controls if that is displayed."icon": "ptarrow",
-- The waypoint icon. Accepts any icon name from the Waypoint icon list. By default, uses an icon () included with the mod. If you'd like an icon that is more precise, you can use "x" or "star1" instead. Invalid values will make it default to the circle icon.
"color": "#f9d0dc",
-- The HEX code for the color of the waypoint. You should be able to get it from an online color picker. Do not forget the #."InjectModdedProjectiles": true,
-- If true: modded projectiles will be tracked. "projectileBlacklist": []
-- An array of item names that will not be tracked. On the serverside, this will disable those projectiles for everyone but on the client side it will prevent waypoints being made for that client. Projectile names that are being tracked are listed in the server-debug log, and you can find them by searching "Injecting entity". Example: ["arrow-crude", "bullet-lead"]
QnA 
- Why serverside? By going serverside, Projectile Tracker can update your waypoints if you are not near them or even if you are offline from a server using the mod. Waypoints are also made manually on the server rather than by making the client use the waypoint command, so your chat log doesn't get spammed when you are using projectiles.
- Where can I report bugs? In order of preference, you can report bugs on the GitHub issues page, or in the comments here. I'll try to keep track of them but I may be slower to notice comments.
- What happens if someone else picks up my projectiles? When someone picks up your projectiles the waypoints will still be removed for you.
- Can I edit PT waypoints? As long as you do not change the name of the waypoints PT will be able to access them as normal. You can also remove them manually without any issues.
- What languages does this support? As of right now, only English. There's not much to translate for this mod, but I do have it prepared for translation and I will accept translations.
- Does this work on version x.xx.x? The versions I set on the file downloads are the versions I have confirmed are working with my mod. However, chances are that this mod will work with any subversions of whatever version they were released for, and possibly even with older or newer main versions. I cannot gurantee, but it can be worth checking. You should backup your world before testing.
- I installed the mod but waypoints don't work? If you downloaded the mod while the game was running (i.e, 1-click install, or using a mod that adds an in-game way to update) then you may need to reboot the game for it to work. If you already restarted your game and it does not work, this may be a bug that you should report (See the second bullet point on this list).
Known issues 
- If a projectile leaves your simulation distance, it will not create a waypoint until it is loaded again and lands.
- If a projectile in-flight in an unloaded chunk lands after the server or save has been reloaded, it will not create a waypoint.
Compatibility 
This mod should not cause issues with most mods. Any mods that have their projectiles use the type "EntityProjectile" or "CombatOverhaul:Projectile" should be tracked. Mods that add their own projectile entities should still work, but my mod will ignore them if they are not accounted for already. If you've found a mod that does not work, let me know and I may try to make it work.
PT has Native Support for: Combat Overhaul
Current incompatibilites: Currently none are known.
Mod Interaction Notes:
- Auto Config Lib: If my mod has not been active while loading a world yet, it will need to generate a config. Auto Config Lib will not be able to interact with the config if it was created during that world load, but will be able to when the game is loaded again.
See Also 
Projectile Tracker uses an MIT license.
Version | For Game version | Downloads | Release date | Changelog | Download | 1-click mod install* |
---|---|---|---|---|---|---|
v1.0.3 | 1122 | Jan 22nd at 8:50 PM | Show | projectiletracker_1.0.3.zip | 1-click install | |
v1.0.2 | 111 | Jan 22nd at 5:33 AM | Show | projectiletracker_1.0.2.zip | 1-click install | |
v1.0.1 | 221 | Jan 18th at 2:15 AM | Show | projectiletracker_1.0.1.zip | 1-click install | |
v1.0.0 | 836 | Mar 22nd 2024 at 11:04 PM | Show | projectiletracker_1.0.0.zip | 1-click install |
Anyways thank you for reporting the issue and apologies for the bug. Patch is out now.
I believe I found the issue, I'll be releasing a new patch once I finish testing the changes with combat overhaul as it relates to the compatibility code. I was worried something would break, but turning the enemies into a machine gun was the last bug I expected to happen.
Using this mod even with 0 other mods makes Bowthorns shoot absurdly fast, guaranteeing instant death
i don't use autoconfig lib, no. from my theory it looks like this was caused by the "assembly already loaded" issue which can be fixed with a full game restart- i think it happens when i had the previous version enabled at any point and disable it later in favour of another version. i had this with another mod recently, as well. mod is working ^^
tauceti2114 Do you happen to use Autoconfig lib? I think it is causing my config to fail to load. I know that doesn't necessarily explain why 1.0.0 works, but both versions appear to work for me but it breaks with that mod. EDIT: If you can share me your logs (client-main.log, client-debug.log, server-main.log, server-debug.log in %appdata%\VintageStoryData\Logs if you are not using VS launcher and are on Windows. Pasting that directory into your explorer's path bar should take you there regardless of where your appdata is.) It might help me figure out what caused this issue. If you do choose to share those, please use something like github gists, pastebin, or just hosting them on a cloud service so the comments don't get filled here.
I suppose 1.20.1 broke it in some way, but it is very odd that it only broke 1.0.1 of my mod since it was only a version bump. Thanks for letting me know, I'll try to update it soon.
for some reason 1.0.1 doesn't seem to be working for me (no waypoints or commands, "no such command exists") on 1.20.x but i might keep testing it out. 1.0.0 works just fine
For any server players: If you get the welcome message upon joining a server that says you've had some waypoints removed since you were last logged in for projectiles that have likely despawned rather than been picked up, let me know so I know the notification system is working in that case. I still need to figure out a better way to test this feature.
This is a great QoL idea. Thank you for implementing it. Also, a mega thank you for such nice documentation, as well. It's rare to see people spend time documenting their mods, but it's very much appreciated.
Great idea, it reminds me of people writing down notes in The Long Dark to go find arrows they lose when trying to hunt.