Gswiki:Style guide/Item scripts: Difference between revisions

The official GemStone IV encyclopedia.
< Gswiki:Style guide
Jump to navigation Jump to search
(Created page with "{{TOCright}} In order to streamline the process for creating and editing item/script pages on the Wiki, a series of templates have been created. These templates, along with t...")
 
Line 33: Line 33:


==Additional Information==
==Additional Information==
When creating a page for a new item, please remember to utilize {{boldmono|<nowiki><pre{{log2}}></nowiki>}} to record the item's {{boldmono|ANALYZE}}. When recording a log of ambients or additional actions not covered in a verb table, {{boldmono|<nowiki><pre{{log3}}></nowiki>}} should be used.
When creating a page for a new item, please remember to utilize {{boldmono|<nowiki><pre{{log2}}></nowiki>}} to record the item's {{boldmono|ANALYZE}}. This should also be used to record any ambients or additional logs of the item in use.

An example of proper page order setup is:
An example of proper page order setup is:
<pre{{log2}}>
<pre{{log2}}>

Revision as of 17:45, 17 September 2020

In order to streamline the process for creating and editing item/script pages on the Wiki, a series of templates have been created. These templates, along with this guide and the provided examples, serve to ensure formatting and categorization remain uniform across the various pages.

Categories

As part of this update, categories for items and their scripts have seen a revamp as well.

  • Mechanical item scripts: Formally known as "functional" item scripts. These scripts provide a mechanical benefit to the user. Examples include: (short list of examples).
  • Fluff item scripts: These types of scripts do not provide a mechanical benefit to the user, even though they may be added to things that do, such as weapons or armor. Examples include: Anfelt scripts, Veola hair accessories, Peretta items.
  • Feature altering scripts: These scripts are either mechanical or fluff, but have the ability to alter a character's features. Examples include: Peretta masks, hairpicks, Veola hair acessories.
  • Armor scripts: These scripts apply solely to armor.
  • Weapon scripts: These scripts apply solely to weapons.
  • Clothing scripts: These scripts apply to clothing items, including cloaks.
  • Container scripts: These scripts apply to containers, such as belt-worn, back-worn, or shoulder-worn items. For the purpose of this classification, it does not include cloak-worn items.
  • Miscellaneous scripts: These scripts apply to items that do not fall within the aforementioned categories. Examples include: gem cutters, lapidary boxes.
  • Legendary items: Items that have been released through special pay events or auctions only. These items are extremely limited and there may be only one of each in existence.

Right Side Infoboxes

These templates allow for a quick at a glance look at the script.

  • Template:Iteminfo - This template features all the need to know information and will either grow or shrink based on information entered.
  • Template:Itemverb - This template contains a list of verbs used on the item, with clickable links to the verb page itself. This is an optional table, and can be omitted if the article is short enough to not necessitate it.

Page Subheaders

For typical item pages, the breakdown was Analyze, Usage, Additional Information (including links to other pages/resources). Going forward, pages will be broken down into Analyze, Tiers (with each tier being its own subheader), Additional Information. This will allow uniformity between fluff item script pages and mechanical item script pages. An optional template was created that can be used for both types, however its purpose is meant primarily for mechanical script pages.

  • Template:Itemtier - Optional template with spots for Tier (or tree), Analyze (if the tier unlock differs greatly from the base analyze. This does not include if there are only additional verbs for the unlock tier. An example would be Compartmentalized quivers, which note a drastic difference in the analyze between unlock tiers), Mechanics (a quick breakdown of mechanical information for the unlock, if any), Affinity (if affinity is specific to the item/tier), and Itemverbtable (this will create an additional subheader for Usage, which should be followed by the item's verb usage set up in Template:Verbtable. Each tier would require the use of this template.
  • Copy/paste Code for Template:Itemtier:
{{itemtier <!-- Copy/Paste x #Tier for item as needed. -->
|tier= <!-- REQUIRED:  Must be entered as Tier # or Tree (Name) -->
|analyze= <!-- Only necessary if there are drastic changes in ANALYZE between tiers/trees. -->
|mechanics= <!-- Brief explanation of mechanics for this tier, if any. -->
|affinity= <!-- Brief explanation of affinity for that specific tier, if any.  -->
|itemverbtable= <!-- Answer YES if there are verbs associated with this tier.  If not, leave blank. -->
}} {| {{verbtable}} <!-- REQUIRED if there are verbs for this tier.  For formatting purposes, the table needs to start on the same line that the itemtier template ends.  For instructions on how to use this template, see Template:Verbtable. -->
|}

Additional Information

When creating a page for a new item, please remember to utilize <pre{{log2}}> to record the item's ANALYZE. This should also be used to record any ambients or additional logs of the item in use. An example of proper page order setup is:

* Small paragraph blurb about item and release information. (noted by {{addme}} in the below copy and paste code).
* Tier breakdown and information (for mechanical items, Template:Itemtier should be used).
** Template:Verbtable should be used and broken up between each tier subheader.
* Additional information (this should include any additional pertinent information not covered in the above areas).
** Ambient messaging
** Log of use (if any)
** Resources (links to addtional information, festival/shop release information, saved posts subpage).

Note: For the time being, the template is set up to not allow TOC. This is intentional and will be updated in the future.

Copy/Paste Code

Below is the full copy/paste code for the templates used to creature an item/script page. Optional templates are Template:Itemtier and Template:Itemverb. The below code will set the page up to allow the right side infoboxes to float properly alongside the verb tables for item usage. Text within <!-- and --> will not appear on the page; these notes are hidden instructions and should be left in the pages to inform future editors.

__NoTOC__
<table><tr valign="top"><td>
{{addme}} <!-- This spot reserved for informational blurb for item. Remove as part of copy/paste.-->
{{itemtier <!-- Copy/Paste x #Tier for item as needed. -->
|tier= <!-- REQUIRED:  Must be entered as Tier # or  -->
|analyze= <!-- Only necessary if there are drastic changes in ANALYZE between tiers/trees. -->
|mechanics= <!-- Brief explanation of mechanics for this tier, if any. -->
|affinity= <!-- Brief explanation of affinity for that specific tier, if any.  -->
|itemverbtable= <!-- Answer YES if there are verbs associated with this tier.  If not, leave blank. -->
}} {| {{verbtable}} <!-- REQUIRED if there are verbs for this tier.  For formatting purposes, the table needs to start on the same line that the itemtier template ends.  For instructions on how to use this template, see Template:Verbtable. -->
|}
</td><td>
{{iteminfo
|type= <!-- REQUIRED: Mechanical or Fluff. -->
|type2= <!-- OPTIONAL: If an item is feature altering, please enter "Feature altering". -->
|itemclass= <!-- REQUIRED: Valid options are: Armor, Weapon, Clothing, Container, Miscellaneous. -->
|itemtype= <!-- REQUIRED: What items can this apply to.  Up to 8 can be specified. -->
|itemtype2=
|itemtype3=
|itemtype4=
|itemtype5=
|itemtype6=
|itemtype7=
|itemtype8=
|alter= <!-- REQUIRED: Can this be altered? Valid response is Yes or No. If there are restrictions, enter in Restrictions line. -->
|ld= <!-- REQUIRED: Is this item able to be lightened or deepened?  Valid response is Yes or No. If there are restrictions, enter in Restrictions line. -->
|feature= <!-- OPTIONAL: This area is only REQUIRED if feature altering is indicated. Up to 8 features can be entered -->
|feature2=
|feature3=
|feature4=
|feature5=
|feature6=
|feature7=
|feature8=
|customize= <!-- OPTIONAL: Enter "Yes" if the item is customizable beyond an ALTER.  If no, leave blank. -->
|custom= <!-- OPTIONAL:  This area is REQUIRED if customization is indicated.  Up to 5 customizations can be entered. If the messaging is alterable, simply enter "Verb"-->
|custom2=
|custom3=
|custom4=
|custom5=
|origmerch= <!-- OPTIONAL: This area is for indicating the original release merchant name, if known. If not, leave blank.-->
|releasevenue= <!-- OPTIONAL: This area is for indicating the original release venue and year, if known. If not, leave blank. -->
|tiered= <!-- OPTIONAL: Enter "Yes" if the item is tiered. If no, leave blank. -->
|tiersnumber= <!-- OPTIONAL: This area is only REQUIRED if an item has tiers. It is to note how many tiers there are (This includes off the shelf). -->
|unlock= <!-- OPTIONAL: This area is only required if an item has tiers. It is to note how tiers can be unlocked.  Valid options are "Merchant" or "Certificate" ONLY. If both, enter at unlock2.-->
|unlock2=
|legendary= <!-- OPTIONAL: Enter "Yes" if the item/script was released/distributed at an auction or was a jackpot prize.  Extremely limited release only (3 or less in existence).  -->
|demeanor= <!-- OPTIONAL: Enter "Yes" if the item's messaging is affected by DEMEANOR.  If no, leave blank. -->
|loresong= <!-- OPTIONAL:  Enter "Yes" if the item has a loresong as part of the base script.  If no, leave blank. -->
|attune= <!-- OPTIONAL: This area is for indicating if an item attunes.  If permanent, enter Permanent; if temporary, enter Temporary (as in, it can be broken).  If there is none, leave blank. -->
|attunement= <!-- OPTIONAL: This area is only REQUIRED if attunement was indicated. Options are "Character" or "Account". Please note, "Temporary attunement" will ALWAYS be "Character". -->
|affinity= <!-- OPTIONAL: Enter "Yes" if the item requires affinity to work.  If no, leave blank. -->
|hideable= <!-- OPTIONAL: Enter "Yes" if an item is hideable in inventory.  If no, leave blank. -->
|hide= <!-- OPTIONAL: This area is only REQUIRED if the item is indicated to be hideable.  This should indicate HOW it hides, whether by a verb or simply by being WORN. -->
|spell= <!-- OPTIONAL: This area is for indicating if an item has a spell inherent to the script ONLY.  Up to 4 may be specified. Example to enter: Call Familiar (920). If no, leave blank. -->
|spell2=
|spell3=
|spell4=
|enhancive= <!-- OPTIONAL: This area is for indicating if an item has enhancives inherent to the script ONLY.  Answer YES. If no, leave blank. -->
|swap= <!-- OPTIONAL: This area is for indicating if an item is eligible for script swapping.  Answer YES. If no, leave blank. -->
|add= <!-- OPTIONAL: This area is for indicating if the script is eligible to be added to an item.  Answer YES. If no, leave blank. -->
|restrictions= <!-- OPTIONAL: This area is for indicating if an item has specific restrictions. If more than one, separate with <br>. DO NOT ENTER ON A SEPARATE LINE. -->
}}
{{itemverb
|verb= <!-- Verbs MUST be capitalized when entered. -->
|verb2= 
|verb3= 
|verb4= 
|verb5=
|verb6=
|verb7=
|verb8=
|verb9=
|verb10=
|verb11=
|verb12=
|verb13=
|verb14=
|verb15=
|verb16=
|verb17=
|verb18=
|verb19=
|verb20=
|verb21=
|verb22=
|verb23=
|verb24=
|verb25=
|verb26=
}}
</td></tr></table>