Server/project/src/generators/LootGenerator.ts

567 lines
22 KiB
TypeScript
Raw Normal View History

2023-03-03 15:23:46 +00:00
import { inject, injectable } from "tsyringe";
import { InventoryHelper } from "@spt-aki/helpers/InventoryHelper";
import { ItemHelper } from "@spt-aki/helpers/ItemHelper";
import { PresetHelper } from "@spt-aki/helpers/PresetHelper";
import { WeightedRandomHelper } from "@spt-aki/helpers/WeightedRandomHelper";
import { IPreset } from "@spt-aki/models/eft/common/IGlobals";
import { Item } from "@spt-aki/models/eft/common/tables/IItem";
import { ITemplateItem } from "@spt-aki/models/eft/common/tables/ITemplateItem";
import { AddItem } from "@spt-aki/models/eft/inventory/IAddItemRequestData";
import { BaseClasses } from "@spt-aki/models/enums/BaseClasses";
import { ISealedAirdropContainerSettings, RewardDetails } from "@spt-aki/models/spt/config/IInventoryConfig";
import { LootItem } from "@spt-aki/models/spt/services/LootItem";
import { LootRequest } from "@spt-aki/models/spt/services/LootRequest";
import { ILogger } from "@spt-aki/models/spt/utils/ILogger";
import { DatabaseServer } from "@spt-aki/servers/DatabaseServer";
import { ItemFilterService } from "@spt-aki/services/ItemFilterService";
import { LocalisationService } from "@spt-aki/services/LocalisationService";
import { RagfairLinkedItemService } from "@spt-aki/services/RagfairLinkedItemService";
import { HashUtil } from "@spt-aki/utils/HashUtil";
import { JsonUtil } from "@spt-aki/utils/JsonUtil";
import { RandomUtil } from "@spt-aki/utils/RandomUtil";
2023-03-03 15:23:46 +00:00
2023-11-15 20:35:05 -05:00
type ItemLimit = { current: number; max: number; };
2023-03-03 15:23:46 +00:00
@injectable()
export class LootGenerator
{
constructor(
@inject("WinstonLogger") protected logger: ILogger,
@inject("HashUtil") protected hashUtil: HashUtil,
@inject("DatabaseServer") protected databaseServer: DatabaseServer,
@inject("RandomUtil") protected randomUtil: RandomUtil,
@inject("JsonUtil") protected jsonUtil: JsonUtil,
2023-03-03 15:23:46 +00:00
@inject("ItemHelper") protected itemHelper: ItemHelper,
@inject("PresetHelper") protected presetHelper: PresetHelper,
@inject("InventoryHelper") protected inventoryHelper: InventoryHelper,
@inject("WeightedRandomHelper") protected weightedRandomHelper: WeightedRandomHelper,
2023-03-03 15:23:46 +00:00
@inject("LocalisationService") protected localisationService: LocalisationService,
@inject("RagfairLinkedItemService") protected ragfairLinkedItemService: RagfairLinkedItemService,
2023-11-15 20:35:05 -05:00
@inject("ItemFilterService") protected itemFilterService: ItemFilterService,
2023-03-03 15:23:46 +00:00
)
{}
/**
* Generate a list of items based on configuration options parameter
* @param options parameters to adjust how loot is generated
* @returns An array of loot items
*/
public createRandomLoot(options: LootRequest): LootItem[]
2023-03-03 15:23:46 +00:00
{
const result: LootItem[] = [];
const itemTypeCounts = this.initItemLimitCounter(options.itemLimits);
const tables = this.databaseServer.getTables();
2023-11-13 11:05:05 -05:00
const itemBlacklist = new Set<string>([
...this.itemFilterService.getBlacklistedItems(),
...options.itemBlacklist,
]);
if (!options.allowBossItems)
{
2023-10-31 17:46:14 +00:00
for (const bossItem of this.itemFilterService.getBossItems())
{
itemBlacklist.add(bossItem);
}
}
2023-06-20 16:59:15 +01:00
// Handle sealed weapon containers
2023-11-15 20:35:05 -05:00
const desiredWeaponCrateCount = this.randomUtil.getInt(
options.weaponCrateCount.min,
options.weaponCrateCount.max,
);
2023-06-20 16:59:15 +01:00
if (desiredWeaponCrateCount > 0)
{
// Get list of all sealed containers from db
2023-11-15 20:35:05 -05:00
const sealedWeaponContainerPool = Object.values(tables.templates.items).filter((x) =>
x._name.includes("event_container_airdrop")
);
2023-06-20 16:59:15 +01:00
for (let index = 0; index < desiredWeaponCrateCount; index++)
{
// Choose one at random + add to results array
const chosenSealedContainer = this.randomUtil.getArrayValue(sealedWeaponContainerPool);
result.push({
id: this.hashUtil.generate(),
tpl: chosenSealedContainer._id,
isPreset: false,
2023-11-15 20:35:05 -05:00
stackCount: 1,
2023-06-20 16:59:15 +01:00
});
}
}
2023-03-03 15:23:46 +00:00
// Get items from items.json that have a type of item + not in global blacklist + basetype is in whitelist
2023-11-15 20:35:05 -05:00
const items = Object.entries(tables.templates.items).filter((x) =>
!itemBlacklist.has(x[1]._id)
&& x[1]._type.toLowerCase() === "item"
2023-03-03 15:23:46 +00:00
&& !x[1]._props.QuestItem
2023-11-15 20:35:05 -05:00
&& options.itemTypeWhitelist.includes(x[1]._parent)
);
2023-03-03 15:23:46 +00:00
const randomisedItemCount = this.randomUtil.getInt(options.itemCount.min, options.itemCount.max);
for (let index = 0; index < randomisedItemCount; index++)
{
if (!this.findAndAddRandomItemToLoot(items, itemTypeCounts, options, result))
{
index--;
2023-11-15 20:35:05 -05:00
}
2023-03-03 15:23:46 +00:00
}
const globalDefaultPresets = Object.values(this.presetHelper.getDefaultPresets());
const itemBlacklistArray = Array.from(itemBlacklist);
// Filter default presets to just weapons
const randomisedWeaponPresetCount = this.randomUtil.getInt(options.weaponPresetCount.min, options.weaponPresetCount.max);
if (randomisedWeaponPresetCount > 0)
{
const weaponDefaultPresets = globalDefaultPresets.filter(preset => this.itemHelper.isOfBaseclass(preset._encyclopedia, BaseClasses.WEAPON));
for (let index = 0; index < randomisedWeaponPresetCount; index++)
{
if (!this.findAndAddRandomPresetToLoot(weaponDefaultPresets, itemTypeCounts, itemBlacklistArray, result))
{
index--;
}
}
}
// Filter default presets to just armors and then filter again by protection level
const randomisedArmorPresetCount = this.randomUtil.getInt(options.armorPresetCount.min, options.armorPresetCount.max);
if (randomisedArmorPresetCount > 0)
2023-03-03 15:23:46 +00:00
{
const armorDefaultPresets = globalDefaultPresets.filter(preset => this.itemHelper.armorItemCanHoldMods(preset._encyclopedia));
const levelFilteredArmorPresets = armorDefaultPresets.filter(armor => this.armorIsDesiredProtectionLevel(armor, options));
for (let index = 0; index < randomisedArmorPresetCount; index++)
2023-03-03 15:23:46 +00:00
{
if (!this.findAndAddRandomPresetToLoot(levelFilteredArmorPresets, itemTypeCounts, itemBlacklistArray, result))
{
index--;
}
2023-03-03 15:23:46 +00:00
}
}
return result;
}
/**
* Filter armor items by their main plates protection level
* @param armor Armor preset
* @param options Loot request options
* @returns True item passes checks
*/
protected armorIsDesiredProtectionLevel(armor: IPreset, options: LootRequest): boolean
{
const frontPlate = armor._items.find(mod => mod?.slotId?.toLowerCase() === "front_plate");
if (frontPlate)
{
const plateDb = this.itemHelper.getItem(frontPlate._tpl);
return options.armorLevelWhitelist.includes(Number.parseInt(plateDb[1]._props.armorClass as any));
}
const helmetTop = armor._items.find(mod => mod?.slotId?.toLowerCase() === "helmet_top");
if (helmetTop)
{
const plateDb = this.itemHelper.getItem(helmetTop._tpl);
return options.armorLevelWhitelist.includes(Number.parseInt(plateDb[1]._props.armorClass as any));
}
2024-01-18 23:29:07 +00:00
const softArmorFront = armor._items.find(mod => mod?.slotId?.toLowerCase() === "soft_armor_front");
if (softArmorFront)
{
const plateDb = this.itemHelper.getItem(softArmorFront._tpl);
return options.armorLevelWhitelist.includes(Number.parseInt(plateDb[1]._props.armorClass as any));
}
return false;
}
2023-03-03 15:23:46 +00:00
/**
* Construct item limit record to hold max and current item count for each item type
2023-03-03 15:23:46 +00:00
* @param limits limits as defined in config
* @returns record, key: item tplId, value: current/max item count allowed
*/
protected initItemLimitCounter(limits: Record<string, number>): Record<string, ItemLimit>
2023-03-03 15:23:46 +00:00
{
const itemTypeCounts: Record<string, ItemLimit> = {};
for (const itemTypeId in limits)
2023-03-03 15:23:46 +00:00
{
2023-11-15 20:35:05 -05:00
itemTypeCounts[itemTypeId] = { current: 0, max: limits[itemTypeId] };
2023-03-03 15:23:46 +00:00
}
return itemTypeCounts;
}
/**
* Find a random item in items.json and add to result array
* @param items items to choose from
* @param itemTypeCounts item limit counts
* @param options item filters
* @param result array to add found item to
* @returns true if item was valid and added to pool
*/
protected findAndAddRandomItemToLoot(
items: [string, ITemplateItem][],
itemTypeCounts: Record<string, { current: number; max: number; }>,
options: LootRequest,
2023-11-15 20:35:05 -05:00
result: LootItem[],
): boolean
2023-03-03 15:23:46 +00:00
{
const randomItem = this.randomUtil.getArrayValue(items)[1];
const itemLimitCount = itemTypeCounts[randomItem._parent];
if (itemLimitCount && itemLimitCount.current > itemLimitCount.max)
{
return false;
}
// Skip armors as they need to come from presets
if (this.itemHelper.armorItemCanHoldMods(randomItem._id))
{
return false;
}
2023-03-03 15:23:46 +00:00
const newLootItem: LootItem = {
id: this.hashUtil.generate(),
tpl: randomItem._id,
isPreset: false,
2023-11-15 20:35:05 -05:00
stackCount: 1,
2023-03-03 15:23:46 +00:00
};
// Special case - handle items that need a stackcount > 1
if (randomItem._props.StackMaxSize > 1)
{
newLootItem.stackCount = this.getRandomisedStackCount(randomItem, options);
}
2023-11-15 20:35:05 -05:00
2023-03-03 15:23:46 +00:00
newLootItem.tpl = randomItem._id;
result.push(newLootItem);
if (itemLimitCount)
{
// Increment item count as it's in limit array
itemLimitCount.current++;
}
// Item added okay
return true;
}
/**
* Get a randomised stack count for an item between its StackMinRandom and StackMaxSize values
* @param item item to get stack count of
* @param options loot options
* @returns stack count
*/
protected getRandomisedStackCount(item: ITemplateItem, options: LootRequest): number
{
let min = item._props.StackMinRandom;
let max = item._props.StackMaxSize;
if (options.itemStackLimits[item._id])
{
min = options.itemStackLimits[item._id].min;
max = options.itemStackLimits[item._id].max;
}
return this.randomUtil.getInt(min ?? 1, max ?? 1);
2023-03-03 15:23:46 +00:00
}
/**
* Find a random item in items.json and add to result array
* @param globalDefaultPresets presets to choose from
* @param itemTypeCounts item limit counts
* @param itemBlacklist items to skip
* @param result array to add found preset to
* @returns true if preset was valid and added to pool
*/
protected findAndAddRandomPresetToLoot(
globalDefaultPresets: IPreset[],
2023-03-03 15:23:46 +00:00
itemTypeCounts: Record<string, { current: number; max: number; }>,
itemBlacklist: string[],
2023-11-15 20:35:05 -05:00
result: LootItem[],
): boolean
2023-03-03 15:23:46 +00:00
{
// Choose random preset and get details from item.json using encyclopedia value (encyclopedia === tplId)
const randomPreset = this.randomUtil.getArrayValue(globalDefaultPresets);
if (!randomPreset?._encyclopedia)
{
this.logger.debug(`Airdrop - preset with id: ${randomPreset._id} lacks encyclopedia property, skipping`);
return false;
}
const itemDetails = this.itemHelper.getItem(randomPreset._encyclopedia);
if (!itemDetails[0])
{
this.logger.debug(`Airdrop - Unable to find preset with tpl: ${randomPreset._encyclopedia}, skipping`);
return false;
}
2023-03-03 15:23:46 +00:00
// Skip blacklisted items
if (itemBlacklist.includes(randomPreset._items[0]._tpl))
{
return false;
}
// Some custom mod items are lacking a parent property
if (!itemDetails[1]._parent)
2023-03-03 15:23:46 +00:00
{
this.logger.error(this.localisationService.getText("loot-item_missing_parentid", itemDetails[1]?._name));
2023-03-03 15:23:46 +00:00
return false;
}
// Check picked preset hasn't exceeded spawn limit
const itemLimitCount = itemTypeCounts[itemDetails[1]._parent];
2023-03-03 15:23:46 +00:00
if (itemLimitCount && itemLimitCount.current > itemLimitCount.max)
{
return false;
}
2023-11-15 20:35:05 -05:00
const newLootItem: LootItem = { tpl: randomPreset._items[0]._tpl, isPreset: true, stackCount: 1 };
2023-03-03 15:23:46 +00:00
result.push(newLootItem);
if (itemLimitCount)
{
// increment item count as its in limit array
itemLimitCount.current++;
}
2023-11-15 20:35:05 -05:00
2023-03-03 15:23:46 +00:00
// item added okay
return true;
}
/**
* Sealed weapon containers have a weapon + associated mods inside them + assortment of other things (food/meds)
* @param containerSettings sealed weapon container settings
* @returns Array of item with children arrays
*/
public getSealedWeaponCaseLoot(containerSettings: ISealedAirdropContainerSettings): Item[][]
{
const itemsToReturn: Item[][] = [];
// choose a weapon to give to the player (weighted)
2023-11-15 20:35:05 -05:00
const chosenWeaponTpl = this.weightedRandomHelper.getWeightedValue<string>(
containerSettings.weaponRewardWeight,
);
const weaponDetailsDb = this.itemHelper.getItem(chosenWeaponTpl);
if (!weaponDetailsDb[0])
{
2023-11-15 20:35:05 -05:00
this.logger.error(
this.localisationService.getText("loot-non_item_picked_as_sealed_weapon_crate_reward", chosenWeaponTpl),
);
return itemsToReturn;
}
2023-11-15 20:35:05 -05:00
// Get weapon preset - default or choose a random one from all possible
let chosenWeaponPreset = (containerSettings.defaultPresetsOnly)
? this.presetHelper.getDefaultPreset(chosenWeaponTpl)
: this.randomUtil.getArrayValue(this.presetHelper.getPresets(chosenWeaponTpl));
if (!chosenWeaponPreset)
{
this.logger.warning(`Default preset for weapon ${chosenWeaponTpl} not found, choosing random instead`);
chosenWeaponPreset = this.randomUtil.getArrayValue(this.presetHelper.getPresets(chosenWeaponTpl));
}
const presetAndMods: Item[] = this.itemHelper.replaceIDs(
null,
this.jsonUtil.clone(chosenWeaponPreset._items),
);
this.itemHelper.remapRootItemId(presetAndMods);
// Add preset to return object
itemsToReturn.push(presetAndMods);
// Get items related to chosen weapon
const linkedItemsToWeapon = this.ragfairLinkedItemService.getLinkedDbItems(chosenWeaponTpl);
2023-11-15 20:35:05 -05:00
itemsToReturn.push(
...this.getSealedContainerWeaponModRewards(containerSettings, linkedItemsToWeapon, chosenWeaponPreset),
);
// Handle non-weapon mod reward types
itemsToReturn.push(...this.getSealedContainerNonWeaponModRewards(containerSettings, weaponDetailsDb[1]));
return itemsToReturn;
}
/**
* Get non-weapon mod rewards for a sealed container
* @param containerSettings Sealed weapon container settings
* @param weaponDetailsDb Details for the weapon to reward player
* @returns Array of item with children arrays
*/
2023-11-15 20:35:05 -05:00
protected getSealedContainerNonWeaponModRewards(
containerSettings: ISealedAirdropContainerSettings,
weaponDetailsDb: ITemplateItem,
): Item[][]
{
const rewards: Item[][] = [];
for (const rewardTypeId in containerSettings.rewardTypeLimits)
{
const settings = containerSettings.rewardTypeLimits[rewardTypeId];
const rewardCount = this.randomUtil.getInt(settings.min, settings.max);
if (rewardCount === 0)
{
continue;
}
// Edge case - ammo boxes
if (rewardTypeId === BaseClasses.AMMO_BOX)
{
// Get ammoboxes from db
const ammoBoxesDetails = containerSettings.ammoBoxWhitelist.map((tpl) =>
{
const itemDetails = this.itemHelper.getItem(tpl);
return itemDetails[1];
});
2023-11-15 20:35:05 -05:00
// Need to find boxes that matches weapons caliber
const weaponCaliber = weaponDetailsDb._props.ammoCaliber;
2023-11-15 20:35:05 -05:00
const ammoBoxesMatchingCaliber = ammoBoxesDetails.filter((x) => x._props.ammoCaliber === weaponCaliber);
if (ammoBoxesMatchingCaliber.length === 0)
{
this.logger.debug(`No ammo box with caliber ${weaponCaliber} found, skipping`);
continue;
}
for (let index = 0; index < rewardCount; index++)
{
const chosenAmmoBox = this.randomUtil.getArrayValue(ammoBoxesMatchingCaliber);
const ammoBoxItem: Item[] = [
{
_id: this.hashUtil.generate(),
_tpl: chosenAmmoBox._id
}
]
this.itemHelper.addCartridgesToAmmoBox(ammoBoxItem, chosenAmmoBox);
rewards.push(ammoBoxItem);
}
continue;
}
// Get all items of the desired type + not quest items + not globally blacklisted
2023-11-15 20:35:05 -05:00
const rewardItemPool = Object.values(this.databaseServer.getTables().templates.items).filter((x) =>
x._parent === rewardTypeId
&& x._type.toLowerCase() === "item"
&& !this.itemFilterService.isItemBlacklisted(x._id)
&& (!(containerSettings.allowBossItems || this.itemFilterService.isBossItem(x._id)))
2023-11-15 20:35:05 -05:00
&& !x._props.QuestItem
);
if (rewardItemPool.length === 0)
{
this.logger.debug(`No items with base type of ${rewardTypeId} found, skipping`);
continue;
}
for (let index = 0; index < rewardCount; index++)
{
// Choose a random item from pool
const chosenRewardItem = this.randomUtil.getArrayValue(rewardItemPool);
const rewardItem: Item[] = [
{
_id: this.hashUtil.generate(),
_tpl: chosenRewardItem._id
}
]
rewards.push(rewardItem)
}
}
return rewards;
}
/**
* Iterate over the container weaponModRewardLimits settings and create an array of weapon mods to reward player
* @param containerSettings Sealed weapon container settings
* @param linkedItemsToWeapon All items that can be attached/inserted into weapon
* @param chosenWeaponPreset The weapon preset given to player as reward
* @returns Array of item with children arrays
*/
2023-11-15 20:35:05 -05:00
protected getSealedContainerWeaponModRewards(
containerSettings: ISealedAirdropContainerSettings,
linkedItemsToWeapon: ITemplateItem[],
chosenWeaponPreset: IPreset,
): Item[][]
{
const modRewards: Item[][] = [];
for (const rewardTypeId in containerSettings.weaponModRewardLimits)
{
const settings = containerSettings.weaponModRewardLimits[rewardTypeId];
const rewardCount = this.randomUtil.getInt(settings.min, settings.max);
// Nothing to add, skip reward type
if (rewardCount === 0)
{
continue;
}
2023-11-13 11:05:05 -05:00
// Get items that fulfil reward type criteria from items that fit on gun
2023-11-15 20:35:05 -05:00
const relatedItems = linkedItemsToWeapon.filter((x) =>
x._parent === rewardTypeId && !this.itemFilterService.isItemBlacklisted(x._id)
);
if (!relatedItems || relatedItems.length === 0)
{
2023-11-15 20:35:05 -05:00
this.logger.debug(
`No items found to fulfil reward type ${rewardTypeId} for weapon: ${chosenWeaponPreset._name}, skipping type`,
);
continue;
}
// Find a random item of the desired type and add as reward
2023-11-15 20:35:05 -05:00
for (let index = 0; index < rewardCount; index++)
{
const chosenItem = this.randomUtil.drawRandomFromList(relatedItems);
const item: Item[] = [{
_id: this.hashUtil.generate(),
_tpl: chosenItem[0]._id
}];
modRewards.push(item)
}
}
return modRewards;
}
/**
* Handle event-related loot containers - currently just the halloween jack-o-lanterns that give food rewards
2023-11-15 20:35:05 -05:00
* @param rewardContainerDetails
* @returns Array of item with children arrays
*/
public getRandomLootContainerLoot(rewardContainerDetails: RewardDetails): Item[][]
{
const itemsToReturn: Item[][] = [];
// Get random items and add to newItemRequest
for (let index = 0; index < rewardContainerDetails.rewardCount; index++)
{
// Pick random reward from pool, add to request object
2023-11-15 20:35:05 -05:00
const chosenRewardItemTpl = this.weightedRandomHelper.getWeightedValue<string>(
rewardContainerDetails.rewardTplPool,
);
const rewardItem: Item[] = [
{
_id: this.hashUtil.generate(),
_tpl: chosenRewardItemTpl
}
]
itemsToReturn.push(rewardItem)
}
return itemsToReturn;
}
2023-11-15 20:35:05 -05:00
}