61 lines
3.1 KiB
Markdown
61 lines
3.1 KiB
Markdown
|
# Upgrades
|
||
|
|
|
||
|
|
Useful functions for dealing with Upgrades and implementing their effects:
|
||
|
|
|
||
|
|
- hasUpgrade(layer, id): determine if the player has the upgrade
|
||
|
|
- upgradeEffect(layer, id): Returns the current effects of the upgrade, if any
|
||
|
|
- buyUpgrade(layer, id): Buys an upgrade directly (if affordable)
|
||
|
|
|
||
|
|
Hint: Basic point gain is calculated in mod.js's "getPointGen".
|
||
|
|
|
||
|
|
Upgrades are stored in the following format:
|
||
|
|
|
||
|
|
```js
|
||
|
|
upgrades: {
|
||
|
|
rows: # of rows
|
||
|
|
cols: # of columns
|
||
|
|
11: {
|
||
|
|
description: "Blah",
|
||
|
|
more features
|
||
|
|
}
|
||
|
|
etc
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
Each upgrade should have an id where the first digit is the row and the second digit is the column.
|
||
|
|
Individual upgrades can have these features:
|
||
|
|
|
||
|
|
- title: **optional**, displayed at the top in a larger font
|
||
|
|
It can also be a function that returns updating text. Can use basic HTML.
|
||
|
|
|
||
|
|
- description: A description of the upgrade's effect. *You will also have to implement the effect where it is applied.*
|
||
|
|
It can also be a function that returns updating text. Can use basic HTML.
|
||
|
|
|
||
|
|
- effect(): **optional**, A function that calculates and returns the current values of any bonuses from the upgrade.
|
||
|
|
Can return a value or an object containing multiple values.
|
||
|
|
|
||
|
|
- effectDisplay(): **optional**, A function that returns a display of the current effects of the upgrade with
|
||
|
|
formatting. Default behavior is to just display the a number appropriately formatted. Can use basic HTML.
|
||
|
|
|
||
|
|
- cost: A Decimal for the cost of the upgrade. By default, upgrades cost the main prestige currency for the layer.
|
||
|
|
|
||
|
|
- unlocked(): **optional**, A function returning a bool to determine if the upgrade is visible or not. Default is unlocked.
|
||
|
|
|
||
|
|
- onPurchase() - **optional**, this function will be called when the upgrade is purchased.
|
||
|
|
Good for upgrades like "makes this layer act like it was unlocked first".
|
||
|
|
|
||
|
|
By default, upgrades use the main prestige currency for the layer. You can include these to change them (but it needs to be a Decimal):
|
||
|
|
- currencyDisplayName: **optional**, the name to display for the currency for the upgrade
|
||
|
|
- currencyInternalName: **optional**, the internal name for that currency
|
||
|
|
- currencyLayer: **optional**, the internal name of the layer that currency is stored in.
|
||
|
|
If it's not in a layer (like Points), omit. If it's not stored directly in a layer, instead use the next feature.
|
||
|
|
- currencyLocation: **optional**, if your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way.
|
||
|
|
This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)
|
||
|
|
|
||
|
|
- style: **Optional**, Applies CSS to this upgrade, in the form of an object where the keys are CSS attributes,
|
||
|
|
and the values are the values for those attributes (both as strings)
|
||
|
|
|
||
|
|
- layer: **Assigned automagically**. It's the same value as the name of this layer, so you can do player[this.layer].points or similar
|
||
|
|
|
||
|
|
- id: **Assigned automagically**. It's the "key" which the upgrade was stored under, for convenient access.
|
||
|
|
The upgrade in the example's id is 11.
|