Stoneshard wiki:Community portal

From Stoneshard wiki
Jump to navigation Jump to search

Community Administrator

Realpsojed talk  •  contribs

Developer Administrator

VVayfinder talk  •  contribs
Stoneshard wiki is a community project run entirely by volunteers to provide information for the game.

Our community of editors is open to anyone. If you would like to join in:

  • Registering a free account is required for editing our wiki. It also makes it easier to keep track of your own edits.
  • Check out the MediaWiki Help section if you're new to Wiki editing.
  • See a list of recent changes.
  • Jump right in and start editing. You can start small by fixing spelling, grammar, and other errors you come across.
  • Edit and expand pages marked as Stubs. These are pages we have already created that need more information.
  • Check out the Wanted Pages. These are pages that don't exist yet, but some other page links to them. You can see how many pages link to a given page name. Pages with many links are the ones that should be created first. Pages with only a single link could be wanted pages too, but they could also be a typo and only need to repair the link.


Alternatively, just type a new article name in the search box. A link will be provided to start the article at the top of the search results.


Helpful things you can do

Images and Files

For example, an image of Bread Bread.png, should be named "Bread.png". When uploading image of an item's description, name it "<itemname> description.png", etc.
We use strict File naming scheme, because our Templates rely on using names identical to pagenames. More on that in the #Advanced stuff section.


Categories

  • Categorize new images and new pages. Simply add [[Category:<category name>]] at the very end of the page.

For example, when I upload a new weapon image, it belongs to [[Category:Weapon images]]. A page about a new NPC would belong to [[Category:NPCs]], etc. Check the [Category tree] for a complete list of categories.


Advanced stuff

Colors and Templates

We adhere to the ingame color palette and use the {{Color}} template (shortcut: {{C}}) to colorize texts on the wiki. Below is a table of all current colors from the game and example usage with the Color template. Note that omitting the second argument will result in showing the first argument as the text.


Skills
  • #f6bb15 should be the orange-yellow-ish Passive Bonus.
  • #78d199 should be the light-green bonus like -5% Cooldown Reduction on skills.
  • #0ed78e is the more profound light-green in "Active" skill type.
  • #a3b719 lime color in "Passive" skill type.
  • #ffffff for the amount of turns that a stance/effect lasts.
  • #9d9a9a gray for skill description.
  • #71725e for weapon type requirements
  • #9e1b31 should be red for negative bonuses from skills and conditions
  • #21b7ec energy burn or Energy/Max Energy replenish skills
  • {{C|Orange|Passive Bonus}} appears as Passive Bonus
  • {{C|+|+10%}} appears as +10%
  • {{C|Active|Active}} appears as Active
  • {{C|Passive|Passive}} appears as Passive
  • {{C|White|Text}} appears as Text
  • {{C|Gray|Text}} appears as Text
  • {{C|Req|- requires Swords}} appears as - requires Swords
  • {{C|-|-5%}} appears as -5%
  • {{C|Energy|+20}} appears as +20
Items
  • #c75c5d is the brighter red for negative bonuses on items
  • #824858 is cursed red for cursed items
  • #27b1ea is blue for random enchantment bonuses
  • #59db4c light green for Uncommon item names only
  • #4c7fff is blue for Rare item names only
  • #8248bc is purple for unique item names only
  • #ffb72b is epic items (not yet in-game)
  • #95796a brown for item descriptions
  • #0ed78e for Potions with positive effects
  • #9e1b31 for Potions with negative effects
  • {{C|Red|Buckler}} appears as -5% Skills Energy Cost
  • {{C|Cursed|Buckler}} appears as Buckler
  • {{C|Ench|+2% Block Chance}} appears as +2% Block Chance
  • {{C|Uncommon|Buckler}} appears as Buckler
  • {{C|Rare|Buckler}} appears as Buckler
  • {{C|Unique|Buckler}} appears as Buckler
  • {{C|Epic|Buckler}} appears as Buckler
  • {{C|Brown|An epic sword.}} appears as An epic sword.
  • {{C|Flawless|Potion of Antivenom}} appears as Potion of Antivenom
  • {{C|-|Potion of Poison}} appears as Potion of Poison
Damage types
  • #f28d31 Fire damage / burning effect
  • #9872ec Arcane damage
  • #fff6b5 Sacred damage
  • #fff6b5 Shock damage
  • #ec4d49 Unholy damage
  • #58af13 Poison damage
  • #0ed78e Caustic damage
  • #504aea Psionic damage
  • #73c0de Frost damage
  • {{C|Fire|10}} appears as 10
  • {{C|Arcane|10}} appears as 10
  • {{C|Sacred|10}} appears as 10
  • {{C|Shock|10}} appears as 10
  • {{C|Unholy|10}} appears as 10
  • {{C|Poison|10}} appears as 10
  • {{C|Caustic|10}} appears as 10
  • {{C|Psionic|10}} appears as 10
  • {{C|Frost|10}} appears as 10
Conditions
  • #0ed78e conditions labelled State
  • #9e1b31 conditions labelled Physical
  • #27b1ea conditions labelled Condition
  • #27b1ea conditions labelled Mental
  • #4c7fff conditions labelled Magical
  • {{C|State}} appears as State
  • {{C|Physical}} appears as Physical
  • {{C|Condition}} appears as Condition
  • {{C|Mental}} appears as Mental
  • {{C|Magical}} appears as Magical
Misc
  • #f28d31 unique trait
  • {{C|Unique Trait}} appears as Unique Trait


Data Structures

To display the different properties of Items, Conditions and other things, we use data structures placed on the respective subject's pages.

  • The data is written inside of <includeonly></includeonly> statements to make it hidden from the page itself.
  • The data is written as parameters of a single #Switch ParserFunction (see Help:Extension:ParserFunctions for more info) to allow different Templates to call for different pieces of data.


Please refer to the documentation of these templates for usage and examples:


Additionally, Containers also use the data structure, but there isn't a special template that uses them. Instead, we call them up on specific item pages to fill up the "Acquired From" section.

Container
<includeonly>{{#switch: {{{1}}}
|Loot = Plague Doctor Mask, Brynn Vermouth, Mannshire Fortified, Brandy, Lockpicks, Repair Kit, Crowbar, Surgeon's Kit, Horsetail, etc...
|Treatise = Sword Treatise I, Sword Treatise II, Sword Treatise III, Axe Treatise I, Axe Treatise II, Axe Treatise III, Mace Treatise I, etc...
|#default = 
}}</includeonly>

Finally, templates for Skills and Treatises currently don't use these data structures, so the Skill/Treatise pages store their data in the /Tooltip pages instead. The goal is to change them in the future to also use the data structures, like the rest.

Tooltips

When creating a specific item or skill page, most wikis display an infobox on the right side to show the most relevant information about an item or skill. Our wiki simply shows the tooltips of said item or skill.

  1. Follow the instructions on Template:Tooltip_hover_box to create a Tooltip page.
  2. Add this code into the item/skill page. This will automatically display whatever is written in the page's tooltip page and place it to the right side of the screen.
<div style="float: right">{{:{{ROOTPAGENAME}}/Tooltip}}</div>


ImageMaps

Using the ImageMap extension, you can create images that link to multiple different pages, as opposed to the default single link for the whole image. Usage:

  • Image comes in the same format as default wiki images, but without the enclosing [[ ]] brackets.
  • The link positions are selected by entering parameters. These parameters translate into X and Y values of certain points of the image:
    • X position is calculated as distance in pixels from the left edge of the image.
    • Y position is calculated as distance in pixels from the top edge of the image.
    • Important: The positions are calculated from the full size image, not from the size of the image displayed on a wiki page.
  • Finally, the amount of parameters required changes depending on the shape used:
    • default - gives the default link, ie. a single link for the whole image.
    • circle - gives a circular area, requires 3 parameters: first and second are X and Y coordinates of the center, and third is the radius.
    • rect - gives a rectangular area, requires 4 parameters: first and second are X and Y coordinates of top-left corner, third and fourth are X and Y coordinates of the bottom-right corner.
    • poly - gives a polygon, any amount of parameters can be provided.
    • desc - adds a blue "i" icon to the image. Possible values: top-right, bottom-right (default), bottom-left, top-left, none. Doesn't work if image uses frame and thumb parameters.
  • Example param usage:
default [[Blade Maintenance]]
circle 50 50 10 [[Blade Maintenance]]
rect 50 50 150 150 [[Blade Maintenance]]
poly 10 10 20 10 20 20 30 20 30 30 10 30 [[Blade Maintenance]]
desc none

Using the Swords_skilltree.png image, we will make the first two top icons into links. This code:

<imagemap>
File:Swords_skilltree.png|338px|Swords skill tree
rect 382 176 558 352 [[Cleaving Strike]]
rect 108 176 284 352 [[Blade Maintenance]]
desc top-right
</imagemap>

Produces this result: <imagemap> File:Swords_skilltree.png|338px|Swords skill tree rect 382 176 558 352 Cleaving Strike rect 108 176 284 352 Blade Maintenance desc top-right </imagemap>

Wiki Translation

Stoneshard Wiki is primarily available in English. However, we do support translating the wiki to other languages. If you are willing to translate the wiki to another language, you should let the admins know. Translating a whole wiki is no easy task, so be prepared that it will take you some time.


Translating pages with text

You should start with the links you can see on the main page. Create a new page of the same name, but with a subpage for your language. For example, if you wanted to translate the page Factions to Czech language, you would create Factions/cz and translate all the text on that page.

If the page uses any Templates or other wikitext, don't translate those. Admins will tell you more about that after they prepare the templates for your language.


Need help? Want something changed or want to debate about something? Feel free to join us at the Stoneshard Discord!