Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.
PLEASE REINSTALL THE MOD WHEN UPDATING TO 3.9.0, THERE HAS BEEN SOME FILE CHANGES THAT IS NON-COMPATIBLE WITH OLDER VERSIONS.
There will be NO support from me in the SPT HUB (#general-support), I have removed myself from the discord server for the time being due to "circumstances", and probably will not return any time soon. Please report your bugs and problems here in the comment section, or ping me on discord in some other SPT modding communities.
Features & Changes
- Colored background for keys and keycards according to which map they belongs to.
- Maps, Extracts, Quests and Loot information in the item descriptions.
-
**[New]** Add description for junk keys (previously keys that are not used anywhere are not indicated as such by the mod)
-
**[New]** All features can be toggled on/ off in `config.json` (see below).
- **[Updated]** Auto-update from GitHub: key information and locales can be updated without redownloading the whole mod.
-
**[Removed]** Key Tier List (I don't think it was actually enabled anyway).
Please refer to the original mod for more/ legacy descriptions: Better Keys [Most of the code have since be rewritten, but the idea of the mod is the same]
config.json
{
"enableAutoUpdate": false, // enable auto update from GitHub (disabled by default)
"backgroundColor": true, // toggle background colors
"descriptionInfo": true, // toggle item descriptions
"yellowMarkedKeys": false, // when true, marked keys are always yellow (vanilla behavior)
"requiredInQuests": true, // Toggle Quests Info
"requiredForExtracts": true, // toggle Extracts Info
"behindTheLoock": true, // toggle Loot Info
"backgroundColors": {...} // Please refer to config/README.md
}
-
Version 1.3.0
- maxloo2
- 7.4k Downloads
- Updated to SPT 3.9.0
- Updated database with new keys
- Updated "Behind the Lock" texts
-
Version 1.2.3
- maxloo2
- 4.2k Downloads
Fixed: Extracts not showing in item description due to a typo.
-
Version 1.2.2
- maxloo2
- 751 Downloads
Fixed an issue in which "Underground parking utility room key" shows "undefined" loot due to a typo (thanks keeboz!). You don't need to redownload the mod if you use auto-update.
-
Version 1.2.1
- maxloo2
- 1.3k Downloads
Fixed the problem that config files not being in the correct folder. Sorry for the bug!
-
Version 1.2.0
- maxloo2
- 386 Downloads
1. Fully functional auto-update feature.
2. Updated Chinese locales.
2. Removed now unused client plugin.
-
Version 1.1.0
- maxloo2
- 720 Downloads
NEW FEATURE: added configs for ALL features, check updated mod description for more information.
FIXED: Woods keys are not correctly labelled.
- feat: update _versions.json
- fix: missing newlines in added key info, extra newlines before item description
- fix: background colors not applying to keys
- feat: allow users to toggle enable for backgroundColor and descriptionInfo, some minor refactors
- fix: add missing entry for Woods in _constants.json -
Version 1.0.1
- maxloo2
- 698 Downloads
- feat: add "rusted bloody key" to list of marked keys
- fix: fix marked keys not having yellow background due to mistake in if-logic
-
Version 1.0.0
- maxloo2
- 116 Downloads
Lukalake
Thank you for your work! Really an awesome mod!
Jahjo
Hey Max, I'm using this with the color converter API mod. I changed all the color values in config for maps to custom hex values and it seems to be working just fine (noticed in the README, you said you weren't sure if it worked). I'll keep you updated if anything breaks, but it's working just fine with that and all my other current mods .
FEATURE REQUEST:
Any way you could add the tier list back in, but maybe just have it in the item description instead of overlaying the graphic?
QUESTION (probably dumb):
Is there a way to change the junk key color background in the config? If not, would it be easy to implement that? Would be nice to have control over that too while I'm changing around the background colors per map to my liking!
Cheers, and thanks for the mod!
maxloo2 Author
I don't think I will add the tier list back since I want to keep this server-sided, and honestly I don't have time to work on a new client-mod especially since I have moved away from SPT for quite a while now. I will hopefully keep this mod updated but I am only checking in once in a while.
For key colors, it would be easy to add the config but I guess I will have to work on it together with the next update (3.10 maybe?), just don't really have time to work on tarkov/spt stuff too actively and I have put aside my other mod ideas as well.
Jahjo
No worries, I didn't realize you weren't actively modding rn. Thanks for the response though, and hope all is going well outside of SPT for you
UnTaLk
I noticed that on the config.json file, one of the parameters says: "behindTheLoock", is it a typo for "Lock" ? Just to clarify, thank you.
maxloo2 Author
Thanks for letting me know!
UnTaLk
No problem ☺️ does the setting work anyway with the typo ? 😂
maxloo2 Author
Yes it still works, I replaced the word across the code so the same typo is everywhere XD
Meryticus
Has anyone had any luck using the ColorConverterAPI to allow custom background colors for they keys? I installed the API then attempted changing the colors in the Better keys config.json to hex but it won't work just spits out errors.
maxloo2 Author
Can you provide the error logs? Just the relevant ones is fine, or you can pastebin the whole thing if you are not sure.
Personally I don't use custom colors because I am lazy, so I have not really tried my mod with ColorConverterAPI yet, but I do see it being needed as more maps are added since we already have repeated colors.
I will investigate this when I have more time.
Meryticus
Theres no error log or even an error in the server window. The error it throws is on the menu in-game just after it loads the profile data. It goes as follows
in response to http://127.0.0.1:6969/client/items;
Failed to read JSON value for TaxonomyColor.
TokenType-> String, Value -> "66ffb3"
66ffb3 is the value I had set for The Lab, but if I switch it back it'll throw an error for a different one. After a little bit of testing what I found is I can use any hex code color that doesn't contain letters, only numbers. This will work but for some reason the colors don't appear as they're supposed to. For example I had set customs to 800000, which should be a maroon color, but instead it had a blue background.
Meryticus
Actually just solved it, I was missing the "#" before the hexcode. I was using 66ffb3 instead of #66ffb3.
ColorConverterAPI works perfectly with this mod if you use it correctly lol. Thank you for the response though I appreciate the timeliness.
maxloo2 Author
Great to hear that!
Luladjiev
There is an error when starting the server, this is for version 3.8.3:
SpaceGhost
Same here. It looks like something in the mod itself grabs updates, and then broke.
maxloo2 Author
it is probably because the mod fetches the latest 3.9.0 item list but your game doesn't have those items, causing error. you will have to disable autoupdate and download again the 3.8.3 mod for the old db. this is also why i have disabled autoupdate by default in the latest version.
keep in mind this will not be fixed now since i don't plan to support old SPT versions, but i might look into it to see if there is any way to prevent the error in future SPT versions.
xPurpHazex
Did what maxloo said, in the config json, I set enableAutoUpdate: true into false, launched the sever back up and the error went away
SandProlo
Thank you so much for the update, love this mod!
Killins
The description does not indicate which keys are used for which output.
( "requiredForExtracts": true, )
in this case there are 2 keys:
591afe0186f77431bd616a11
5448ba0b4bdc2d02308b456c
maxloo2 Author
Sorry about that! I made a typo in the code, should be fixed in the latest update!
Killins
Version 1.2.3 did not help
maxloo2 Author
I just checked again and I think I uploaded the wrong file on GitHub, sorry about that, can you try downloading again?
Killins
Now everything works , Thank you
llIBossIll
I'm not sure what the issue is exactly, The mod seems to work just fine but I keep getting this error when I load up the server. I've read through the other comments and tried other solutions I've seen but alas it persists. Any information would be super helpful, Thanks for the great mod!
ModLoader: Error when loading async mod: Item 627a137bf21bc425b06ab944 still not found in base cache after regeneration
Error: Item 627a137bf21bc425b06ab944 still not found in base cache after regeneration
at ItemBaseClassService.itemHasBaseClass (C:\snapshot\src\services\ItemBaseClassService.ts:110:23)
at ItemHelper.isOfBaseclasses (C:\snapshot\src\helpers\ItemHelper.ts:94:42)
at C:\SPT 3.8.3\user\mods\maxloo2-betterkeys-updated\src\mod.ts:167:22
at Array.filter (<anonymous>)
at Mod.main (C:\SPT 3.8.3\user\mods\maxloo2-betterkeys-updated\src\mod.ts:162:64)
at Mod.postDBLoadAsync (C:\SPT 3.8.3\user\mods\maxloo2-betterkeys-updated\src\mod.ts:36:12)
at PostDBModLoader.executeModsAsync (C:\snapshot\src\loaders\PostDBModLoader.ts:63:60)
at processTicksAndRejections (node:internal/process/task_queues:95:5)
at PostDBModLoader.onLoad (C:\snapshot\src\loaders\PostDBModLoader.ts:31:13)
at App.load (C:\snapshot\src\utils\App.ts:56:13)
maxloo2 Author
I have no idea what this is honestly... I think you need to ask on SPT discord because this is something I have never seen before
llIBossIll
Hey, at least I feel better knowing I'm not just crazy! As I said, the mod works just fine and throws no other errors during gameplay or any other time than just at the server startup. If I manage to figure out whats causing it ill update you here!! Thanks again.
CrowDz
i have the same thing, ye is work fine
maxloo2 Author
I have seen mentions of this error from the SPT devs on discord and they said the issue was fixed back in 3.8.1, other than that it seems to be a harmless error that not just only my mod have
keeboz
for some reason i'm not seeing any description on the keys stating what's behind the lock like in photo 2
it will change the colors, show what map it's for/required in quests but it does not show behind the lock info.
this is the only key mod i have installed, it may be conflicting with MoreCheckmarks because it changes the color of the FiR icon? not sure.
EDIT: setting enableAutoUpdate to false and backgroundColor to false fixed the issue. although "Underground parking utility room key" shows "undefined" as one of the loot options in Behind the Lock.
maxloo2 Author
Are you using the latest verison? If you are upgrading, have you cleaned the old files and folders from the old versions? Did you read all the notices on the overview page and this page?
Update: Sorry I didn't see that you mentioned MoreCheckmarks, but I also use both mods together so I am pretty sure they work.
I am not actually not too sure about why you just dont't see the loot information but everything else works, it is indeed an interesting problem, but I will need more information on that since I will need to be able to reproduce the problem myself in order to be able to find a fix for it.
maxloo2 Author
For the Underground parking utility room key, it was due to a typo in the key db, it has since be fixed, if you enable auto update you should get the latest db files. I will upload a fix here later but if your auto update is broken you probably need to update the mod anyway.
keeboz
yes i have the latest version, morecheckmarks mod also uses the color api so i had to disable the color in this mod to make it work properly, thanks for keeping it updated it's a great mod
maxloo2 Author
Again, I have More Checkmarks and Color Converter API running alongside this mod, nothing specific was required to make them work together.
More Checkmarks, as far as I understand, only adds checkmarks and the hover information, and Color Converter API shouldn't break anything, in fact, I suspect that my work actually works with the custom color, which you can configure in config.json as well.
Even if you have mods that edit the item background color or description text, in theory my mod only overwrite previous edited color values and add extra information to item description, in short, it depends on your mod load order but nothing should conflict... I put my bet on some other mods doing something stupid
keeboz
probably. but atleast it works now!
HeavyComponent
I don't know what this is but it just happened.
[UNHANDLED][/BetterKeys/GetInfo]
tyverkyz
its happen to me to, and you have to eliminate the betterkey in the carpet bepInEx and it disappear the error
maxloo2 Author
Remove SirTyler-BetterKeys.dll from your /BepinEx/ folder and the problem will be fixed.
Explaination: I included the client plugin in the earlier versions since I was still figuring out what it does, once I figured that the client plugin was not requried I have sinced removed it including the server route /BetterKeys/GetInfo, therefore if you still have the client mod it will send a request to the now non-existent route.
LUNACVLT
turned auto update to false to prevent the space at line 3 error
maxloo2 Author
Hi! Thanks for the feedback, have you followed the instructions pinned here? Are you playing on a fresh install of the latest version of this mod? Is the mod still working despite the error logged? I cannot reproduce the problem myself, will need more information to investigate this error.
LUNACVLT
it was me updating to a new build a few updates ago, none the less this is voided.
new update all fixed. as always great work, keep it up dude.
claptraw
Hey there, I got an SyntaxError with the newest version 1.2.0 on SPT 3.8.3
Seems to be connected to the auto-update feature, the core functionality of the mod works.
maxloo2 Author
Hey, I think you still have the old client plugin installed, you will need to remove it, but otherwise the mod should work just fine.
mattybrown33
i'm getting the same thing. I dont seem to have any old "better keys" folders/files in mods or in plugins
maxloo2 Author
@mattybrown33 Besides the error log, does the mod still work? I am receiving reports of this problem but I have no idea how or why this is happening, since I cannot reproduce the problem myself, I cannot investigate for a fix for the problem
PS: Does the mod still work for you after showing the error? Or does it break everything else as well?
mattybrown33
I was getting this error in the console, the game would start but before getting to the main screen it would flag an error in game with something about the colour brown. I was told in discord to delete a colorapi plugin which I did but had also deleted your mod by then, everything is now working as it was but i haven't reinstalled your mod so can't say for ssure if that was the issue, sorry
mattybrown33
Update: I'm an idiot!
Re-installed you mod, works perfectly fine!
I didn't realise I already had another key colour coded mod installed which need the colorconverterapi plugin, have since deleted that because yours has more info, all working fine, my apologies, i'm an idiot!
netspyer
maxloo2-betterkeys-updated.zip\user\mods\maxloo2-betterkeys-updated has two config folders, config and configs
'configs' has the files needed, renaming 'configs' to 'config' fixed the problem.
FOXSTAR
true, good job mate o/
maxloo2 Author
My god how I made this stupid mistake Thanks for the feedback and sorry so much for the inconvenience.
maxloo2 Author
PLEASE READ MOD DESCRIPTION BEFORE YOU ASK ANY QUESTIONS.
READ MOD DESCRIPTION BEFORE YOU ASK ANY QUESTIONS, PLEASE.
READ THE MOD PAGE, I WILL NOT ANSWER STUPID QUESTIONS, PLEASE LEARN TO READ, THANKS.
- Updated: July 8th 2024
Reyson
new version same problem.Need delete from BepInEx SirTyler-BetterKeys.dll
Lucid
[UNHANDLED][/BetterKeys/GetInfo]
I get this every time i load, should i be concerned?
Solid-Rhoads
Looking at the mod.ts it looks like its just part of the auto-update function, because its targeting a url; that features probably not functioning properly. Rest of the mod seems fine.
Lucid
yeah i forgot to edit and say nothing was broken, haha took a nap instead... seems like everything is solid tho!
maxloo2 Author
I think I know why this is happening, I never updated the client mod since I am still learning about Unity modding, and when I refactored the code I changed the route name in the server code but not the client mod...
I have plans for rewriting the autoupdate part, so I guess since the rest of the mod is not affected, I will leave this problem for the next release instead of asking every one to redownload the mod. Thanks for all your feedback!
Reyson
1.1.0 why is this the case when launching the client?
LUNACVLT
This mod is shaping up nicely. keep up the great work.
Stonemountain
Thanks a lot maxloo. Would also love without background coloring.
TimmyGG
Could you possibly add an option to disable background colors? I love the added information, however.
Also, for the 'SSK' Key (Shturman's stash key), It states that it is junk.
Thank you for the update and the work that you've put into this.
IsaacSin
The same happens for the other Woods keys. Woods is missing from the list of maps in _constants.json, should be an easy fix.
maxloo2 Author
@IssacSin Good catch, I didn't even notice since there's only a total of 3 keys for Woods. Will work the fix right away.
@TimmyGG I will actually add configs for enbling/ disabling both descriptions and and background colors, thanks for the feedback.
Konefine
Holy moly updated finally!