Blueprint Modding

From Starsector Wiki
Jump to navigation Jump to search

This page is about creating blueprints for mods. The page for blueprints as a gameplay mechanic is here.

Single Blueprints

Single blueprints are automatically generated for each ship, weapon, fighter and industry in the game. Tags can be added directly to the "tags" column of a ship, weapon or wing's entry in ship_data.csv, weapon_data.csv or wings.csv respectively in order to influence the behavior of its blueprints.

Blueprints have the IDs "ship_bp", "fighter_bp", "weapon_bp" or "industry_bp", with the learnable item's ID as its special data.

Take care to add tags to a fighter wing, not the fighter itself, as this can cause unintended behavior.

Tags

These tags are added directly to the "tags" column of a ship, weapon or fighter wing's entry in ship_data.csv, weapon_data.csv or wings.csv respectively.

  • base_bp

Ships, weapons and wings with this tag are automatically added to the list of blueprints known by most factions (including the player) at the start of the game.

  • rare_bp

Ships, weapons and wings with this tag can drop as a single blueprint during salvage operations.

  • no_bp_drop

Ships, weapons and wings with this tag will not drop when raiding a planet with Heavy Industry, Orbital Works or a similar industry.

  • Faction tags

Every functional faction in the game has its own unique tag (for example, the Persean League's tag is "persean"). These tags can be found in the .faction file of each faction. Adding one of these tags to a ship, weapon or wing will add it to the "known" list of that faction, functionally identical to adding it via the .faction file.

Blueprint Packages

Blueprint packages are defined within special_items.csv. Blueprint packages can define a tag in the "plugin params" column. When this tag is added to a ship, weapon or fighter wing, it will be included in the blueprint package.

Adding something to a package does not exclude it from dropping as a single blueprint if it also has the rare_bp tag.

Raiding

When raiding that knows the blueprint package and has a Heavy Industry or equivalent, the player will not be able to receive the package as a reward. Instead, ships, weapons and wings from the package will drop as a single blueprint, even if they do not have the rare_bp tag.

Graphics

Graphics for packages are not automatically generated like those for single blueprints, and are defined within settings.json inside the element "graphics":{"blueprint_packages}:{"packageID":"filenamepath"} { "graphics":{ "blueprint_packages":{ "<packageID>":"graphics/cargo/icon/<iconfilename>", }, }, }

  • Package picture size ratio is 64 x 40

Tags

These tags are applied to the "tags" column of a blueprint package in special_items.csv.

  • no_drop

Prevents a blueprint package from dropping during exploration missions. Individual ships, weapons and fighters in the package can still be obtained by raiding a faction that knows the package, but the blueprint package itself is not obtainable during normal gameplay.

Icon cross.png
At least two versions out of date. Last verified for version 0.9.1. Please refer to Version History and update this page.