Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.
WARNING: fixed the autoupdate config key. It was previously named "github" it is now named "updateURL".
WARNING: fixed the config key "behindTheLoock" to "behindTheLock" so please do not copy blindly your old config file...
Features
Colored background for keys and keycards according to which map they belongs to.
Maps, Extracts, Quests and Loot information in the item descriptions.
Possibility to rename all keys to add a custom prefix based on the map they "belong to".
Key colors:
A useful key:
A junk key:
{
// if true, the mod will try to pull the latest db files from the given URL
"enableAutoUpdate": false,
// if enableAutoUpdate is true this url is used as a base to find the repository location
"updateURL": "https://gitlab.com/flir063-spt/betterkeys-ng",
// allow the mod to color the background of your keys
"backgroundColor": true,
// allow the mod to add more information about the keys in their description
"descriptionInfo": true,
// keep the vanila yellow marker for certain keys
"yellowMarkedKeys": false,
// allow the mod to indicate if the key is required for a quest
"requiredInQuests": true,
// allow the mod to indicate if the key is required for certain extractions
"requiredForExtracts": true,
// allow the mod to add tips about what you can find behind the locked door
"behindTheLock": true,
//if set to false this allows to NOT use a color for junk keys
"enableJunkColoring": true,
// if you want to have all key short names prefixed with standardized to letter codes
"shortNameInfo": false,
// if shortNameInfo is true, you can configure your Prefixes here, no effect otherwise
"prefixes": {
"Factory": "FC",
"Customs": "CS",
"Woods": "WD",
"Shoreline": "SL",
"Interchange": "IS",
"The Lab": "LB",
"Reserve": "RB",
"Lighthouse": "LH",
"Streets of Tarkov": "ST",
"Ground Zero": "GZ"
},
// background colors use basic colors that work with vanilla
// BUT if you install https://hub.sp-tarkov.com/files/file/1509-color-converter-api/
// on your client machine you can use HTML color codes
// like
// Customs: #964B00,
// Woods: #00FF00,
"backgroundColors": {
"Junk": "black",
"Factory": "green",
"Customs": "blue",
"Woods": "tracerGreen",
"Shoreline": "orange",
"Interchange": "tracerRed",
"The Lab": "tracerYellow",
"Reserve": "violet",
"Lighthouse": "red",
"Streets of Tarkov": "green",
"Ground Zero": "blue"
}
}
Display More
-
Version 1.3.12
- flir
- 926 Downloads
This is the full Russian translation release
- Added a mechanism to translate the junk key description
- Added a description in russian for junk keys. thanks to s3nn0m0
- Changed the RU translation for 'behind the lock' to Внутри. Thanks to eugenix
-
Version 1.3.11
- flir
- 426 Downloads
- Added provocation quest and Saferoom Exfil extract info on keycard "Object #11SR keycard"
Thanks go to Auvergne on this one!
- Added JSONC support to allow for useful comments in the config file
- Added possibility to prefix all key shortnames with a configurable prefix.
The config entry to activate the option is `shortNameInfo`.
Then you can choose the prefix for each map in the config file using the entry named `prefixes`.
This change comes from DeadW0lf who has been added as a co-author on this mod
Default values are:
JSON: config.json
Display More// if you want to have all key short names prefixed with standardized to letter codes "shortNameInfo": false, // if shortNameInfo is true, you can configure your Prefixes here, no effect otherwise "prefixes": { "Factory": "FC", "Customs": "CS", "Woods": "WD", "Shoreline": "SL", "Interchange": "IS", "The Lab": "LB", "Reserve": "RB", "Lighthouse": "LH", "Streets of Tarkov": "ST", "Ground Zero": "GZ" },
-
Version 1.3.10
- flir
- 1.3k Downloads
- Allow to choose with configuration entry `enableJunkColoring` if
you want to have a background color on the junk keys or not.
-
Version 1.3.9
- flir
- 306 Downloads
- Removed the hard coded way of choosing the junk key color. Now this color
is configurable in the config file under the "Junk" keyword. See config file
for details. Default value in the provided config file is still "black"
- Successfully tested support for Color Converter API, this means
you can use html color codes in your config file as long as you have this
client mod installed. Be aware that removing the color mod and having html color
codes in your config will NOT throw errors during server start but will
make the client crash during start with an error message about JSON color
conversion failures. In this case either remove all color codes from your
config file or reinstall Color Converter API
-
Version 1.3.8
- flir
- 70 Downloads
- Really fixed the auto-update feature. The gitlab transition from github meant
we had to change the URL formats to get to our files. I actually tested this
with SPT 3.10.5
-
Version 1.3.7
- flir
- 216 Downloads
- Fixed the auto-update feature that was still trying to find files inside an old server dir
- Chinese translation thanks to a Merge Request from ZHAY10086
-
Version 1.3.6
- flir
- 304 Downloads
- Fixed the download URL for the auto-update feature
- reviewed all keys with a script that downloads keys from the wiki: all the 145 wiki keys are present in our DB!
- added tooling to compare with 'Expanded Task Text' database to find missing keys on both end, and found some missing keys in ETT (proposed help there)
-
Version 1.3.5
- flir
- 625 Downloads
The "Customs" release:
- Woods: Shatun's hideout key NOT needed for The Huntsman Path - Woods Keeper, but added info about possible weapons behind the lock
- Customs: Military checkpoint key is needed for 'Trust Regain' quest
- Customs: Added the Factory emergency exit key
- Customs: Dorm room 315 --> added possible weapon spawn (FN SCAR-H 7.62x51 assault rifle)
- Customs: Dorm overseer key --> added possible weapon spawn (modified FN SCAR-H 7.62x51 assault rifle or modified Desert Tech MDR 5.56x45 assault rifle)
As always: please provide feedback on any error, missing info missing key or whatever... Happy escaping!
-
Version 1.3.4
- flir
- 385 Downloads
This is the "Lab" release, (with only one key on lighthouse) :p
Reviewed all Lab keycards and updated our db :
- Labs: add the TerraGroup Labs residential unit keycard
- Labs: weapon testing area key is now required for Following the Bread Crumbs quest
- Labs: manager's office room key is now required for Following the Bread Crumbs quest
- Labs: keycard Green NOT necessary for quest Colleagues - Part 3 anymore (according to wiki)
- Labs: keycard Blue NOT necessary for quest Colleagues - Part 3 anymore (according to wiki)
- LightHouse: Police truck cabin key updated possible loot according to wiki
-
Version 1.3.3
- flir
- 1.1k Downloads
Added Polikhim factory keycard in the database (New room and key added in 0.15), needed for Jaeger's quest: Dragnet
flir Author
Hello all,
With the 1.3.12 release I added a mechanism to translate the last part that was not localized: the junk key description. If someone would be kind enough to provide the Chinese translation for this one sentence we would have a fully translated mod in Russian AND Chinese.
I would also gladly accept translations in other languages if someone is interested to provide them.
To do so just copy the locales\en.json to locales\<youlangcode>.json and translate all the strings in there, then send me the resulting file so I can add it the mod! Easy!
Happy escaping!
Flir
Kataris
Icons don't seem to be coloring based on map for me, but the descriptions are there. Is this because I'm using Item Info mod, and that's overwriting the icon coloring?
flir Author
I don't know "item info" mod, can you point it to me ?
It could maybe be a conflict with another mod if that mod changes the background color of all items.
Maybe try to change the load order to have better keys loaded last...
Kataris
Sure thing, here you go! Item Info
I tried modifying load order to have yours load after also, that didn't work.
Kataris
I got it to work. Item Info has a config option that makes it essentially always load last, I disabled that.
flir Author
In fact you could also choose to keep item info background color and to use the prefix option in my mod to have a special prefix by map on all key names... This would get you the best of both worlds :p
Kataris
Ooh, I forgot about that option. I think I might do that instead. Thank you!!
Auvergne
object #11sr keycard is required for saferoom exfil extraction but mod has no info about it
flir Author
Got it! Thanks a lot for the report. I also added a missing quest (Provocation) on the same keycard. Please test release 1.3.11 :p
imacrinkle
excited to see this updated with colab from DeadW0Lf
flir Author
v1.3.11 contains changes coming from him: shortname prefixes for keys and keycards.
This is an option that is false by default, you need to turn it on in the config file if you want it.
imacrinkle
thanks king

ViP3R_76
[betterkeys-ng] Error checking for updates: SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
If you have auto-update enabled.
flir Author
Ok I'll need to revisit this one. I have an idea of what is going on it should not be too long. Deactivate the auto-update feature for the moment, i'll fix this soon.
flir Author
OK I released 1.3.7. Can you try ? I don't have access to SPT right now to confirm the auto-update feature is fixed.
ViP3R_76
[betterkeys-ng] Checking for updates: user/mods/flir-betterkeysng/db
[betterkeys-ng] Checking for updates: user/mods/flir-betterkeysng/locales
[betterkeys-ng] Error checking for updates: SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
With 1.3.7
flir Author
Thanks for the report I'll have to check tomorrow when I have access to a machine with SPT on it... sorry
flir Author
I nailed this one in release 1.3.8
flir Author
Hello all,
I have written a script to compare the fandom wiki with my database and I can happily announce that the 145 relevant keys from the wiki are present in our database...
I have one "missing key": Company director's room key, which was introduced in Tarkov 0.16 and is thus not yet present in SPT 3.10.x
I have excluded the following keys because their corresponding places are always open, they are therefore considered "garbage":
As always: In the event you find something amiss please send a message my way so I can fix it. Cheers!
flir Author
Updated to 1.3.5 after a review of all Customs keys... Enjoy!
flir Author
Just did a 1.3.4 release. As always please report any missing key or wrong/incomplete info so I can fix it. This is a fully manual process with no automation whatsoever and can be quite lengthy. Happy escaping to all!
KingLich
Thanks for keeping this up to date. Much love!
flir Author
Np! If you ever encounter an error in the descriptions of this mod please report so I can fix it
yaqub
Doesn't seem to be 100% accurate, polikhim for example.
flir Author
Thanks for the report! This key was added in 0.15 alongside a new room in factory and I missed it. I added this key in the 1.3.3 release which is now online. Cheers!
EugeniX
Сделал описание на русском отредактировав файл "en" user\mods\flir-betterkeysng\locales
{
"_version": "1.3.1",
"none": "Нет",
"map": "Локация",
"requiredInQuests": "Требуется для квеста",
"requriedForExtracts": "Требуется для выхода",
"behindTheLock": "Внутри",
"Jacket": "Куртка",
"Toolbox": "Ящик для инструментов",
"Drawer": "Деревянный ящик",
"Crate": "Выдвижной ящик",
"SportBag": "Спортивная сумка",
"Medbag": "Медицинская сумка",
"PC": "Системный блок",
"Grenade": " Ящик для гранат",
"DeadBody": "Труп",
"Ammo": "Ящик для патронов",
"Weapon": "Оружейный ящик",
"CashReg": "Кассовый аппарат",
"Safe": "Сейф",
"LooseVals": "Драгоценности",
"LooseCash": "Деньги",
"LooseLoot": "Разный лут",
"LooseGear": "Снаряжение"
}
flir Author
Hey EugeniX,
I have prepared an 1.3.2 release with your translations it is ready to D/L. Cheers!
poppduder
Something is driving my crazy. this mod is among several that aren't working for me and I can't figure out why. There must be some sort of conflict I'm not finding, as - installing as normal - I get no colour coding or item description changes for keys. Weirdly I'm having the same issue with FOV fix and More Checkmarks. Is there a dependency that I'm not seeing?
flir Author
No dependency that I know of. I also use More Checkmarks without issues, but I never tried FOV fix.
This mod is a simple server side mod with only some javascript functions. We implement the "IPostDBLoadModAsync" interface to manipulate objects from the database after it has been loaded. (I assume that More Checkmarks has the same kind of implementation, never looked at the code though)
If the mod loads properly you should see in your server console something along the lines of: "[${_package.name}-${_package.version}] Added info and background colors to all keys/ keycards"
If you don't see this it means the mod did not execute its main function properly. Can you confirm what you see at the server console ?
On my server after the mod finishes working I can see:
[betterkeys-ng] Loaded: Customs
[betterkeys-ng] Loaded: Factory
[betterkeys-ng] Loaded: Ground Zero
[betterkeys-ng] Loaded: Interchange
[betterkeys-ng] Loaded: Lighthouse
[betterkeys-ng] Loaded: Reserve
[betterkeys-ng] Loaded: Shoreline
[betterkeys-ng] Loaded: Streets of Tarkov
[betterkeys-ng] Loaded: The Lab
[betterkeys-ng] Loaded: Woods
[betterkeys-ng-1.3.1] Added info and background colors to all keys/ keycards
Regards,
flir
poppduder
I tried reinstalling it again, and I do see those. Everything works now. I wasn't paying close enough attention to what I was removing to realize what was conflicting with it. Thanks for your help, sorry I can't be of any.
flir Author
OK,
I updated the download link again since I managed to produce build artifacts inside the source repository and auto publish them to a "package registry". In case some people search in the future:
https://gitlab.com/flir063-spt/betterkeys-ng/-/packages
this is the registry page where all the releases will be auto uploaded each time I push a tag to the repository.
the v1.3.1 release URL has been updated to use this new feature instead of the cranky separate repository I had initially setup to have a downloadable file ASAP.
Let me know if any issue arises.
Let's hope we're good with the logistics and I can go back to running on shoreline to make Prapor happy :p
flir Author
Got it!!!
I have setup a gitlab account and made it public...
D/L link and source code link has been updated to reflect this.
I'll clean up the mess gradually... Thanks for your patience and please report any missing key with as much details as possible so I can add them to the database :p
Happy escaping all.
Flir
flir Author
My github account has been "flagged" and removed from public view. The support says it may take up to 7 days to respond :p
I'll create a gitlab account (already try google and they dont send SMS to my phone apparently so I can't create a new drive account with them ...)
I'll give more info as soon as I complete the transfer to gitlab...
arsonistsarehot
Thanks for your time and effort! I'm looking forward to using this later.
cofffin
Not found.
flir Author
Please try again, I updated the D/L link after finding out github had shadow banned my account for whatever reason ...
flir Author
It may be github flagged the account I created for this mod... I'll see with them
GMAK3R
do a google drive
flir Author
Will do that later tonight ...
flir Author
Link has been updated after moving to gitlab... Please retry.
flir Author
https://github.com/flir063/betterkeys-ng
I tested it in another web browser and I confirm repository is public
Dziamgo
no its not :c
hymenaei
it aint
flir Author
Well it IS public but github flagged the account I created as suspicious and thus returns 404 to anyone but me
Will do a google drive later tonight ...
flir Author
Moved to Gitlab. Please retry the download link. It seems to work this time (hopefully).
flir Author
Hum strange GH is public ...
startanew
hmm just says file not found when redirected to github and the github link looks to be broken
flir Author
Please retry. I had to move to gitlab after finding out github had shadow banned my account.
DrakiaXYZ
Your repository is private, which means your download and source links are inaccessible
flir Author
Please retry. I had to move to gitlab after finding out github had shadow banned my account.
TheW0k3Bear-801
When I click on the download link, it says "not found"
flir Author
Please retry. I had to move to gitlab after finding out github had shadow banned my account.
Dirtbikercj
Github is private
flir Author
Please retry. I had to move to gitlab after finding out github had shadow banned my account.