From d5ece8e9b7b22f0a13555866024c2bd165cfe43f Mon Sep 17 00:00:00 2001 From: GetParanoid Date: Fri, 18 Jul 2025 16:24:54 -0500 Subject: [PATCH] feat(VCQL) --- .../Virtual's Custom Quest Loader/LICENSE | 23 ++ .../database/config/config.json | 5 + .../database/locales/README.txt | 1 + .../database/quests/README.txt | 11 + .../package.json | 23 ++ .../res/quests/README.txt | 2 + .../Virtual's Custom Quest Loader/src/mod.ts | 227 ++++++++++++++++++ 7 files changed, 292 insertions(+) create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/LICENSE create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/database/config/config.json create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/database/locales/README.txt create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/database/quests/README.txt create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/package.json create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/res/quests/README.txt create mode 100644 user/mods/user/mods/Virtual's Custom Quest Loader/src/mod.ts diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/LICENSE b/user/mods/user/mods/Virtual's Custom Quest Loader/LICENSE new file mode 100644 index 0000000..bde5c5d --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/LICENSE @@ -0,0 +1,23 @@ +The MIT License (MIT) + +Copyright (c) 2022 Virtual (https://hub.sp-tarkov.com/user/26520-virtual/) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +This license refers to the files included within the folder that it resides in from the original download. Any other modification or assets surrounding the use of said files created and maintained by another entity are to be processed under a seperate license and are not the product from this copyright individual. \ No newline at end of file diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/database/config/config.json b/user/mods/user/mods/Virtual's Custom Quest Loader/database/config/config.json new file mode 100644 index 0000000..18a3231 --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/database/config/config.json @@ -0,0 +1,5 @@ +{ + "enableLogging": true, + "enableDebugLogging": false, + "ignoreSideExclusive": false +} \ No newline at end of file diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/database/locales/README.txt b/user/mods/user/mods/Virtual's Custom Quest Loader/database/locales/README.txt new file mode 100644 index 0000000..97969a8 --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/database/locales/README.txt @@ -0,0 +1 @@ +Locales files need to be placed into the correct folder so they are loaded to the correct language setting. Locales are loaded from the server, so if a locale folder doesn't exist, you can create it. \ No newline at end of file diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/database/quests/README.txt b/user/mods/user/mods/Virtual's Custom Quest Loader/database/quests/README.txt new file mode 100644 index 0000000..220639f --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/database/quests/README.txt @@ -0,0 +1,11 @@ +Here is where you place all .json files that contain the contents of the quests. They should have the same format as quests.json in aki-data/server/database/templates/. There is no required name and you can call them whatever you like. + +The only additional properties that can be added are + + "startMonth": 12, + "startDay": 1, + "endDay": 31 + +This allows you to create seasonal quests (The values here for example would only have the task available during the month of december.) + +Quests can be accross multiple files and you can have each json with 20 quests for example. diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/package.json b/user/mods/user/mods/Virtual's Custom Quest Loader/package.json new file mode 100644 index 0000000..dae619f --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/package.json @@ -0,0 +1,23 @@ +{ + "name": "Virtuals Custom Quest Loader", + "version":"2.0.4", + "main": "src/mod.js", + "license": "MIT", + "author": "Virtual", + "sptVersion": "3.11.x", + "scripts": { + "setup": "npm i", + "build": "node ./packageBuild.ts" + }, + "devDependencies": { + "@types/node": "16.11.62", + "@typescript-eslint/eslint-plugin": "5.38.1", + "@typescript-eslint/parser": "5.38.1", + "bestzip": "2.2.1", + "eslint": "8.24.0", + "fs-extra": "10.1.0", + "glob": "8.0.3", + "tsyringe": "4.7.0", + "typescript": "4.8.4" + } +} \ No newline at end of file diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/res/quests/README.txt b/user/mods/user/mods/Virtual's Custom Quest Loader/res/quests/README.txt new file mode 100644 index 0000000..8210146 --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/res/quests/README.txt @@ -0,0 +1,2 @@ +All images need to be 314 x 177 AND need to be either a .png or .jpg. +After placing them in this folder, you can select the image in the database/quests/ file and change it to the name of the image you placed in this folder. \ No newline at end of file diff --git a/user/mods/user/mods/Virtual's Custom Quest Loader/src/mod.ts b/user/mods/user/mods/Virtual's Custom Quest Loader/src/mod.ts new file mode 100644 index 0000000..38e3fa0 --- /dev/null +++ b/user/mods/user/mods/Virtual's Custom Quest Loader/src/mod.ts @@ -0,0 +1,227 @@ +import { DependencyContainer} from "tsyringe"; +import { IPostDBLoadMod } from "@spt/models/external/IPostDBLoadMod"; +import { IPreSptLoadMod } from "@spt/models/external/IPreSptLoadMod" +import type {StaticRouterModService} from "@spt/services/mod/staticRouter/StaticRouterModService"; +import { ConfigServer } from "@spt/servers/ConfigServer"; +import { ConfigTypes } from "@spt/models/enums/ConfigTypes"; +import { DatabaseServer } from "@spt/servers/DatabaseServer"; +import { ImageRouter } from "@spt/routers/ImageRouter"; +import { ILogger } from "@spt/models/spt/utils/ILogger"; +import * as path from "path"; +const fs = require('fs'); +const modPath = path.normalize(path.join(__dirname, '..')); + +class VCQL implements IPostDBLoadMod, IPreSptLoadMod { + private enableLogging; + private enableDebugLogging; + private ignoreSideExclusive; + private zones; + + public preSptLoad(container: DependencyContainer): void { + const staticRouterModService: StaticRouterModService = container.resolve("StaticRouterModService") + const logger = container.resolve("WinstonLogger") + + this.loadZones() + staticRouterModService.registerStaticRouter( + "vcql-get-zones", + [ + { + url: "/vcql/zones/get", + action: (url, info, sessionId, output) => + { + if (this.enableDebugLogging) logger.success("[VCQL-DEBUG] Zone router hit.") + return JSON.stringify(this.zones); + } + } + ], + "vcql-get" + ) + } + + public postDBLoad(container: DependencyContainer): void + { + const database = container.resolve("DatabaseServer").getTables() + const imageRouter = container.resolve< ImageRouter >("ImageRouter") + const logger = container.resolve("WinstonLogger") + const config = container.resolve("ConfigServer").getConfig(ConfigTypes.QUEST) + + this.importConfig() + this.importQuests(database, logger, config) + this.importAssorts(database, logger) + this.importLocales(database) + this.routeImages(imageRouter, logger) + } + + public loadFiles(dirPath, extName, cb) { + if (!fs.existsSync(dirPath)) return + const dir = fs.readdirSync(dirPath, { withFileTypes: true }) + dir.forEach(item => { + const itemPath = path.normalize(`${dirPath}/${item.name}`) + if (item.isDirectory()) this.loadFiles(itemPath, extName, cb) + else if (extName.includes(path.extname(item.name))) cb(itemPath) + }); + } + + public loadZones() { + let zones = [] + this.loadFiles(`${modPath}/database/zones/`, [".json"], function(filePath) { + const zoneFile = require(filePath) + if (Object.keys(zoneFile).length > 0) + zones.push(... zoneFile) + }) + this.zones = zones + } + + public importConfig() { + let config = require(`${modPath}/database/config/config.json`) + this.enableLogging = config.enableLogging + this.enableDebugLogging = config.enableDebugLogging + this.ignoreSideExclusive = config.ignoreSideExclusive + } + + public importQuests(database, logger, config) { + let questCount = 0 + let prunedCount = 0 + let debugLogging = this.enableDebugLogging + let ignoreSideExclusive = this.ignoreSideExclusive + this.loadFiles(`${modPath}/database/quests/`, [".json"], function(filePath) { + const item = require(filePath) + if (Object.keys(item).length < 1) return + for (const quest in item) { + // Date check + if (item[quest].startMonth && item[quest].startMonth > 0) { + let currentDate = new Date() + + let questStartDate = new Date(currentDate.getFullYear(), item[quest].startMonth - 1, item[quest].startDay) + let questEndDate = new Date(currentDate.getFullYear(), item[quest].endMonth - 1, item[quest].endDay) + + if (currentDate < questStartDate || currentDate > questEndDate) { + if (debugLogging) logger.success(`[VCQL-DEBUG] Removing quest ${item[quest]._id} because it is outside the date range`) + prunedCount++ + continue + } + } + // Cleanup + delete item[quest].startMonth; delete item[quest].endMonth; delete item[quest].startDay; delete item[quest].endDay + // Push + if (item[quest].sideExclusive) { + if (item[quest].sideExclusive == "Usec" && !ignoreSideExclusive) { + config.usecOnlyQuests.push(quest) + if (debugLogging) logger.success(`[VCQL-DEBUG] Adding quest ${item[quest]._id} as a Usec exclusive quest.`) + } + if (item[quest].sideExclusive == "Bear" && !ignoreSideExclusive) { + config.bearOnlyQuests.push(quest) + if (debugLogging) logger.success(`[VCQL-DEBUG] Adding quest ${item[quest]._id} as a Bear exclusive quest.`) + } + delete item[quest].sideExclusive + } + database.templates.quests[quest] = item[quest] + questCount++ + } + }) + + if (this.enableLogging) { + logger.success(`[VCQL] Loaded ${questCount} custom quests.`) + logger.success(`[VCQL] ${prunedCount} custom quests were pruned due to date settings.`) + } + } + + public importAssorts(database, logger) { + let debugLogging = this.enableDebugLogging + this.loadFiles(`${modPath}/database/assorts/`, [".json"], function(filePath) { + const assorts = require(filePath) + if (assorts.items == undefined || assorts.traderID == undefined || assorts.barter_scheme == undefined || assorts.loyal_level_items == undefined) return + + let traderID = assorts.traderID + let databaseTrader = database.traders[traderID] + + // If assort is for a custom trader, ensure that they have the appropriate assort tables + if (databaseTrader.questassort == undefined) databaseTrader.questassort = { + started: {}, + success: {}, + fail: {} + } + + if (databaseTrader.assort == undefined) databaseTrader.assort = { + items: [], + barter_scheme: {}, + loyal_level_items: {} + } + + // Add barter scheme, loyalty level, quest assort and general assort, where applicable + for (const assort of assorts.items) { + if (assorts.barter_scheme[assort._id] != undefined) { + databaseTrader.assort.barter_scheme[assort._id] = assorts.barter_scheme[assort._id] + } else { + if (assort.parentId == "hideout") logger.error(`[VCQL] Parent assort ${assort._id} has no associated barter scheme.`) + } + + if (assorts.loyal_level_items[assort._id] != undefined) { + databaseTrader.assort.loyal_level_items[assort._id] = assorts.loyal_level_items[assort._id] + } else { + if (assort.parentId == "hideout") logger.error(`[VCQL] Parent assort ${assort._id} has no associated loyalty level`) + } + + if (assort.unlockedOn != undefined && assort.questID != undefined) { + databaseTrader.questassort[assort.unlockedOn][assort._id] = assort.questID + delete assort.unlockedOn + delete assort.questID + } + + databaseTrader.assort.items.push(assort) + if (debugLogging) logger.success(`[VCQL-DEBUG] Adding assort ${assort._id} to the trader ${traderID}`) + } + }) + } + + public importLocales(database) { + const serverLocales = ['ch','cz','en','es','es-mx','fr','ge','hu','it','jp','kr','pl','po','ru','sk','tu'] + const addedLocales = {} + for (const locale of serverLocales) { + this.loadFiles(`${modPath}/database/locales/${locale}`, [".json"], function(filePath) { + const localeFile = require(filePath) + if (Object.keys(localeFile).length < 1) return + for (const currentItem in localeFile) { + database.locales.global[locale][currentItem] = localeFile[currentItem] + if (!Object.keys(addedLocales).includes(locale)) addedLocales[locale] = {} + addedLocales[locale][currentItem] = localeFile[currentItem] + } + }) + } + + // placeholders + for (const locale of serverLocales) { + if (locale == "en") continue + for (const englishItem in addedLocales["en"]) { + if (locale in addedLocales) { + if (englishItem in addedLocales[locale]) continue + } + if (database.locales.global[locale] != undefined) database.locales.global[locale][englishItem] = addedLocales["en"][englishItem] + } + } + } + + public routeImages(imageRouter, logger) { + let questImageCount = 0 + let debugLogging = this.enableDebugLogging + this.loadFiles(`${modPath}/res/quests/`, [".png", ".jpg"], function(filePath) { + imageRouter.addRoute(`/files/quest/icon/${path.basename(filePath, path.extname(filePath))}`, filePath) + if (debugLogging) logger.success(`[VCQL-DEBUG] Adding quest image ${path.basename(filePath)}`) + questImageCount++ + }) + + let traderImageCount = 0 + this.loadFiles(`${modPath}/res/traders/`, [".png", ".jpg"], function(filePath) { + imageRouter.addRoute(`/files/trader/avatar/${path.basename(filePath, path.extname(filePath))}`, filePath) + if (debugLogging) logger.success(`[VCQL-DEBUG] Adding quest image ${path.basename(filePath)}`) + traderImageCount++ + }) + + if (this.enableLogging) { + logger.success(`[VCQL] Loaded ${questImageCount} custom quest images.`) + logger.success(`[VCQL] Loaded ${traderImageCount} custom trader images.`) + } + } +} + +module.exports = { mod: new VCQL() }