• BaseConversion: Object
The properties that are added onto a processed ConversionOptions to create a Conversion.
| Name | Type | Description |
|---|---|---|
convert | VoidFunction | The function that performs the actual conversion. |
profectus/src/features/conversion.ts:84
• ConversionOptions: Object
An object that configures a Conversion.
| Name | Type | Description |
|---|---|---|
actualGain? | Computable<DecimalSource> | The absolute amount the output resource will be changed by. Typically this will be set for you in a conversion constructor. This will differ from currentGain in the cases where the conversion isn't just adding the converted amount to the output resource. |
baseResource | Resource<DecimalSource> | The input Resource for this conversion. |
buyMax? | Computable<boolean> | Whether or not to cap the amount of the output resource gained by converting at 1. Defaults to true. |
convert? | VoidFunction | The function that performs the actual conversion from baseResource to gainResource. Typically this will be set for you in a conversion constructor. |
currentAt? | Computable<DecimalSource> | The amount of the input resource currently being required in order to produce the currentGain. That is, if it went below this value then currentGain would decrease. Typically this will be set for you in a conversion constructor. |
currentGain? | Computable<DecimalSource> | How much of the output resource the conversion can currently convert for. Typically this will be set for you in a conversion constructor. |
formula | (variable: GenericFormula & { invert: (value: DecimalSource) => DecimalSource } & { evaluateIntegral: (variable?: DecimalSource) => DecimalSource } & { invertIntegral: (value: DecimalSource) => DecimalSource }) => InvertibleFormula | The formula used to determine how much gainResource should be earned by this converting. The passed value will be a Formula representing the baseResource variable. |
gainResource | Resource<DecimalSource> | The output Resource for this conversion. i.e. the resource being generated. |
nextAt? | Computable<DecimalSource> | The amount of the input resource required to make currentGain increase. Typically this will be set for you in a conversion constructor. |
onConvert? | (amountGained: DecimalSource) => void | A callback that happens after a conversion has been completed. Receives the amount gained via conversion. This will not be called whenever using currentGain without calling convert (e.g. passive generation) |
spend? | (amountGained: DecimalSource) => void | The function that spends the baseResource as part of the conversion. Defaults to setting the baseResource amount to 0. |
profectus/src/features/conversion.ts:20
Ƭ Conversion<T>: Replace<T & BaseConversion, { actualGain: GetComputableTypeWithDefault<T["actualGain"], Ref<DecimalSource>> ; buyMax: GetComputableTypeWithDefault<T["buyMax"], true> ; currentAt: GetComputableTypeWithDefault<T["currentAt"], Ref<DecimalSource>> ; currentGain: GetComputableTypeWithDefault<T["currentGain"], Ref<DecimalSource>> ; formula: InvertibleFormula ; nextAt: GetComputableTypeWithDefault<T["nextAt"], Ref<DecimalSource>> ; spend: undefined extends T["spend"] ? (amountGained: DecimalSource) => void : T["spend"] }>
An object that converts one Resource into another at a given rate.
| Name | Type |
|---|---|
T | extends ConversionOptions |
profectus/src/features/conversion.ts:92
Ƭ GenericConversion: Replace<Conversion<ConversionOptions>, { actualGain: ProcessedComputable<DecimalSource> ; buyMax: ProcessedComputable<boolean> ; currentAt: ProcessedComputable<DecimalSource> ; currentGain: ProcessedComputable<DecimalSource> ; nextAt: ProcessedComputable<DecimalSource> ; spend: (amountGained: DecimalSource) => void }>
A type that matches any valid Conversion object.
profectus/src/features/conversion.ts:106
▸ createConversion<T>(optionsFunc): Conversion<T>
Lazily creates a conversion with the given options. You typically shouldn't use this function directly. Instead use one of the other conversion constructors, which will then call this.
See
| Name | Type |
|---|---|
T | extends ConversionOptions |
| Name | Type | Description |
|---|---|---|
optionsFunc | OptionsFunc<T, BaseConversion, GenericConversion> | Conversion options. |
Conversion<T>
profectus/src/features/conversion.ts:125
▸ createCumulativeConversion<S>(optionsFunc): Conversion<S>
Creates a conversion that simply adds to the gainResource amount upon converting. This is similar to the behavior of "normal" layers in The Modding Tree. This is equivalent to just calling createConversion directly.
| Name | Type |
|---|---|
S | extends ConversionOptions |
| Name | Type | Description |
|---|---|---|
optionsFunc | OptionsFunc<S, BaseConversion, GenericConversion> | Conversion options. |
Conversion<S>
profectus/src/features/conversion.ts:200
▸ createIndependentConversion<S>(optionsFunc): Conversion<S>
Creates a conversion that will replace the gainResource amount with the new amount upon converting. This is similar to the behavior of "static" layers in The Modding Tree.
| Name | Type |
|---|---|
S | extends ConversionOptions |
| Name | Type | Description |
|---|---|---|
optionsFunc | OptionsFunc<S, BaseConversion, GenericConversion> | Converison options. |
Conversion<S>
profectus/src/features/conversion.ts:211
▸ setupPassiveGeneration(layer, conversion, rate?, cap?): void
This will automatically increase the value of conversion.gainResource without lowering the value of the input resource. It will by default perform 100% of a conversion's currentGain per second. If you use a ref for the rate you can set it's value to 0 when passive generation should be disabled.
| Name | Type | Default value | Description |
|---|---|---|---|
layer | BaseLayer | undefined | The layer this passive generation will be associated with. Typically this when calling this function from inside a layer's options function. |
conversion | GenericConversion | undefined | The conversion that will determine how much generation there is. |
rate | Computable<DecimalSource> | 1 | A multiplier to multiply against the conversion's currentGain. |
cap | Computable<DecimalSource> | Decimal.dInf | A value that should not be passed via passive generation. |
void