Milspec PDA 1.11.1 with Kill Tracker addon - S.T.A.L.K.E.R. Anomaly mod for S.T.A.L.K.E.R.: Call of Pripyat

PURPOSE:

This addon has three primary purposes:

1. Implement a new tier of PDA beyond 3.1: the Milspec PDA
2. Full customization of body tracking and squad display behavior for all PDA tiers
3. A powerful but optional progression system for gaining access to the squad location data of other factions

NEW IN 1.11:

• If you are running modded exes, Milspec PDA now uses DXML by default to inject its mapspots. This means it no longer needs to replace map_spots_relations.xml--which means no more conflicts with other addons that modify that file. A legacy patch is included with the file replacement for vanilla binaries.
• Players can now separately control whether the victim and/or killer are identified on the mapspot tooltip for the dead body using the same criteria as for body tracking: all kills, squad only, player only, or off.
• New customizable stat for each PDA model: Progression Gain Multiplier. This acts as a direct multiplier to all progression data gained while equipped with that PDA. The defaults are:
  PDA 1.0: 0 (it can't display any squad mapspots by default anyway)
  PDA 2.0: 0.1 (it displays only your own faction, but you can start gaining data slowly)
  PDA 3.1: 0.5 (access gained to neutral squads, but gain is still slower)
  MilPDA: 1 (the default baseline around which the feature is balanced)
• Default progression settings have also been adjusted based on extensive playtesting. Vanilla PDA drop chances are actually quite tiny, so unlock thresholds have been significantly reduced--but neutral factions now also require unlocking, and access for enemy factions only lasts for an in-game week.
• Progression is now on by default, as it is a stable feature and a significantly more rewarding gameplay loop than with it off.

Note that this will NOT change your existing settings if you already have MilPDA installed. These changes are just the defaults for new installations. I highly recommend you try them, however!

NEW IN 1.9:

• New Progressive feature - Temporary Network Access: When enabled, unlocking access to a faction's GPS data is only temporary--sooner or later they will figure out what's going on and change their access codes. When that happens, you have to unlock that faction again.
• Both the unlock thresholds and timeout values are fully configurable, so this can be used in a variety of ways to enable completely different kinds of gameplay. For example: try setting the unlock values very low, so that only one or two PDAs will unlock it--but have network access expire after a few hours. Instead of a long grind for a permanent unlock, this turns finding any one PDA (or however many you prefer) into a temporary tactical adavantage. Experiment to find the settings you like!
• This feature was accidentally shipped in 1.8.2 in an incomplete state, which did not work correctly and broke progression in other ways. My apologies!
• New Kill Tracker feature/fix: mutant corpses that have decayed or been looted by others will now be cleared from the map automatically. This was also shipped unintentionally in 1.8.2, but was and is fully functional.

FOURTH TIER OF PDA:

Designed by an unknown government or NGO for covert operations, the Milspec PDA incorporates all the features of the previous models--but also snoops cellular and network traffic in order to display an approximate location of hostile squads. Because zombified stalkers are still sometimes carrying PDAs or other geolocation devices, the Milspec PDA will even show their locations as well.

The catch? The cryptographic module is power-hungry, and consumes battery at twice the rate of any other PDA, even when you don't have it open. Additionally, this isn't exactly an off-the-shelf store brand you can buy or find lying around--you will have to build one yourself, and doing so requires some fairly sophisticated components, as well as a copy of PDA 3.1 to modify.

If you think it's imbalanced to be able to see special factions like Monolith, the custom blacklist has you covered. As for realism, consider that soldiers being located by their mobile phones, tablets, or other electronic devices is a real vulnerability in present-day battlefields. It's today's news, not tomorrow's tech.

But don't let the map icons become a replacement for situational awareness. They only show the location of squad leaders, not the guy flanking you--and mutants don't carry PDAs.

OPTIONAL BLACKLIST:

Don't think you should be able to see Monolith, Sin, or ISG with this? Enable the blacklist, and those three factions are excluded by default. You can also individually customize whether each faction shows up on the Milspec PDA--whether it's for game balance or lore reasons, to cut down on visual clutter, or even for special challenge rules like letting yourself gradually unlock different factions.

INTEGRATED AND EXPANDED KILTRAK(TM):

If you like Ishmaeel's Kill Tracker, that functionality is now fully integrated into the Milspec PDA. You don't have to use it, and you should download Ishmaeel's original mod to get their clever text descriptions--which are st_praise_chefskiss. But the feature is there if you want it, and a separate patch is no longer be required for Kill Tracker or GAMMA.

Body tracking is handled separately from body display, so you won't lose your map markers even if you lose PDA power, reload your game, change style, or toggle the option off and back on. Bodies cluttering up your map? You can now right-click on any body marker, see whose it was, and remove it.

Kill Tracker will now even track the kills of your companions and their squadmates, if you want it to--but you can always turn that off so that you only see your personal kills.

CUSTOMIZE MAP ICONS FOR BODIES:

Choose from five styles of icon for bodies on the minimap: a white X (credit to AlphaLion), a slightly larger white skull, or small/medium/large blue dots.

All of these changes take effect as soon as you apply them in MCM, so you can immediately see whether you like a style without restarting the game.

If you want more, try the Personal Adjustable Waypoint addon. It allows you to use PAW's large icon library or faction badges for body icons.

DEEPER CUSTOMIZATION:

Think PDA 1.0 should be able to see your own faction? Don't think any PDA should see enemies, but want all PDAs to mark bodies on the map? Customize each tier of PDA to your liking, individually toggling whether friendlies, neutrals, enemies, or bodies are shown, as well as whether that PDA obeys the faction blacklist.

INSTALLATION:

Just unzip the file directly into your Anomaly folder or install using a mod organizer, now with proper fomod support. You can manually move them over if you're more comfortable doing that, but there are a number of files in different places, and an organizer like MO2 is recommended.

A new game is not required, and removing the mod will not affect a game in progess--however, you must get rid of the PDA item first, as the existence of any item that is no longer in the config files can cause crashes.

UNINSTALLATION:

The "uninstall" option will delete any copies of the item in the player's inventory to avoid crashes. Do the following:

1. Take any existing Milspec PDA items and hold them in the player's inventory.
2. In MCM, check the "Uninstall Milspec PDA" option and apply.
3. Save and exit.

If you don't have MCM, then:

1. Take any existing Milspec PDA items and hold them in the player's inventory.
2. Save and exit the game
3. Open scripts\item_milpda.script and change "uninstall = false" to true
4. Launch the game once, load your character, then save and exit

It is then safe to uninstall this addon using MO2. I cannot assist with manual uninstallation.

ALTERNATE ICONS:

The default icon for this item is based on the style of icons in the Cr3pis pack. If you prefer the look of the vanilla anomaly PDA icons, I have included a version you can use. To to so:

1. Open configs\items\items\items_milpda.ltx in a text editor
2. Change the value for "inv_grid_x" from 0 to 1
3. Save and exit

The MPDA will now use an alternate inventory icon based on vanilla Anomaly.

There is also a third icon option, made to look like the Milspec PDA in the addon's logo image. If you want to use it, change inv_grid_x to 2.

The default styles include the four chevrons in the lower right to denote a tier 4 item. If you don't like these indicators, you can turn them off in this same file. Change inv_grid_y from 1 (has tier indicators) to 0 (no indicators).

GAMMA uses Cr3pis icons, but with a different style of rank pip. If you want this style, change inv_grid_y to 2.

Finally, there is now a Maid-style icon, which has an X-value of 3, and the same Y-value options of 0-2 for the rank pips.

CONFLICTS:

This mod uses the monkeypatch script workshop_autoinject.script to inject a new crafting recipe, a tool which is also used by various other mods. I am only using the basic unaltered functionality of adding or removing a recipe, so if you already have this file from another mod, it shouldn't matter whose you use.

If you have GAMMA or Ishmaeel's Kill Tracker installed, please load this after Kill Tracker.

If you are using vanilla, unmodified exes, and have therefore installed the option that replaces map_spots_relations.xml, this mod will conflict with any other that modifies the same file.

However, this conflict is extremely easy to resolve, and instructions are included in the file. It should be fairly simple, but all of this is provided "as-is", and I cannot support the legacy version or assist with troubleshooting merge issues.

The file zzz_sim_squad_scripted_milpda.script is a monkeypatch for sim_squad_scripted.script that overrides sim_squad_scripted.show in order to take over handling of squad mapspot visibility. It is unlikely to conflict with anything that does not modify that specific function, but I do not play or test in Warfare Mode and cannot provide support for issues in that mode.

Everything else should get along fine; the scripting and assets are all self-contained.

KNOWN ISSUES:

Localizations are only complete for English and Russian, and the RUS localization may have errors.

Several users have very kindly provided partial Ukrainian and Spanish localizations, which are now some versions behind. As usual, I'm happy to add translations if anyone provides them.

CHANGE LOG:

1.11.1: Minor patch to fix squadmate killspots not appearing.

1.11: Now using DXML--if supported--to load mapspots instead of replacing map_spots_relations. Added options for when to show or hide victim and killer names on body mapspots. Added progression gain multipliers for all supported PDAs. Adjusted progression defaults across the board for balance.

1.10: Re-structured install folders so that the DLTX Crafting option is on by default, and zzz_ui_pda_npc_tab_milpda.script is only included in the DLTX-PDASpawns optional install. It was previously included in the main install, which was the cause of most crashes from the previous version. Fix for Progressive mode's Gain on Read option not granting progress. Fix for duplicate crafting recipes being added. Added MCM option to only gain progress from decrypted PDAs, on by default. Added option to only gain progress if you disassemble the PDA, which ignores decryption. Added MCM option to control verbose logging. Fixed missing localization strings in MCM.

1.9.7: Fix for nil value crash when right-clicking on empty map space with modded binaries.

1.9.6: Various fixes for Progressive Squad Visibility. MCM values should now load properly, and a DLTX patch is included that will allow Sin, ISG, and Renegade stalkers to drop PDAs. Also included is a fix for a vanilla bug with NPC PDAs disappearing in 2D PDA mode.

1.9.5: Fix for unintended display of progression notification messages when Progressive Squad Visibility is disabled. This was purely cosmetic, and had no functional effect on the feature.

1.9.4: Fixed a rare crash with Sin storyline scripted squads. Added faction validation to all entry points; it should now be virtually impossible for a crash to occur from an invalid faction. Refactored blacklist code, should be invisible to users.

1.9.3: In my haste to get the crash fix posted, I somehow swapped the order of two lines in the script, causing it to fail. This has been corrected. Sorry!

1.9.2: Further checks for nil values when something calls this script with an invalid faction. Added logging to make similar issues easier to catch. Updated UKR localization for latest strings.

1.9.1: Added checks for some nil values that should never be possible, but which can cause a crash if they happen. Updated RUS localization to 1.9.1.

1.9: Added (and fixed) Temporary Network Access, allowing factions to revoke access to their GPS data after a configurable delay. Added automatic clearing of decayed/looted mutant corpses.

1.8.2: Fixed NPC PDAs being counted more than once for progress on game load. Accidentally shipped pre-release versions of Temp Network Access and the mutant corpse fix.

1.8.1: Hotfix for crash when looting a PDA with missing metadadta. Only ish_kill_tracker.script has changed. Also updated RUS localization with all current strings thanks to leeviathan.

1.8: Added Progressive Squad Visibility, which provides a system for gradually unlocking access to each faction's GPS data separately by looting their PDAs, with MCM support. Some refactoring and other minor internal changes.

1.7.4: Fixed possible crashes and body marker removal issues. Separated icon settings for player and non-player kills. New PDA icon rank pip style. Now monkeypatching sim_squad_scripted rather than replacing sim_squad_warfare.

1.7.3: Added integration with Personal Adjustable Waypoint, enabling you to use PAW's icon library to control body markers.

1.7.2: Fixed the autoclear on loot not working under certain circumstances. Added RUS localization from leeviathan.

1.7.1: Added a check that should prevent crashes when checking bodies that were killed by the environment (e.g. an anomaly) rather than a living thing.

1.7: Added option to show all bodies on the map, not just kills from you or your companions. Added new icon option with pips showing device tier. Added option for markers to not auto-clear on interact. Added marker expiration after an hour, many internal changes.

1.6: Fixed possible crash when equipping looted NPC PDAs, as well as a few other edge cases. Fixed body markers not being cleared on interact--you can still always right-click on them to get the option to remove them manually. Kill Tracker will now optionally track and display the kills of your companions as well. Added proper fomod installer support.

v1.5: Fixed crashes when using unknown PDAs from other addons, and added instructions to the script for how to support those third-party devices. Fixed crash when killing mutants. Body tracking now persists across saves and loads. You can now right-click on any body and click on the option there to remove its marker.

v1.4: Fixed Kill Tracker toggle not always working as expected. Kill tracking options can now be toggled on the fly; bodies will appear and disappear or change icon immediately after you apply MCM changes. New icon styles added for bodies on minimap.

v1.3: Fixed inability to swap batteries or use PDA hotkey. Added granular customization of what mapspots each tier of PDA can see, both in MCM and with easily-edited values in the script. Fully integrated Ishmaeel's Kill Tracker. Debug logging is now off by default, and controllable in MCM. Added optional third icon style based on the Milspec PDA logo.

v1.2: Added faction blacklist. Fixed issue that could cause duplicate crafting recipes to be added.