Template:Psionic Power/doc

The Psionic Power template produces a sidebar infobox for the presentation of psionic powers in each edition. It currently covers psionic powers as presented in the 2{{nd}]-edition The Complete Psionics Handbook, the 3.5-edition Expanded Psionics Handbook and Complete Psionic, and the 4-edition Player's Handbook 3.

These are clarified as "psionic powers" throughout to avoid confusion with the more general class-feature "powers" of 4 edition and other meanings of the word, such as power, an alternative term for a deity. However, 4 edition calls its psionic powers "disciplines", while "discipline" is the term for a large group of psionic powers in 2, edition, 3, and 3.5 editions.

This template includes only essential "crunchy" statistics that allow for organization and categorization. All other crunchy details should be omitted.

This template was written to accept different values for each edition of Dungeons & Dragons. The edition-specific parameters should be used exclusively for each edition of the power. Please write the article with the evolution of psionics in mind. As this is a new template and psionics rules have changed often, even within editions, please add more parameters as they are required.

D&D 4 edition added class abilities for the monk, psion, ardent, and battlemind that had many of the same characteristics as psionic powers. Rather than having many templates that differ only slightly, they have been made pass-through templates to this one. The other related templates that are variants of this one are:

If you add/remove any of this template's parameters, they should be added/removed to/from these pass-through templates also. If you add any new variants, the Desc and Spell table templates should be updated to match the list in this template.

This template will automatically put the page in some categories based on the values of certain parameters. For example, if type2e is set to Devotion, then the page will be placed in Category:Devotions (2e) and Category:Devotions. For all editions, the page will also be put in Category:Psionic powers.

Parameters
All parameters except name are optional and, if left undefined, will not appear.

General Parameters

 * image : Optional. An image of the psionic power.
 * caption : Optional. A description of the image, if necessary. This field will be italicized for you.
 * name : Required. The name of the psionic power. It is also italicized automatically; do not surround it with  wiki markup.
 * deity : Optional. For psionic powers granted by or associated with a specific deity, link the deity's name.
 * inventor : Optional. Some psionic powers may have a known inventor. If one exists for the psionic power in question, link it here.

Edition-specific parameters

 * level4e, level3e : Optional. Please make a Spell table for each edition as needed. You must specify the edition parameter of the spell table to match this, i.e., set it to 4e or 3e. If variant (see below) is set because you are calling one of the subtemplates (like Discipline), then set it in the spell table also.
 * type4e, type3e, type2e : Optional. This is the broad spellcasting mechanic used, similar to Vancian for the Spell template. 4-edition types are At-Will, Daily, Encounter, or Ritual. The type4e parameter causes the look of the infobox to change and generate specific categories, so please use only those values listed here. For earlier editions, the psionic power casting mechanic is points-based, so write "Power points" for 3.5 edition and "Psionic strength points" for 2 edition.
 * refs4e, refs3e, refs2e : Optional. These parameters are used to put &lt;ref&gt; tags in the subtitles rather than have them clutter up a spell table or cause alignment problems in the infobox. Usually all the information comes from one source, but you can add more citations where needed.
 * Example:


 * feature4e : Optional. Some 4-edition psionic powers are considered "class features" and do not have a level, but are available to a character at level 1. Possible values for this field are Ardent Feature, Battlemind Feature, Monk Feature, and Psion Feature.
 * keywords4e : Optional. In 4 edition, these are set off by a diamond (&diams;) after the power's type and are similar to 3-edition "descriptors". See Descriptors below for a list of Desc templates to use, one for each keyword. Please list these in alphabetical order with no spaces, e.g.,.
 * category4e : Optional. A ritual in 4 edition is classified in one of nine categories: Binding, Creation, Deception, Divination, Exploration, Restoration, Scrying, Travel, and Warding. This field will be used to alter the look of the infobox and generate specific categories (for 4-edition rituals only).
 * skill4e : Optional. A ritual in 4 edition requires one of four key skills that defines the type of components required: Arcana, Heal, Nature, or Religion. Please note the skill here.
 * discipline3e, discipline2e : Optional. The five disciplines of psionics used in 2, 3, and 3.5 editions: Clairsentience, Metacreativity, Psychokinesis, Psychometabolism, Psychoportation, and Telepathy. The subdiscipline may be include in parentheses if applicable, e.g., "Psychoportation (Teleportation)".
 * mantles3e : Optional. In 3.5-edition's Complete Psionic, ardents and divine minds may choose psionic powers grouped by "mantle". If the psionic power is part of a mantle, list it here, e.g., Chaos mantle.
 * descriptors3e : Optional. Like spells, some psionic powers in 3 and 3.5 editions have these designations as another way of categorizing them. These are offset from the discipline by square brackets, e.g., [Cold] . See Descriptors below for a list of possible Desc templates; they are the same as for the Spell template. If the desc/fire descriptor is added, it will be placed in Category:Fire spells. Use  to get Category:Fire powers.
 * level2e : Optional. Psionic powers in 2 edition are grouped into only major powers, called "sciences", and minor powers, called "devotions". Write Science or Devotion here.
 * wild2e : Optional. If the psionic power can be learned as a wild talent in 2 edition, write Yes here. Otherwise, leave it blank. (In 3.5 edition, the Wild Talent feat does not grant a power, and instead any 1-level power can be acquired via the Hidden Talent campaign-specific feat, so does not require mention in this infobox.)

Advanced
These parameters are for changing the behavior of the infobox and require specific values.
 * type : Optional. This is a special parameter used to customize the infobox for 4-edition powers. Possible values are at-will, daily, encounter, or ritual and MUST be all lower-case because the name is used to create custom CSS selectors that change the color scheme to match that found in the 4-edition sourcebooks. Only specify this if the newest/only version of the power is 4 edition.
 * variant : Optional. Not shown above. This is for use by the pass-through templates. If type or type4e are set, this parameter causes the power to be called something different and be put in a different category. Possible values are: Power, Discipline, Evocation, Exploit, Hex, Prayer, Channel Divinity, Channel Divinity Prayer, and Ritual (not case sensitive; the first letter will be capitalized in the title bar). If not specified, it defaults to spell. Even if type is not set, the spell will be put in . The default is Category:Spells. NOTE: If this is set, any keywords, descriptors, or spell tables should also have their variant set to the same value.
 * nocat : Optional. Not shown above. Setting this to  will suppress the generation of categories for this power&mdash;mainly used for documentation pages like this one. Note that each keyword, descriptor, and spell table has its own nocat parameter.

Descriptors
There exist preset templates for descriptors and keywords, which will also ensure that the psionic power is added to the correct category. These are:

Standardized Sections
These are typical section headers for an article about a psionic power, or ritual, as discussed in this forum thread. You can easily cut and paste it from here and delete the ones you don't use: