Free Samples

Free Samples

Multiplayer compatible!

_If you enjoy my work, please consider donating to my completely optional tip jar._

Whenever you unlock a technology that grants you a recipe, receive a configurable amount of 'free samples' of that recipe. For equipment and component crafting recipes, this is the output product. For buildings, this is the ingredients for the building. Every player in multiplayer gets a copy of the free sample items.

For example, under the mod's default settings, unlocking the Nobelisk Detonator MAM node will give you one Nobelisk Detonator and 50 Nobelisk, unlocking the Jump Pads T2 milestone will give you the ingredients to construct 5 Jump Pads and 5 U-Jelly Landing Pads, etc.

The free sample packages will be inserted directly into your player inventory. If there isn't enough space, they will be held for claiming later. You can also opt to require manually claiming them via the /claimSamples chat command, and use /claimSamples force to drop them near you in crates if they can't fit in your inventory. You can see what packages you have pending via the /listUnclaimed chat command.

Should be compatible with all mods that add recipes and schematics, including those that do so via runtime content generation like ContentLib. The mod does not retroactively provide samples for schematics unlocked before it was installed.

Inspired by Archipelago's Free Samples system for Factorio <!-- and created primarily for use as a dependency of the Satisfactory Archipelago mod. -->

Configuration

Customize the following via the mod's config options:

• If the mod's functionality is enabled at all
• The amount of free samples you receive
• Separate quantity controls for equipment items, buildings, and components
• By default: 1 equipment item, 5 sets of building ingredients, and 1 stack of component items
• If items will be given automatically, or if you must claim them via the /claimSamples chat command.
• By default: Items automatically given
• How often the mod will attempt to give you items (or remind you about items you haven't claimed yet)
• By default: Every 60 seconds, or whenever a new schematic is unlocked.
• Set to 601 seconds to turn off the reminder timer.
• If 'force claimed' samples will be dropped as crates or item pickups
• By default: Dropped as crates
• If the mod will give you radioactive items as samples
• By default: Exclude radioactive items
• Specific Schematics, Recipes, and Items to exclude from free sample consideration
• By default: Don't supply the construction cost of the Space Elevator, and don't supply samples when you unlock the default recipes for Project Parts.
• Easy-to-use config interface helps you make these exclude lists yourself by searching for loaded recipes
• 

Known Bugs

None, but the following base-game bugs affect this mod's functionality:

• Multiplayer clients do not display the correct message content from code-generated chat messages
• This could cause clients to see useless information when running the /listUnclaimed command, for example, but they will still be able to claim samples without issue.

Questions? Suggestions? Join the Nog's Mods Discord server or leave an issue on the GitHub issues page (slower response time)

For Developers

This mod automatically functions with every schematic except those granted before the subsystem initializes, so schematics rewarded very early (ex. Schematic_StartingRecipes) will not be considered for samples. You can also add schematics, recipes, and items to the mod's exclude lists via the C++ or Blueprint API, or via specially-named fields on your Game World Module (see dedicated header below).

The source code is public.

By enabling debug mode you gain access to the following chat commands:

• /cc_directClaimSample <schematicSoftClassPath> [force?]

triggers the sample claim code for a schematic without checking or recording it to the player's claim records. Example: /cc_directClaimSample /Game/FactoryGame/Schematics/Research/AlienTech_RS/Research_Alien_PowerBooster.Research_Alien_PowerBooster_C true will drop the samples from the "Power Augmenter" schematic near you.

• /cc_resetSamples resets the subsystem's saved reward data, as well as the caller's.
• /cc_samplesDebugData sends info to the logs about the global and command caller's samples.

Using Mam Enhancer's debug mode makes it very easy to grant/revoke schematics for testing the exclude lists, for example.

This mod implements some features in C++ to allow for C++ only mods to affect the mod's configuration. Highlights include:

• A getter exists for the mod's subsystem, which is backed by a C++ class
• The config struct C++ header is generated
• Mods can interact with the subsystem's ignore lists to add/remove items from them separate from the user's selected configuration options

Zero Dependency Interaction

If you don't want your mod's code to in any way reference FreeSamples but you still wish to influence its behavior, there are two options:

First, you can use the FreeSamples.Skip Content Tag to mark schematics, recipes, and items that you don't want to be considered for free samples.

Second, you can create fields on your mod's Root Game World Module with specific names and types. FreeSamples will check all mods' Root Game World Modules for fields of the following names at Game World Module Initialization time: