Economy Shop API (ESAPI)

Economy Shop API (ESAPI) lets you modify NPC faction shops without replacing vanilla (or modded) economy files.

Add ships, items, gases, and contract (number) changes using simple XML files.

The biggest advantage is that ESAPI mods don't conflict with each other. A ship pack, item pack, and economy rebalance mod can all make changes at the same time and ESAPI merges everything automatically.

This tool will let you easily turn a blueprint into a shop mod:
https://www.kevmeup.com/se/se1/tools/prefabmaker.html
Mirror

If you want to create a collection, simply combine your mods into a single folder structure.

Example Shop Collections:
ESAPI - KevMeUp Shop Grid Collection
ESAPI - CosmicDonut Shipyards

👍 Support This Item
If this helped, a 👍 Thumbs Up improves visibility and helps others find it.
Comments and bug reports are always welcome.

More ESAPI Mods mods

More Economy mods

Making Content Mods for Economy Shop API

This guide is for mod authors creating ESAPI add-ons.

How It Works

ESAPI is the framework. Your mod provides XML rules.
Rules are loaded when the world starts.
Multiple ESAPI mods can add and remove content without conflicts.
Only include the XML files you actually need.

Folder Layout

Place your config files in:

MyEsapiMod\
  Data\
    Config\
      ShopShips.xml
      ShopItemsSelling.xml
      ShopItemsBuying.xml
      ShopGases.xml
      ShopContracts.xml

Include only the files your mod uses.

If you're distributing ships, place your prefab SBC files and thumbnails in the normal prefab folders just like any other ship pack.

Factions

Every rule supports a Faction attribute.

Faction="*"

Available values:

*
Miner
Trader
Builder
Pirate
Military

Wildcard rules apply first. Faction-specific rules override them.

Add vs Remove

Add places content into a faction's available shop pool.
Remove removes content from the pool and clears matching existing offers from saved games.

ShopShips.xml

Adds or removes ship prefabs from NPC station stores.

<?xml version="1.0" encoding="utf-8"?>
<ShopShipsConfig>

  <Add Faction="*">
    <Prefab>MyShipPack_Scout</Prefab>
  </Add>

  <Remove Faction="*">
    <Prefab>VanillaShip</Prefab>
  </Remove>

</ShopShipsConfig>

Use prefab subtype names, not display names.

ShopItemsSelling.xml

Controls items NPC stations sell.

<?xml version="1.0" encoding="utf-8"?>
<ShopItemsSellingConfig>

  <Add Faction="*">
    <Item TypeId="Component" SubtypeId="SteelPlate"/>
  </Add>

</ShopItemsSellingConfig>

Items are identified by TypeId and SubtypeId.

ShopItemsBuying.xml

Controls items NPC stations buy.

<?xml version="1.0" encoding="utf-8"?>
<ShopItemsBuyingConfig>

  <Add Faction="*">
    <Item TypeId="Component" SubtypeId="ZoneChip"/>
  </Add>

</ShopItemsBuyingConfig>

Uses the same format as ShopItemsSelling.xml.

ShopGases.xml

Controls Oxygen and Hydrogen refueling offers.

<?xml version="1.0" encoding="utf-8"?>
<ShopGasesConfig>

  <Gas Faction="*" Name="Oxygen" Sell="true"/>
  <Gas Faction="*" Name="Hydrogen" Sell="true"/>

  <OfferAmount Faction="*"
               Minimum="5000"
               Maximum="45000"/>

</ShopGasesConfig>

Only Oxygen and Hydrogen are supported.

ShopContracts.xml

Controls the maximum number of active contracts available at NPC stations.

<?xml version="1.0" encoding="utf-8"?>
<ShopContractsConfig>

  <MaxContractCount Faction="*"
                    Value="50"/>

</ShopContractsConfig>

Vanilla default is 25.

Publishing

*Ensure you're not publishing other people's prefabs without permission. You're welcome to make local only mod to add them to the shop though.

Publish your content mod normally.
Add Economy Shop API (ESAPI) as a required dependency.
Enable both ESAPI and your content mod in the world.

------------------------- Support -------------------------
❤️ If my mods or blueprints have been useful and you’d like to support future work:
https://buymeacoffee.com/sewithkev

------------------------- Tutorials -------------------------
📺 Space Engineers Tutorials
https://www.youtube.com/@SEWithKev

------------------------- Extras ---------------------------
🐦 X (screenshots & builds)
https://x.com/SEWithKev

------------------------- More Mods & Blueprints ----------------
🔧 Workshop Collection (follow for new builds & mods)
https://steamcommunity.com/id/kevmeup/myworkshopfiles

------------------------- Contact -------------------------
💬 Discord (SE support & discussion)
https://discord.gg/mxZdmvbpkb