Modding:Powers - Revision history

imported>Sunbeam135: added ru link

2026-03-13T18:48:53Z

added ru link

← Older revision		Revision as of 18:48, 13 March 2026
Line 70:		Line 70:
	[[Category:Modding]]		[[Category:Modding]]

			[[ru:Модификации:Способности]]
	[[zh:模组:能力]]		[[zh:模组:能力]]

imported>VulpesLucida: + zh link

2025-08-16T11:52:15Z

+ zh link

← Older revision		Revision as of 11:52, 16 August 2025
Line 69:		Line 69:

	[[Category:Modding]]		[[Category:Modding]]

			[[zh:模组:能力]]

imported>BarleyZP: Update page, including example. Remove stub notice.

2025-06-06T20:26:53Z

Update page, including example. Remove stub notice.

← Older revision		Revision as of 20:26, 6 June 2025
Line 1:		Line 1:
	~~{{stub}}~~

	← [[Modding:Index\|Index]]		← [[Modding:Index\|Index]]

	This page explains how ~~to add~~ and ~~edit~~ [[Special Items & Powers~~\|powers~~]]~~, also known as "special items"~~. It is an advanced guide for ~~modders.~~		This page explains how the game stores and parses data for [[Special Items & Powers]]. This is an advanced guide for mod developers.
	~~'''Before reading this page''', see [[Modding:Editing XNB files]] for the basic concepts~~.

	==Overview==		==Overview==
	Powers are unique "items" that can be obtained only once per player, and permanently unlock new abilities. Information for powers is stored in <samp>Data/Powers</samp>. This does '''not''', by itself, add any abilities to the player. It contains information used to display powers in the menu, and unlock them when needed.		Powers are unique "items" that can be obtained only once per player, and permanently unlock new abilities. Information for powers is stored in <samp>Data/Powers</samp>. This does '''not''', by itself, add any abilities to the player. It contains information used to display powers in the menu, and unlock them when needed.

	==~~Format~~==		==Data format==

			You can add/edit [[Special Items & Powers]] by editing the <samp>Data/Powers</samp> data asset.

			This consists of a string → model lookup, where...
			* The key is a [[Modding:Common data field types#Unique string ID\|unique string ID]] for the entry.
			* The value is a model with the fields listed below.

	{\| class="wikitable"		{\| class="wikitable"
	! Field		! Field
Line 21:		Line 25:
	\|-		\|-
	\| <samp>TexturePath</samp>		\| <samp>TexturePath</samp>
	\| The ~~path to~~ the texture ~~to use for the item sprite~~.		\| The asset name for the power's icon texture.
	\|-		\|-
	\| <samp>TexturePosition</samp>		\| <samp>TexturePosition</samp>
	\| The pixel coordinates of the upper left corner of the sprite in the texture~~. Sprites are always~~ <samp>~~16 x 16~~</samp>		\| The pixel coordinates of the upper left corner of the sprite in the texture, provided as an object with <samp>X</samp> and <samp>Y</samp> fields. Sprites are always 16 by 16.
	\|-		\|-
	\| <samp>UnlockedCondition</samp>		\| <samp>UnlockedCondition</samp>
	\| A [[Modding:Game state queries\|game state query]] used to determine whether or not the item has been unlocked.		\| A [[Modding:Game state queries\|game state query]] used to determine whether or not the item has been unlocked.
			\|-
			\| <samp>CustomFields</samp> ''(Optional)''
			\| The [[Modding:Common data field types#Custom fields\|custom fields]] for this entry.
	\|}		\|}

	~~==Raw~~ Data==		For example, this Content Patcher pack adds a custom pufferfish power, which is unlocked after the player catches a pufferfish:
	~~TODO~~
			{{Content Patcher example\|<nowiki>
			"Changes": [
			// load the icon for the powers tab
			{
			"Action": "Load",
			"Target": "Mods/{{ModId}}/PufferIcon",
			"FromFile": "assets/PufferIcon.png"
			},

			// add the power
			{
			"Action": "EditData",
			"Target": "Data/Powers",
			"Entries": {
			"{{ModId}}_Pufferpower": {
			"DisplayName": "Puffer's Blessing",
			"Description": "You feel as if you have become one with the pufferfish...",
			"TexturePath": "Mods/{{ModId}}/PufferIcon",
			"TexturePosition": {
			"X": 0, // top-left corner of the canvas, assuming that this is the only sprite in the icon image
			"Y": 0
			},
			"UnlockedCondition": "PLAYER_HAS_CAUGHT_FISH Current 128", // the player has caught a pufferfish
			}
			}
			}
			]
			</nowiki>}}

	[[Category:Modding]]		[[Category:Modding]]

imported>Tlitookilakin: /* Raw Data */

2024-03-26T22:34:21Z

Raw Data

← Older revision		Revision as of 22:34, 26 March 2024
Line 32:		Line 32:
	==Raw Data==		==Raw Data==
	TODO		TODO

			[[Category:Modding]]

imported>Tlitookilakin: Create page

2024-03-26T22:33:41Z

Create page

New page

{{stub}}

← [[Modding:Index|Index]]

This page explains how to add and edit [[Special Items & Powers|powers]], also known as "special items". It is an advanced guide for modders.
'''Before reading this page''', see [[Modding:Editing XNB files]] for the basic concepts.

==Overview==
Powers are unique "items" that can be obtained only once per player, and permanently unlock new abilities. Information for powers is stored in <samp>Data/Powers</samp>. This does '''not''', by itself, add any abilities to the player. It contains information used to display powers in the menu, and unlock them when needed.

==Format==
{| class="wikitable"
! Field
! Description
|-
| <samp>DisplayName</samp>
| A [[Modding:Tokenizable strings|tokenizable string]] used to display the translated name of the item, once unlocked.
|-
| <samp>Description</samp> ''(Optional)''
| A [[Modding:Tokenizable strings|tokenizable string]] used to display the translated description of the item, once unlocked.
|-
| <samp>TexturePath</samp>
| The path to the texture to use for the item sprite.
|-
| <samp>TexturePosition</samp>
| The pixel coordinates of the upper left corner of the sprite in the texture. Sprites are always <samp>16 x 16</samp>
|-
| <samp>UnlockedCondition</samp>
| A [[Modding:Game state queries|game state query]] used to determine whether or not the item has been unlocked.
|}

==Raw Data==
TODO