Virtual's Custom Quest Loader 2.0.1

Please do not ask when mod authors will update their mods to v3.8.3. Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.

A mod dependency to assist mod authors with importing quests, images, zones and language files into the game with additional functionality and a GUI tool.

[tabmenu]


  • Version 2.0.1

    SPT-AKI 3.8.1, 3.8.2, 3.8.3


    Additions

    • Added a new option to the GUI Zone creation tool - Any Zones added by the loader can now be loaded back into the creation tool. This should assist modders with altering, fixing or viewing their already existing zones.

    (If you downloaded this and it had issues extracting, it's because it was compressed with 7zip and the windows extraction tool doesn't like it. I have fixed the download zip to counter this)

  • Version 2.0.0

    SPT-AKI 3.8.0


    Additions

    • The biggest one - VCQL now includes a client mod. This is for custom zones, with an included GUI tool for zone creation. Mod authors can now create / visualize custom zones for quests like 'place item', 'exploration', 'kill in area', 'launch flare' etc.
    • Added zone importing.
    • Added assort importing.
    • Added trader image importing.
    • Added quest date ranges (Thanks to shibdib for the pr).
    • Added Korean locale support.
    • Added a config option to allow all quests, even with a sideExclusive property, to be available to the user.

    Changes

    • Changed the side exclusive property away from 'side' to 'sideExclusive' as it was causing issues with outdated versions.


    Massive thanks to the SPT community for helping with this update and a special thanks to the following people in particular:

    • CJ - Supplying the client zone loading code, updated from Boop's API (Boop goated).
    • Boop - Original author of the Quest Zones API.
    • Groovey - Submitting a PR with the flare zone loading code.
    • Timber - Helping with materials / transparency / collision of unity objects for the tool.
    • And a special thanks to the mod authors who use VCQL and give me feedback!

    For a more in-depth view of the update, view the repository where I have more documentation.

  • Version 1.4.3

    Added support for side specific quests.


    Quests can have the "side" value set to either "Pmc", "Bear" or "Usec".


    EDIT: THIS FEATURE WILL CHANGE FOR 3.8.0, SEE MAIN PAGE.


    SPT-AKI 3.7.x

  • Version 1.4.2

    Updated package


    SPT-AKI 3.7.x

  • Version 1.4.1

    + Small fix to change the way the locales are obtained from the server, as some locales weren't properly matched and some would have missing lines.

    No need to update if you are using the English locales.


    SPT-AKI 3.6.x

  • Version 1.4.0

    - Didn't like the spaghetti code, so I re-wrote it all.

    - Mod no longer uses asynchronous methods - for mod creators that need to adjust quests from the server aswell.

    - Placeholder feature now checks individual locales, not the files that contain them.

    - Updated package to 3.6.x, will be compatible with 3.5.x however.

    - In most cases, users will not need to update to this version


    SPT-AKI 3.6.x

  • Version 1.3.0.1

    Updated Package to 3.5.8

    Works on 3.5.x

  • Version 1.3.0

    Added a feature to help when a locale folder does not have any files - locales from a predetermined placeholder locale (default is 'en') will be copied over instead.

    This is to allow locales without quest translations to be accessible in their language.

    (E.G. if a quest pack only has English locales then they will also be added to every other locale.)


    Package version is set to 3.5.7 but works on SPT-AKI 3.5.x

  • Version 1.2.0 for 3.5.5

    -Updated package.json to reflect new version.

    -All quest packs remain compatible.

  • Version 1.2.0

    AKI 3.5.x

  • I have seen a few users mention that quest zones sometimes do not work. Nothing has been reported so I am unsure if this is a genuine issue or user error. If you are sure that you have downloaded everything correctly, and you still cannot complete the quest, please comment the issue alongside your list of mods so I can look into it.


    Is it installed properly?

    For 3.8.0 and above, you will see 'Virtual's Custom Quest Loader' in user/mods AND you will see 'VCQLQuestZones.dll' in BepInEx/plugins. If you are missing the client mod (.dll), then the zones won't be loaded but there will be no error.

  • Moving forward, all current and new mods using VCQL will be required to link to this page, instead of including the download within the mod. This has caused confusion for users and creates more issues for support when out of date versions override others.


    This does not have to be immediate, however the next update from mods using VCQL should reflect this change.


    TLDR: VCQL should not be bundled with another mod.

    Thumbs Up 1
  • Should we replace VCQL with the version packaged with custom traders (like Lotus and Scorpion) or use only this version?

    • I've just checked the latest downloads for both of these mods and neither of them package VCQL. You should use the latest version where possible.

    • Maybe I'm confused - here's what I'm seeing.

      https://i.imgur.com/Uo0rxPb.png

      Is their VCQL additive to your mod?

    • Okay, I just looked into it. I was making an incorrect assumption here and was not installing the VCQL compatibility folder they package. Apologies for the mistake.


      What I'm presuming now is when we drop the user/mods folder into our SPT installation, and the specific trader mod asks if we want to overwrite, we select "Yes"? Scorpion had I think 4 overwrites, and Lotus had 114.

    • Yeah those are fine to overwrite. The files will be placed where they need to be. The overwrites are probably just duplicate folders actually.

  • Does anybody know, can i make a task for quest that affiliated to something in pmc hideout?

    for example a few tasks, that required an second level of workbench or third level of shooting range?

    Don't really want to affiliate it to hideout management skill, so if anybody know - i would like to know too.

  • Everytime i try to hand over a quest item it says quest handover error

    • More than likely an issue with whatever quest / trader mods you have installed. You will have to contact the mod author for the quest or jump in the discord for some help.

  • So I doubt it matters since you didn't mention it but does load order matter at all should I worry about it being before or after traders

    • Shouldn't matter, but just to be sure you can set the mod to load after your trader mods.

  • Hey, just one little question. Can we have some kind of GUI for easier quest making in future? It would be so nice to have it :)

    • I believe another author is working on a GUI tool for making / editing quests. I have attempted this in the past and it worked, but it got deleted by accident :(

    • dang, that's definitely sad.

      But still, having a GUI for this mod in soon would be pretty great, cuz me & my friend are making a large story mode that's not affiliated with original quests by BSG :)

    • Have you heard any updates about this GUI? If you can't get the other mod author to post their GUI I beg you to remake yours Virtual!

    • You can find updates on it in the discord, posted by 'Ru Kira'. You will probably have to ask them for more info as I've only seen snippets.

  • Hi, great mod! It is possible to create a quest in which you need to kill targets using specific ammo?

    • There's like a 10% probability that adding in the ammo type to the whitelisted attachments array would work, but you can give it a go. I haven't seen anyone get this working.

    • As expected it is not working that way. I think it is EFT limitation because even GamePanelHUD mod don't have option to display ammo that we used to kill. Thank you anyway!

      Thumbs Up 1
  • It always says the package.jsom is missing. Any tips what im doing wrong?

    • That indicates that you haven't installed the mod, or havent installed it properly. Within `/user/mods` there will be your list of mod folders. In each one, you should see a 'package.json' file. If you don't, then you have installed it incorrectly, or you have installed a mod that requires VCQL, but haven't yet installed the loader.

  • Thank you for making this mod! I am a Chinese player and I want to ask may I repost your mod to our website? Of course I will indicate the source and your name

  • hi, i'm getting an error.... quest handover error : condition not found or incorrect value qid:.... with the double agent quests when i go to hand in. any thoughts? sorry for 3.80 sorry my bad, forgot i copied the quest folder over from an older install. now i dont remember where i got the double agent questline. investigating now. sorry again to have wasted your time. found it, sorry again was using an old version of lavax's and your quest packs. will wait and see if new ones come up

  • Experiencing an issue where once I hit Level 10, I can no longer get past the first loading screen. When I remove this mod, it fixes it, but I was really looking forward to the extra content that this mod is required for. Is there any known fix to this?

    • This will be an issue with your mods that actually add the quests to the loader. I'd recommend to go through those mods and find which one has a bad quest or related bad data (like an assort).

    • I have tested it, and the issue even happens when there are no mods installed that add quests. The only time the issue gets fixed is when I take this mod out out of the load order. Are there any mods that you know of that have any sort of incompatibility with this mod?


      Edit: This is even happening when VCQL is the only mod in the load order

    • I got a fresh download of the mod and reinstalled it, that seemed to fix the issue

    • Very strange, I am happy you fixed it though.

  • Is it possible to add more than three new traders at once without blocking the traders with your character portait? E.g. I installed Artem, Mercenary and the three traders from A.E.S. and every trader after Jaeger+2 trader portraits is obstructed by my player info (Name, roubles, euros, my rep and character-portrait)

    Is there a scroll bar i didn't see or a keybind?

    • Self solved:
      You need to turn on intermediate trader screen in game options to see the necessary screen.

    • There is a mod for horizontal scrolling in that menu.

  • One question that I can't find any information for: can you install multiple custom quest mods at the same time? Like, if I installed two completely unrelated custom quest giver mods (for example, the "ultimate questing traders" mod as well as the "Maxim" mod) would both of them function, or would it just break everything?

    • VCQL is made to support multiple trader / quest mods. So if there is any issues between the two mods, it will be from their own traders, not the quests. Typically you are fine to install multiple trader mods.

  • hello im having the same issue as comment below, trying to install for the goblin king quests, iv got the trader on i can buy the items but im not getting any quests. when i load the server i get '0 custom quests loaded' im pretty sure iv followed all the steps correctly

    • So GK has a folder path going to Virtual's Custom Quest Loader which purely contains some quests and locales files. When you install VCQL first, then drop GK's files in, they will go straight to this location. I've checked GK's download and it worked first go for me. So I'd just double check that. Otherwise just manually put the files from GK into VCQL.


      Edit - I now see that rocka has fixed the download lol

    • yeah there was a folder missing thanks the reply and mod <3

  • I have an issue. So, custom traders (saria shop, goblin king and one popular girl trader that i've forgot the name) does not have ANY custom quests from them, it's literally just NOTHING which is sad(

    • See above and the latest comment on GK's comment section. I asked quite a few mod authors to change the way VCQL was bundled, so it's possible the folder structure was overlooked.

    • The other one I cant help with. Saria shop doesn't use VCQL.

    • Thanks, i'll try

  • Are you open to a PR? Or can I just share a modified version of this with my quests?


    I added the ability to add date checks to quests for seasonal things.

  • hello how 2 install mod

  • Gonna attempt to make a custom quest list with this, thanks!

    Heart 1
  • 99% it works on 3.7.1

  • Looks like this works with 3.7.0 with the custom traders and existing traders using the Custom Quests mods.

    Heart 1
  • When I use version 1.4.0 all locales in other languages become keys and when I revert back to 1.3.0 the locales of other languages can be read.

    Thumbs Up 1
    • Ahh yep. I'm grabbing the locales from the server, and some have different names. Thank you for reporting that, I'll update it shortly.

  • Thanks for the great mod!

    One question, if I want to create a repeatable quest, do I just set restartable to true?

    I created a quest and tested it, but after it is completed, it does not appear in the quest again.

    • Howdy,

      The 'restartable' value applies to quests that have a fail condition and determine whether or not the user can re-attempt a failed quest. There is no value to make quests repeatable and I believe they need to be put somewhere else in the files, separate from where the loader puts them anyways.

    • Thanks for the reply!

      I will try to see if I can create a pseudo repeatable quest by creating the same quest and relocating it.

      And if possible, please add a repeat feature to the mod.

      Thumbs Up 1
  • Just a quick note. I had to change the package.json on GoblinKing trader to 1.3.0 to get it to load after this latest update.


    Thanks for all the hard work you guys do!

  • Hi, can you tell me how to get rid of vanilla quests?

    • Aki_Data\Server\database\templates\quests.json


      Open this file and remove all the data within it. Back it up first.

      The only remaining values should be a set of { }

    • it didn't work, now an error pops up and the server doesn't start( ;(;(;(

      https://drive.google.com/file/…2D73W/view?usp=drive_link pls chek google docs

    • I'm sorry, it was a conflict of mods, now I can finally begin to completely rewrite all the quests, thank you. animedance2animedance2animedance2

      Happy 1
    • May I just ask a follow-up question to his which is probably obvious, but I just feel I need to ask, does the quest line break, if you remove a quest that is part of that chain, or does it just skip it as it does not even exist?

    • All quests have their pre-requisites listed. So if you delete a quest, you would also need to change any references to that quest for further ones. E.G. Gunsmith part 5 requires part 4 to be completed. I CAN delete part 4, but I would need to delete or change the quest requirement in part 5.


      If a quest is deleted that is part of a chain and not adjusted, the further quests just won't show up.

  • Heads up, on version 3.5.6 AKI this seems to be causing an overlay issue like seen here - https://imgur.com/a/aR0CCYi -


    Removing this mod fixed it entirely.

    • Hmm, I can't see any changes in the source material that would cause this. I can't test right now either so if additional people use it for 3.5.6 could you please confirm this. Thank you for letting me know.

    • Also, do you have any other mods that add either quests or traders?

    • I am using Priscilu, Ar shoppe, and gear gal. No other quest mods, but am using Drakia's task list fixes. Although I did remove task list fixes and the issue remained.

    • Ok, looks good. Did you only have VCQL? No other quest files within it?

    • At the time of the error yes, just VCQL and your quest mod. Since the error I did a full wipe of my mods and started fresh, using VCQL and your quest mod, as well as goblin king/anastasia aio etc, and had no issues, not sure what caused it sadly.

  • I'm not sure if it's this mod or what but I can't seem to get "A friend from the west part 1" from Skier. I am Skier level 2, I am level 23. I have done all the quests he has for me (accept golden swag but that isnt required for the quest). Am I missing something? Or is this custom quest mod (or Goblin King) breaking my vanilla quests?

  • спасибо всё прекрасно работает :палец вверх:

    Thumbs Up 1
  • I wonder how to solve this issue when starting the server:
    "...mod.js:54:27 at FSReqCallback.oncomplete (node:fs:188:23)"

    I tried with only "Customs Quests" or with only "Less Tedious Quests" or even with only "Goblin King".
    But everytime this error keeps coming...

  • how exactly do we get the mod.code-workspace file?

    • There isn't one because you shouldn't need to edit the code or require anything really from a workspace. If you are talking about making your own quests, it's 2 jsons you place in their respective files for locales and quests. I had a guide planned for making quests but who knows if that will actually take place.