Wiki › Tacz Weapon Research Blueprints › Configuration

Tacz Weapon Research Blueprints — Configuration

Every setting in the mod config file, with what it changes.

Option	What it does
`activeResearchProfile`Active Research Profile	Resource ID of the profile used for research, Analyzer tier odds, crafting, and ordinary fragments. The built-in profile is taczweaponblueprints:duplicate_recovery.
`advancedCrafting`Advanced Crafting Rules	Allow or block crafting by category, weapon type, or individual blueprint.
`customTiers`Advanced Tier Settings	Adjust automatic weapon tiers, custom tier rules, and support for other workstations.
`researchDataAllowLearned`Allow Already-Learned Weapons	Allow Data to give duplicates of weapons the player already knows. If off, processing is blocked only when no eligible weapons remain. Item-specific datapack rules can override this.
`researchDataAllowUndiscovered`Allow Undiscovered Weapons	Allow Data to target weapons the player has not found yet. If off, only discovered weapons are eligible unless a datapack overrides this.
`allowUnlearnedRecycling`Allow Unlearned Recycling	Let datapack rules permit recycling a blueprint before the player has learned it
`ammoCraftingStrategy`Ammo Crafting	Choose how Crafting Workbench levels apply to ammo. This does not add ammo to the Tech Tree
`analyzerSetup`Analyzer setup	Tiered uses three stations. Single lets any Analyzer process every weapon tier using that weapon’s same-tier reward rules. Datapacks still set costs and rewards. Changing this reloads recipes and closes open research stations.
`attachmentCraftingStrategy`Attachment Crafting	Choose how Crafting Workbench levels apply to attachments. This does not add attachments to the Tech Tree
`researchPointCap`Banked RP Cap	Maximum banked RP. This cap does not limit physical currency stacks.
`magazineBasicWorkbenchTier`Basic Magazine Workbench Tier	Minimum Workbench tier for basic magazines. Higher tiers also qualify. TaCZ’s original ammo Workbench counts as Tier 1 unless explicitly mapped under Advanced Tier Settings.
`analyzer`Blueprint Analyzer	Choose how duplicate blueprints and found weapons are used. Datapacks set weapon-tier odds, fragment amounts, analysis costs, and reconstruction requirements.
`blueprintSpawnChance`Blueprint Loot Chance (%)	Chance to add blueprints to an eligible loot roll when using Custom. Enter 20 for 20%. Datapack loot rules can set their own chances.
`progressionExemptKinds`Blueprint-Free Categories	Select any broad recipe categories that should be available without blueprints
`progressionExemptBlueprints`Blueprint-Free Item IDs	TaCZ items available without blueprints. Add an entry and type an item name or resource ID to search the loaded blueprint catalog
`progressionExemptItemTypes`Blueprint-Free Subgroups	Search and select TaCZ subgroups that should be available without blueprints. Subgroups from loaded weapon packs are included automatically
`groupPadding`Branch Frame Padding (Legacy)	Retained only for compatibility with older Personal Settings files
`intraGroupGap`Branch Spacing (Legacy)	Retained only for compatibility with older Personal Settings files
`groupHeaderHeight`Branch Title Space (Legacy)	Retained only for compatibility with older Personal Settings files
`canvasPadding`Canvas Padding	Legacy setting: Empty space around the outside of a weapon tree. Does not change the current Tech Tree
`enableCombatResearchPointAwards`Combat Currency Rewards	Allow configured combat events to award Scrap or banked RP. Requires Gameplay Currency Rewards.
`customFragmentMode`Completed Set Result	Result of completing an ordinary fragment set when the fragment preset is Custom.
`portalPadding`Connection Padding	Legacy setting: Extra room reserved for links that continue in another branch. Does not change the current Tech Tree
`craftingAccess`Crafting Access	Choose simple Workbench rules for ammo and attachments without changing the Tech Tree
`creativeBypassesWorkbenchTiers`Creative Bypasses Bench Tiers	Let Creative players ignore Research Bench tier requirements. Crafting rules and other bypass settings are separate.
`creativeBypassesProgressionGates`Creative Bypasses Progression Gates	Let Creative players ignore event and advancement requirements; disabled by default
`orderingSweeps`Crossing Reduction Passes	Legacy setting: Advanced: passes used to reduce crossed progression lines. Does not change the current Tech Tree
`currency`Currency and Rewards	Choose physical Scrap or banked RP, then set up loot and gameplay rewards.
`enableScrapLoot`Currency in Loot	Add the selected physical currency to configured loot tables. Does not control Research Data drops or gameplay rewards.
`researchCurrencyItem`Currency Item ID	One item is one currency unit. Default: taczweaponblueprints:scrap. Changing this does not convert existing items.
`scrapLootBudget`Currency Limit per Loot Roll	Maximum currency items added or already present in one loot roll (0–64). Existing items count toward the limit and are never removed. Zero stops extra currency being added.
`advanced`Datapacks and Exclusions	Choose a research profile and exclude specific blueprints. Intended for server owners and pack authors.
`craftingDisabledKinds`Disabled Crafting Categories	Categories that cannot be crafted at these Workbenches
`craftingDisabledItemTypes`Disabled Crafting Subgroups	TaCZ subgroups that cannot be crafted at these Workbenches
`componentGap`Disconnected Tree Spacing (Legacy)	Retained only for compatibility with older Personal Settings files
`discoveryAndLoot`Discovery and Loot	Choose a ready-made discovery pace or tune blueprint loot by hand
`balancePreset`Discovery and Loot Preset	Choose a ready-made discovery pace. Custom uses the visibility and loot values below
`duplicateBlueprintPolicy`Duplicate Blueprints	Choose whether spare copies of learned blueprints can be recycled for the selected currency.
`enableJournal`Enable Blueprint Journal	Let players review their discovered and learned blueprints in the Blueprint Journal
`enableBlueprints`Enable Blueprint Progression	Require learned blueprints for configured TaCZ recipes and allow blueprint loot
`enableResearch`Enable Research	Let players research blueprints included in the active datapack profile
`exactCraftingOverrides`Exact Crafting Overrides	Map a loaded blueprint name or resource ID to its final Workbench crafting rule. Exact entries override category and subgroup settings
`ammoBlacklist`Excluded Ammo Blueprints	Ammunition whose blueprints are excluded from loot distribution. Add an entry and type an ammunition name or resource ID to search
`attachmentBlacklist`Excluded Attachment Blueprints	Attachments whose blueprints are excluded from loot distribution. Add an entry and type an attachment name or resource ID to search
`gunBlacklist`Excluded Gun Blueprints	Guns whose blueprints are excluded from loot distribution. Add an entry and type a gun name or resource ID to search
`magazineExtendedWorkbenchTier`Extended Magazine Workbench Tier	Minimum Workbench tier for every extended magazine variant. Higher tiers also qualify. This controls crafting; fitting a magazine to a gun still follows the add-on’s attachment rules.
`externalWorkstationTiers`External Workstation Tier Mappings	Assign a crafting level to another TaCZ-compatible workstation using its exact resource ID.
`foundWeaponRecoveryMode`Found Weapon Recovery	Choose the actions available for weapons found in loot. Analysis still uses the weapon and Analyzer tiers; this setting does not guarantee a blueprint.
`fragmentLootReplacementPercent`Fragment Loot Share (%)	Percentage of eligible blueprint loot rolls replaced by ordinary fragments. Zero keeps all as blueprints; 100 replaces all eligible rolls.
`fragmentRetainedProgressCap`Fragment Progress Cap	Maximum saved ordinary fragment progress for one weapon. Must be at least as large as its set size.
`creativeBypassesResearchCost`Free Research in Creative	Let Creative players ignore currency and material costs when the research rules allow it.
`enableResearchPointAwards`Gameplay Currency Rewards	Give the selected currency for configured discoveries, advancements, and other events. Research Data has separate settings.
`general`General Config	Settings related to the default pack
`generalProgression`General Progression	Turn the main blueprint, discovery, Journal, and research systems on or off
`holdDurationMillis`Hold Time (seconds)	How long to hold before confirming research. Enter 0.6 for six-tenths of a second.
`interaction`Interaction	Choose how you confirm research and whether currency rewards show a message.
`magazineKeepBasicCrafting`Keep Basic Magazines Available	In Linked to Weapons mode, allow basic magazines without a learned gun, so found and traded guns can be supplied. Turn off to require a compatible learned gun for every magazine. Minimum Workbench tiers still apply.
`learnedTargetFragmentResearchPoints`Known-Weapon Fragment Reward	Currency value for ordinary fragments targeting an already-learned blueprint in Custom mode. Zero gives no currency.
`unknownExternalWorkstationsUnrestricted`Leave Unknown Workstations Unrestricted	Allow deliberately unmapped third-party workstations to ignore crafting tiers
`advancedLayout`Legacy Layout	Compatibility settings for the previous tree layout. These values are saved but do not change the current Tech Tree
`layoutPreset`Legacy Layout Preset	Saved for compatibility with the previous layout. The current Tech Tree uses automatic branch placement
`tierGap`Level Spacing	Legacy setting: Vertical space between progression levels. Does not change the current Tech Tree
`magazineProgressionMode`Magazine Access	Choose material-only crafting or require a learned compatible gun. Magazines use the add-on’s recipe costs. Loading and attachment requirements still follow TaCZ Magazines.
`maxBlueprints`Maximum Blueprint Count	Most blueprints added after a successful Custom loot roll. Cannot be below the minimum.
`maxRankBlockWidth`Maximum Level Width (Legacy)	Retained only for compatibility with older Personal Settings files
`minBlueprints`Minimum Blueprint Count	Fewest blueprints added after a successful Custom loot roll. Whole items, from 0 to 64.
`craftingUnrestrictedKinds`No-Level Crafting Categories	Categories that ignore ordinary Workbench levels but still require blueprint knowledge and Progression Gates
`craftingUnrestrictedItemTypes`No-Level Crafting Subgroups	TaCZ subgroups that ignore ordinary Workbench levels but still require blueprint knowledge and Progression Gates
`fragmentPreset`Ordinary Fragment Result	Choose what sets of ordinary loot fragments do. This does not change the special fragments earned from Analyzer or Research Data analysis.
`ordinaryFragments`Ordinary Loot Fragments	Customize fragments found in loot. Analyzer and Research Data fragments use separate datapack rules.
`debugMode`Pack Debug Mode	Whether to enable debug mode for the default pack
`exactFragmentThresholds`Per-Weapon Ordinary Fragment Counts	Override the ordinary fragment set size for a specific weapon. This does not change Analyzer fragment reconstruction.
`research_tree_client`Personal Settings	Settings for your own controls and Tech Tree display. These do not change server progression.
`progressionPreset`Progression Preset	Choose whether Research Bench tiers restrict research and Workbench levels restrict weapon crafting
`reduceMotion`Reduce Motion	Move the Research Tree camera immediately instead of easing between positions
`customEnforceCraftingTiers`Require Crafting Workbench Levels	In the Custom progression preset, require the correct Workbench level to craft a learned weapon.
`holdToResearch`Require Hold to Confirm	Require a short hold before researching a ready weapon in the fullscreen Tech Tree
`customEnforceResearchTiers`Require Research Bench Tiers	In the Custom progression preset, require a Research Bench at or above the weapon’s research tier.
`researchAccess`Research access	Choose a physical bench or portable research. Costs, prerequisites, advancements and custom milestones still apply. Changing this reloads recipes and closes open research stations.
`researchCostMode`Research Cost Type	Choose whether research requires currency, materials, or both. Datapack prices remain unchanged.
`researchCurrencyKind`Research Currency	Choose what players spend and earn: carried items such as Scrap, or saved Research Points.
`researchData`Research Data	Choose what Notes, Reports, and Dossiers produce and which weapons they can target.
`enableResearchDataLoot`Research Data in Loot	Allow Notes, Reports, and Dossiers in configured loot tables. This can stay on even when Data processing is disabled.
`researchDataBehavior`Research Data Result	Choose whether Research Data produces fragments and blueprints, gives currency, or cannot be processed. Weapon analysis is configured separately.
`fragmentDiscountValue`Research Discount Amount	For Percentage, enter 25 for 25%. For Currency Units, enter a whole number of Scrap or RP. Applies to ordinary fragment discounts in Custom mode.
`fragmentDiscountType`Research Discount Type	Choose a percentage of the currency price or a fixed number of currency units. Material ingredients are not discounted.
`tieredProgression`Research Progression	Choose how Research Bench tiers and Blueprint Fragments shape progression
`researchAndPoints`Research Purchases	Choose how players pay for research and what a completed purchase gives them.
`treeResearchResultMode`Research Result	Choose whether Research Tree purchases learn recipes immediately or create blueprint items
`resetTreeAppearance`Restore Tree Appearance	Reset camera motion, branch labels, the background grid, the minimap, and saved legacy layout settings. Confirmation controls stay unchanged.
`blueprint`Server Settings	Server settings for research, crafting, loot, and the Blueprint Analyzer. Changes apply to everyone on the server.
`showBackgroundGrid`Show Background Grid	Show the optional navigation grid behind the weapon tree
`showBranchLabels`Show Branch Labels	Show branch headings where they fit without covering tree content. Also controlled by the Branch labels button.
`showResearchPointNotifications`Show Reward Messages	Show a short message when you receive Scrap or banked RP from gameplay rewards.
`singleAnalyzerDataTier`Single Analyzer: Research Data rewards	In Single Analyzer mode, use this tier’s Research Data reward tables. Does not change the Data item’s target pool or weapon analysis odds.
`startingAccess`Starting Access	Choose what players know at the start and which recipes never require blueprints
`startingBlueprints`Starting Blueprints	Blueprints learned when a player joins. Add an entry and type an item name or resource ID to search; new entries also apply to existing players without revoking prior knowledge
`stationAccess`Stations & Research Access	Choose how players access research and which Analyzer stations they need. Crafting Workbench tiers remain separate.
`magazineCrafting`TaCZ Magazines	Optional empty-magazine crafting rules. Requires TaCZ Magazines. These rules apply while blueprint progression is enabled.
`minimap`Tech Tree Minimap	Choose when the navigation minimap appears in the fullscreen Tech Tree
`tierOneFragmentThreshold`Tier 1 Fragment Threshold	Fragments required for a Tier 1 weapon under the Custom preset
`tierOneUpperPercent`Tier 1 Score Cutoff (%)	Upper score percentile assigned to Research Bench Tier 1; tied weapon scores remain together
`tierTwoFragmentThreshold`Tier 2 Fragment Threshold	Fragments required for a Tier 2 weapon under the Custom preset
`tierTwoUpperPercent`Tier 2 Score Cutoff (%)	Upper score percentile assigned to Research Bench Tier 2; higher scores use Tier 3
`tierThreeFragmentThreshold`Tier 3 Fragment Threshold	Fragments required for a Tier 3 weapon under the Custom preset
`enableDiscoveryTracking`Track Blueprint Discovery	Record valid blueprints when they enter a player's inventory
`treeAppearance`Tree Appearance	Adjust camera motion, branch labels, the background grid, and the minimap.
`compactionSweeps`Tree Compaction Passes	Legacy setting: Advanced: passes used to bring related weapon branches closer together. Does not change the current Tech Tree
`maximumUndiscoveredVisibility`Undiscovered Blueprint Detail	Limit how much the Journal reveals before discovery. Datapacks can reveal less; learned blueprints remain fully visible
`unknownWorkstationFallbackTier`Unknown Workstation Fallback Tier	Tier assigned to TaCZ-compatible crafting workstations without an exact mapping
`linkedAmmoFallbackTier`Unlinked Ammo Fallback Level	Workbench level used when Match Gun Level cannot find a trusted compatible gun
`interGroupGap`Weapon Group Spacing (Legacy)	Retained only for compatibility with older Personal Settings files
`nodeGap`Weapon Spacing	Legacy setting: Space between weapon nodes and closely related progression steps. Does not change the current Tech Tree

Blueprint

Option	What it does
`ACCESSIBLE`Accessible	Faster discovery for large catalogs: full visibility, 35% default chance, and 1-3 blueprints
`MANUAL_RECYCLING`Allow Manual Recycling	Let players recycle eligible duplicate blueprints at the Blueprint Analyzer for Scrap or banked RP.
`TIER_1`Always Level 1	Require a Level 1 or better Workbench for ammo
`TIER_2`Always Level 2	Require a Level 2 or better Workbench for ammo
`TIER_3`Always Level 3	Require a Level 3 Workbench for ammo
`ammo`	Ammunition
`ANALYSIS`Analyze Data	Analyze one Data item at a time. Notes target Tier 1, Reports Tiers 1–2, and Dossiers Tiers 1–3 unless a datapack changes their pools.
`UNRESTRICTED`Any Level	Ignore Workbench level; other blueprint requirements still apply.
`attachment`Attachments	Make every attachment recipe available without a blueprint
`singleAnalyzer`	Available when Analyzer setup is Single Analyzer
`BALANCED`Balanced	Recommended pacing: full visibility, 20% default chance, and 1-2 blueprints
`BANKED_RP`Banked RP	Save Research Points on each player instead of giving currency items. Existing currency items are not converted.
`dataAnalysis`	Choose Analyze Data as the Research Data result to edit target options.
`linkedMagazines`	Choose Linked to Weapons to change basic magazine access.
`physicalCurrency`	Choose Physical Item as the research currency to edit this setting.
`currencyLoot`	Choose Physical Item currency and enable Currency in Loot to edit this limit.
`CLASSIC`Classic	Do not enforce Research Bench tiers; useful for existing worlds and compatibility
`CREATE_BLUEPRINT`Create Blueprint Item	Research Tree purchases create a blueprint item that must be used to learn the recipe
`POINTS_AND_ITEMS`Currency and Materials	Require the configured currency amount and material ingredients.
`DIRECT_RP_ONLY`Currency Only	Offer direct recycling for the selected currency instead of weapon analysis.
`POINTS_ONLY`Currency Only	Require the configured currency amount and ignore material ingredients.
`LEGACY_CURRENCY`Currency Only	Redeem Research Data for configured Scrap or banked RP amounts instead of fragments or blueprints.
`FIXED`Currency Units	Subtract a fixed number of Scrap or RP from the research currency price.
`CUSTOM`Custom	Use the custom visibility, chance, minimum, and maximum values below
`DISABLED`Disable Workbench Crafting	Prevent ammo from being crafted at these Workbenches
`DISABLED`Disabled	Disable this crafting rule or ordinary fragment use.
`researchPointAwards`	Enable Blueprint Progression and Gameplay Currency Rewards to change this setting
`researchEnabled`	Enable Blueprint Progression and Research to change this setting
`blueprintsEnabled`	Enable Blueprint Progression to change this setting
`extended_mag`	Extended Magazines
`FULL`Full Details	Reveal all information allowed by the active datapack rules
`grip`	Grips
`gun`Guns	Make every gun recipe available without a blueprint
`HIDDEN`Hidden	Do not show undiscovered blueprints
`KEEP`Keep as Items	Keep learned duplicate blueprints as tradeable items and prevent recycling
`laser`	Lasers
`DIRECT_LEARN`Learn Immediately	Research Tree purchases immediately unlock the recipe without creating an item
`TIER_1`Level 1	Require a Level 1 or better Workbench.
`TIER_2`Level 2	Require a Level 2 or better Workbench.
`TIER_3`Level 3	Require a Level 3 Workbench.
`LINKED_WEAPON`Linked to Weapons	Learning any compatible gun unlocks its shared magazine family. Progression-exempt guns also qualify. Keep Basic Magazines Available can preserve access for found guns.
`mg`	Machine Guns
`RECONSTRUCT_BLUEPRINT`Make a Blueprint	Completed ordinary fragment sets create a blueprint under the active learning rules.
`LINKED_WEAPON`Match Gun Level	Make ammo available at the earliest Workbench level used by a compatible tiered gun
`COMPATIBILITY`Materials Only	Craft empty magazines without learning a gun blueprint, at the minimum Workbench tiers below.
`ITEMS_ONLY`Materials Only	Require material ingredients and ignore the separate currency price.
`muzzle`	Muzzle Attachments
`UNRESTRICTED`No Level Requirement	Allow learned or blueprint-free ammo at every valid Workbench
`banked_only`	Only applies to banked RP.
`PERCENTAGE`Percentage	Reduce the research currency price by a percentage.
`PHYSICAL_ITEM`Physical Item	Use a carried item as currency. Scrap is the default; change the item below if needed.
`pistol`	Pistols
`PLAYER_CHOICE`Player Choice	Offer analysis or direct currency recycling. Analysis uses tier odds and its resulting blueprints may be recyclable.
`PORTABLE`Portable Research — no bench required	Open the Tech Tree with the Journal / Research key. Bench-tier requirements are satisfied; costs and other progression requirements remain.
`PREVIEW`Preview	Reveal the name, icon, and a limited research summary
`PROTECTED_BLUEPRINT_ONLY`Protected Analysis	Offer analysis only. Resulting blueprints cannot be recycled. Tier odds can produce a blueprint, fragments, or no reward.
`RECYCLABLE_BLUEPRINT`Recyclable Analysis	Offer analysis only. Resulting blueprints may be recycled when the other rules allow it. Tier odds still apply.
`TIERED_RESEARCH_AND_CRAFTING`Research + Crafting	Require the appropriate Research Bench tier to research and Workbench level to craft
`TARGETED_RESEARCH_BOOST`Research Discount	Completed ordinary fragment sets reduce the matching research currency cost.
`rifle`	Rifles
`rpg`	Rocket Launchers
`SCARCE`Scarce	Slower discovery: names only, 10% default chance, and exactly 1 blueprint
`scope`	Scopes
`customDiscovery`	Select the Custom Discovery and Loot Preset to change this setting
`customProgression`	Select the Custom Research Progression preset to change this setting
`linkedAmmo`	Set Ammo Crafting to Match Gun Level to change this setting
`recyclingEnabled`	Set Duplicate Blueprints to Manual Recycling to change this setting
`customFragments`	Set Ordinary Fragment Result to Custom to change this setting
`shotgun`	Shotguns
`SILHOUETTE`Silhouette	Show that an undiscovered blueprint exists without revealing its identity
`SINGLE`Single Analyzer	Use one Analyzer for every weapon tier. Existing higher-tier stations work the same way.
`SINGLE`Single Research Bench	One Research Bench handles every tier and satisfies bench-tier requirements. Crafting tiers stay unchanged.
`sniper`	Sniper Rifles
`stock`	Stocks
`smg`	Submachine Guns
`TIER_1`	Tier 1
`TIER_1`Tier 1 Data rewards	Use the Research Data reward tables normally used by a Tier 1 Analyzer.
`TIER_2`	Tier 2
`TIER_2`Tier 2 Data rewards	Use the Research Data reward tables normally used by a Tier 2 Analyzer.
`TIER_3`	Tier 3
`TIER_3`Tier 3 Data rewards	Use the Research Data reward tables normally used by a Tier 3 Analyzer.
`TIERED`Tiered Analyzers	Use Basic, Advanced and Experimental Analyzers with rewards based on both tiers.
`TIERED_RESEARCH`Tiered Research	Require an appropriate Research Bench tier to research, but allow learned weapons at every Workbench level
`TIERED`Tiered Research Benches	Require the appropriate Research Bench tier. This overrides the research part of the progression preset.
`PRESET`Use existing progression preset	Compatibility option for existing worlds. Preserve the preset’s research-tier rules and explicit datapack bench requirements.
`PROFILE`Use Profile	Use the active datapack profile's ammo crafting rules

Research Tree Client

Option	What it does
`ALWAYS`Always	Show the minimap whenever the fullscreen Tech Tree contains research nodes
`AUTOMATIC`Automatic	Show the minimap only when the Tech Tree is meaningfully larger than the usable screen area
`BALANCED`Balanced	Balanced spacing for the previous layout; does not change the current Tech Tree
`COMPACT`Compact	Compact spacing for the previous layout; does not change the current Tech Tree
`CUSTOM`Custom	Use saved custom spacing in the previous layout; does not change the current Tech Tree
`holdToResearch`	Enable Require Hold to Confirm to change this setting
`HIDDEN`Hidden	Never show the Tech Tree minimap
`button`	Restore Defaults
`customLayout`	Select the Custom layout preset to change this setting
`SPACIOUS`Spacious	Spacious spacing for the previous layout; does not change the current Tech Tree