Template:Assignmentinfo/doc

Creates an infobox for duty officer assignment pages. See below for suggested assignment page layout.

Usage

{{Assignmentinfo
| name = Name of assignment (optional, if blank or omitted, it uses the page name)
| faction = Starfleet/Klingon/Romulan/Cross-Faction (value must be capitalized as shown; Both and FedRomKDF are deprecated, and should be replaced with Cross-Faction)
| long = (Deprecated, not used by the template)
| chain = Name of assignment chain (only for chain assignments)
| chainpos = Position of assignment within chain (for the non-repeatable assignments)
| chainprev = Previous assignment in chain (optional)
| chainnext = Next assignment in chain (optional)
| chainrepeat = Repeatable assignment(s) unlocked by this assignment (optional)
| loctype = name of in game NPC giving this assignment, or GUI tab (for PC), or filtering option (for Console) where this assignment may spawn (but not the map where this assignment may spawn - for maps please use ==Possible locations== as described below), out of: Current Map/Personal/Tactical Officer/Federation Envoy/Orion Marauder/Engineer/Operations Officer/Science Officer/Doctor/Bartender/Chef/Counselor/Brig Officer/Security Officer/Trader/Personnel Officer/Andorian Personnel Officer/Tellarite Personnel Officer/Vulcan Personnel Officer/Gorn Personnel Officer/Imperial Personnel Officer/Nausicaan Personnel Officer/Orion Personnel Officer/Duty Officer Recruitment (Romulan console)
| duration = duration from assignment beginning till completion, for parsing purposes please use formatting as in game, e.g. 45 minutes, 48 hours (not 45m, 2d)
| cooldown = cooldown on assignment, if known (optional)
| commendation = commendation category (Diplomatic, Marauding, Science, Engineering, Military, Exploration, Espionage, Medical, Colonial, Trade, Development, Recruitment) or (None) if the assignment doesn't belong to any commendation category (unless this is None, please also specify "| cxp =" field below)
| secondary = second commendation category (optional, please also specify "| 2xp =" field below)
| tertiary = third commendation category (optional, and quite rarely used, please also specify "| 3xp =" field below)
| rarity = common/uncommon/rare/very rare
| level = # Player level at which the assignment becomes available, if known (optional). eg: 11
| tier = The Commendation Tier at which the assignment becomes available, 0-4, for vast majority of assignments this will be 0. A small number of assignments will be available at higher Commendation Tiers, e.g. [[Assignment: Special Deal on Entertainment Provisions (very_rare)]] or  
| repeatable = Yes/No
| doffs = doffs requirements, separated by commas, the template will format them into bullet points. For each requirement, please use one of the following templates:
* {{Requiresanydoff|quantity}} - when doff(s) from any department are required
* {{Requiresdoffdept|quantity|deptlist}} - when doff(s) from specific department(s) are required
* {{Requiresdoffspec|quantity|speclist}} - when doff(s) with specific specialization(s) are required
* {{Requiresdofftrait|quantity|traitlist}} - when doff(s) with specific traits are *required*
* (NB. Do not use here {{Depticonpluslink}}, {{Speciconpluslink}} {{Traiticonpluslink}} - these are for the page body to specify *optional* factors impacting outcome chances, see below.)
| showcost = other costs that should appear in the infobox (listed in the form count1~item1;count2~item2;etc)
| morecost = other costs that should *not* be displayed in the infobox, but should be available for use by templates like {{Assignmentsbyitem}} (listed in the form item1;item2;etc)
| cost = other costs (for edge cases where it's necessary to have full control of the formatting, don't use showcost with this, but do list all items here in morecost since the template isn't able to identify the items in this parameter)
* NUMBER {{EC}}/{{GPL}} etc for currency requirements
* {{Requiresitem|quantity|itemname}} for item requirements
| outcomes =
* '''Critical''': #%
* '''Success''': #%
* '''Failure''': #%
* '''Disaster''': #%
PC users can obtain these numbers by unticking "Enable First Officer Recommendations" in game.
| risk = None/Low/Medium/High/Extreme
| rewardtype = # (optional) Bridge Officer, Duty Officer, Other Item, Title (assigns page to corresponding category)
| reward = Creates a panel with the text "You will recieve the following reward:" (optional and deprecated, please use showreward and morereward instead)
| showreward = Creates a panel with the text "You will recieve the following reward:" and shows these rewards (listed in the form count1~item1;count2~item2;etc)
| morereward = Rewards that should *not* be displayed in the infobox, but should be available for use by templates like {{Assignmentsbyitem}} (listed in the form item1;item2;etc)
| reward = similar to showreward, but allows free format (for edge cases where it's necessary to have full control of the formatting, don't use showreward with this, but do list all items here in morereward since the template isn't able to identify the items in this parameter)
| plus = Creates a panel with the text "Plus one of the following:" (optional)
| plusall = Modifies the header of the above panel to "Plus all of the following:" (optional)
| crit = Creates a panel with the text "On critical success:" (optional)

All below fields are optional, if all are omitted, the "Rewards" section is omitted entirely. For the below fields please use the exact reward numbers without rounding them, taken from assignment starting page in game (i.e. one with "Begin Assignment" button at the bottom), listing them as: SUCCESS_REWARD / CRITICAL_REWARD (assuming only the top 2 outcomes give rewards). For assignments rewarding rewards for the top 3 outcomes (e.g. "Evaluate <RACE> Bridge Officer Candidate" or Experimental <ITEM> Upgrades) listing them as: GREEN_QUALITY_REWARD / BLUE_QUALITY_REWARD / PURPLE_QUALITY_REWARD. Rewards for outcomes other than success can be found without completing the assignment by hovering mouse pointer over [i] to the left of e.g. "Critical" on assignment starting page in game.
| sp = #  rewarded (a.k.a Skillpoints, Experience Points or Specialization Points)
| bosp = #  rewarded (a.k.a Bridge Officer Skillpoints, Expertise)
| cxp = # Commendation XP rewarded - only if something other than None is specified in "| commendation =" field above
| 2xp = # Secondary Commendation XP rewarded - only if field "| secondary =" is used (quite rarely used)
| 3xp = # Tertiary Commendation XP rewarded - only if field "| tertiary =" is used (quite rarely used)
| ore = #  Dilithium Ore rewarded. For the vast majority of assignments this will be: 5 / 125
| fleetmarks = # Fleet Marks rewarded (quite rarely used)
| r&dg = Crafting-related rewards, e.g. R&D bonus pool (quite rarely used)
| ec = #  Energy Credits rewarded. The values recorded here should be for level 50+ captains, which for the vast majority of assignments this will be 490 / 980, which in turn specifically should be used if assignment starting page is showing EC rewards for success / critical as: 20 / 40, and otherwise - please specify here exact numbers shown on assignment starting page.
| gpl = # Gold-Pressed Latinum rewarded (quite rarely used)
| fleetmarks = # Fleet Marks rewarded (quite rarely used)
}}

Suggested Ordering of Sections in Assignment Pages

 __NOTOC__
{{Assignmentinfo}}
List of {{About}} - optional, only if there are any related assignments (e.g. Formal Gift Exchange and Black Market Provisioning)
Editor's summary/important notes - optional
==Summary==: In-game text for each variant of the assignment covered by this page.
==Outcome==: Optional, in-game text for each outcome if this assignment provides these, e.g.:
* {{Outcome|cs}}: The bargaining proved extremely profitable.
* {{Outcome|s}}: The bargaining proved adequately profitable.
* {{Outcome|f}}: The bargaining proved unprofitable.
* {{Outcome|cf}}: Your duty officer was ambushed.
==Variations==: Description of variations of this assignment (factions, rarities etc)

==Requires== (variant A: when {{Depticonpluslink}}, {{Speciconpluslink}}, and {{Traiticonpluslink}} impacting outcome chances are the same for all doff requirements, this will be the case for most assignments, e.g. “Entertain Foreign Dignitaries”)
{{#var:formattedcost}} (this will automatically display formatted costs specified in the template, if any, safe to use when no costs specified)
{{#var:formatteddoffs}} (this will automatically display formatted doff requirements specified in the template)
** '''Critical/Success/Failure/Disaster''': {{Traiticonpluslink|trait|good/bad|cs/s/f/cf}} - to specify usually *optional* traits impacting outcome chances (these may coincide with required ones)
** '''Critical/Success/Failure/Disaster''': {{Speciconpluslink|speclist}} - to specify specialization(s) impacting outcome chances (often these coincide with required ones)
** '''Critical/Success/Failure/Disaster''': {{Depticonpluslink|deptlist}} - to specify department(s) impacting outcome chances (often these coincide with required ones)

==Requires== (variant B: when {{Depticonpluslink}}, {{Speciconpluslink}}, and {{Traiticonpluslink}} impacting outcome chances are the different for different doff requirements, this will be a rather rare case, e.g. “Investigate Temporal Anomaly”)
{{#var:formattedcost}} (this will automatically display formatted costs specified in the template, if any, safe to use when no costs specified)
* {{Requiresdofftrait|quantity|traitlist}} - when doff(s) with specific traits are *required*
** '''Critical/Success/Failure/Disaster''': {{Traiticonpluslink}} (as in variant A above)
** '''Critical/Success/Failure/Disaster''': {{Speciconpluslink}} (as in variant A above)
** '''Critical/Success/Failure/Disaster''': {{Depticonpluslink}} (as in variant A above)
* {{Requiresdoffspec|quantity|speclist}} - when doff(s) with specific specialization(s) are required
** '''Critical/Success/Failure/Disaster''': {{Depticonpluslink}} etc.
* {{Requiresdoffdept|quantity|deptlist}} - when doff(s) from specific department(s) are required
** '''Critical/Success/Failure/Disaster''': {{Depticonpluslink}} etc.
* {{Requiresanydoff|quantity}} - when doff(s) from any department are required
** '''Critical/Success/Failure/Disaster''': {{Depticonpluslink}} etc.

==Rewards==: Additional details about rewards that did not fit into {{Assignmentinfo}} template, such as table of rewards for different variations of this assignment
{{Clear}} ==Possible locations==: Text and/or {{Assignmentlocations}} (the template should be omitted when assignment is available on any space and/or ground map, and used otherwise) showing in which locations in game this assignment appears in assignments window, or where to find the NPC that gives out this assignment
==Notes==: Bullet-point list with any additional lower-priority clarifying information, or information that does not fit anywhere else. E.g.:
* "This assignment does not reward any {{EC}}."

Related templates

• {{Assignmentinfo}} - main template used in Assignment pages
• {{Requiresitem|quantity|itemname}} - for item requirements
• {{Requiresanydoff|quantity}} - when doff(s) from any department are required
• {{Requiresdoffdept|quantity|deptlist}} - to specify specific department(s) required for this assignment
• {{Depticonpluslink|deptlist}} - to specify department(s) impacting outcome chances (often these coincide with required ones)
• {{Requiresdoffspec|quantity|speclist}} - to specify specific specialization(s) required for this assignment
• {{Speciconpluslink|speclist}} - to specify specialization(s) impacting outcome chances (often these coincide with required ones)
• {{Requiresdofftrait|quantity|traitlist}} - to specify specific trait(s) *required* for this assignment
• {{Traiticonpluslink|trait|good/bad|cs/s/f/cf}} - to specify usually *optional* traits impacting outcome chances (these may coincide with required ones)
• {{Outcome|cs/s/f/cf}} - formatting outcomes in ==Outcomes==