Life Cost API

版本 v4.0.1·更新於 2024-02-18

An API introducing a Life and Currency cost system to inscryption for cards and activated sigils. For modmakers and json card creators.

模組介紹 作者原文

Intro

This API adds the ability to make cards cost life, currency, or both in act 1, and and act 2. It also allows Sigil makers to easily make Activated Sigils that cost Life, money, or the hybrid version. It's features include...

  • Art that matches vanilla style for the cost for act 1 and act 2, which scales up to 15.
  • Cost render support with art that matches the art in the cost render fix, for those who want to do hybrid costs
  • Cards that cost life, money, or hybrid will show up as a cost choice at cost choice nodes
  • Json loader support
  • Custom act 2 icons (both vanilla and Cost Render Fix) for just currency using cards and just life using cards
  • Six Life / Currency active Sigils for people to playwith.

How to use: Mod makers

Here are instructions on how to use this API as a person who codes with a bepinEX plugin

  • Add the mod as a dependency in your project
  • While making a card, use the following three extensions depending on what you want... '.SetExtendedProperty("LifeCost", value)', '.SetExtendedProperty("MoneyCost", value)', or '.SetExtendedProperty("LifeMoneyCost", value)'
  • Another trick (for backwards compatability) is to set the energycost of a card to a negative number. This mod will find that card, and change it into a LifeMoney cost.

This mod also allows you to make active sigils easily that cost life, money, or both. Follow the instructions below to figure out how!

  • Add this mod as a dependency, and then when making the ability class, extend LifeCost.sigils.LifeActiveAbilityCost
  • This allows you to set the cost of active abilities to Life, Money, Life+Money, Energy, or Bone (or a mix of the 4 Options).
  • DO NOT mix the Life+Money option with the Life or money option. Life+Money is a special option that will substitute any lacking funds with life.
  • Includes templates of the activated sigils base when you download this mod, if you want to keep consistent with it.

How to use: Jsonloader users

Here are instructions on how to use this API as a person who makes cards in jsonloader

  • Set an extended property like below.

"extensionProperties": {

"LifeMoneyCost": "4"

}

What if I only want to a card to use Life / What if I want a card to only use Currency?

Here are instructions on how to use this API to make a card cost ONLY life or ONLY currency.

for ONLY life you want...

-.SetExtendedProperty("LifeCost", value)

for ONLY currency you want...

-.SetExtendedProperty("MoneyCost", value)

Sigils for Modmakers to use...

These are under the GUID of "extraVoid.inscryption.LifeCost"

  • "Max Energy Gamble": Pay 6 energy to put 0 to 3 damage on someone's side of the scale
  • "Cash Converter": Pay 4 foils to put 1 damage on the opponent's side of the scale
  • "Life Converter": Pay 2 life to gain 1 foils
  • "Vamperic Strength": Pay 3 life to increase power and health by 1
  • "Greedy Strength": Pay 5 currency to increase power and health by 1
  • "Die Roll": Pay 3 life for the card bearing this sigil to gain between 0 and 6 increased in stats, distributed randomly

Suggestions on balancing life cost cards

Just some helpful tips I noticed when making this and play testing

  • Never make the attack of a card more than what it costs in life. For example: a card with 1 attack would cost between 2 and 3 in life. So it takes 2 to 3 turns to make up for the lost in life.
  • In act 1, I would generally suggest following the 1:1 point system like bones and energy does.
  • In act 2, be VERY careful with balancing your cards. I highly suggest making them only LifeCost. This is due to players being able to farm foils at the training dummy.
  • Try to avoid bone or energy hybrid costs.
  • In the end, play by ear and heart like always. if something feels too good, then nerf it. If it feels too weak, then buff it.

Installation (automated)

This is the recommended way to install the API on the game.

  • Download and install Mod Manager or r2modman
  • Click Install with Mod Manager button on top of the [page]
  • Run the

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack_InscryptionAPI_dev-API

檔案與校驗

檔案名稱
Life_Cost_API-4.0.1.zip
檔案大小
121.6 KiB