Difference between revisions of "User:Trang Oul/Sandbox/Template:Skill data"

From Basin Wiki
Jump to navigation Jump to search
m (refs to skilldesc)
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
=== Sources ===
 
=== Sources ===
 
Built automatically from:
 
Built automatically from:
−
* <code>skills.txt</code> (cols: <code>skill</code> - tech name, <code>Id</code>/<code>*Id</code> - ID)
+
* <code>skills.txt</code> (cols: <code>skill</code> - unique internal name, <code>Id</code>/<code>*Id</code> - ID, <code>skilldesc</code> - foreign key referencing <code>skilldesc.txt</code>, <code>charclass</code> - class abbreviation, <code>reqlevel</code> - required level)
−
* <code>skilldesc.txt</code> (cols: <code>skilldesc</code> - tech name (matched with <code>skill</code> from <code>skills.txt</code> after casefolding), <code>str name</code> - key for string label)
+
* <code>skilldesc.txt</code> (cols: <code>skilldesc</code> - primary key (referenced by <code>skilldesc</code> col from <code>skills.txt</code>), <code>str name</code> - key for the localized skill name string)
−
* <code>data\local\lng\strings</code> (string label values, <code>Key</code> used as key (matched with <code>str name</code> from <code>skilldesc.txt</code>))
+
* <code>data\local\lng\strings</code> (localized string values; <code>Key</code> is matched with <code>str name</code> from <code>skilldesc.txt</code>; <code>enUS</code> locale was used)
−
Only skills with labels are included.<br/>
+
Only skills with matching skilldesc entry are included.<br/>
 +
Class codes and required levels are also taken from <code>skills.txt</code>.
 
To be done manually (?):
 
To be done manually (?):
 
* Add links to non-class skills - which?
 
* Add links to non-class skills - which?
−
* Use technical names if the label re-uses existing skill name (like [[Tainted Resist Fire]]).
+
* Use internal names if the localized skill name string re-uses an existing skill name (like [[Tainted Resist Fire]]).
  
 
=== Usage ===
 
=== Usage ===
−
<code><nowiki>{{Skill name|<skill ID or tech name>}}</nowiki></code>
+
<code><nowiki>{{Skill data|<skill ID or internal name>|<field>}}</nowiki></code>
  
 
==== Parameters ====
 
==== Parameters ====
 
; <code>1</code> (required)
 
; <code>1</code> (required)
−
: Skill ID or technical name from <code>skills.txt</code> (also used as a skill property value).
+
: Skill ID or internal name from <code>skills.txt</code> (also used as a skill property value).
 +
; <code>2</code> (optional, defaults to <code>label</code>)
 +
: Field to return:
 +
:* <code>id</code> - numeric skill ID.
 +
:* <code>name</code> - internal name from <code>skills.txt</code> (not the localized skill name string)
 +
:* <code>label</code> - localized skill name string value (currently <code>enUS</code>) from the game's string file. Class skills are returned as links.
 +
:* <code>class</code> - class code; empty for non-class skills.
 +
:* <code>reqlvl</code> - required character level; empty for non-class skills.
 +
: Unknown skills return parameter <code>1</code> unchanged, except for <code>class</code> and <code>reqlvl</code>, which return an empty value. Unknown fields also return parameter <code>1</code> unchanged.
 +
 
 
==== Examples ====
 
==== Examples ====
−
; Skill name by ID
+
; Localized skill name string by ID
−
: <code><nowiki>{{Skill name|6}}</nowiki></code>
+
: <code><nowiki>{{Skill data|6|label}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|6}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|6|label}}
 +
 
 +
: <code><nowiki>{{Skill data|371|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|371|label}}
 +
 
 +
; Localized skill name string by internal name (notice that the string text can differ from the internal name)
 +
: <code><nowiki>{{Skill data|Magic Arrow|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Magic Arrow|label}}
 +
 
 +
: <code><nowiki>{{Skill data|Sigil Death|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Sigil Death|label}}
 +
 
 +
: <code><nowiki>{{Skill data|Delerium Change|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Delerium Change|label}}
 +
 
 +
: <code><nowiki>{{Skill data|Townportal O Skill|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Townportal O Skill|label}}
  
 +
: <code><nowiki>{{Skill data|Tainted Fire Bolt|label}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Tainted Fire Bolt|label}}
  
−
: <code><nowiki>{{Skill name|371}}</nowiki></code>
+
; Skill ID by internal name
−
: {{User:Trang Oul/Sandbox/Template:Skill name|371}}
+
: <code><nowiki>{{Skill data|Magic Arrow|id}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Magic Arrow|id}}
  
−
; Skill name by technical name (notice that some differ from the in-game labels)
+
: <code><nowiki>{{Skill data|Frozen Orb|id}}</nowiki></code>
−
: <code><nowiki>{{Skill name|Magic Arrow}}</nowiki></code>
+
: {{User:Trang Oul/Sandbox/Template:Skill data|Frozen Orb|id}}
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Magic Arrow}}
 
  
 +
; Internal name by ID (not the localized skill name string)
 +
: <code><nowiki>{{Skill data|222|name}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|222|name}}
  
−
: <code><nowiki>{{Skill name|Sigil Death}}</nowiki></code>
+
: <code><nowiki>{{Skill data|400|name}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Sigil Death}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|400|name}}
  
 +
; Class code by ID or internal name
 +
: <code><nowiki>{{Skill data|6|class}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|6|class}}
  
−
: <code><nowiki>{{Skill name|Delerium Change}}</nowiki></code>
+
: <code><nowiki>{{Skill data|86|class}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Delerium Change}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|86|class}}
  
 +
: <code><nowiki>{{Skill data|Magic Arrow|class}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Magic Arrow|class}}
  
−
: <code><nowiki>{{Skill name|Townportal O Skill}}</nowiki></code>
+
: <code><nowiki>{{Skill data|Hex Bane|class}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Townportal O Skill}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|Hex Bane|class}}
  
 +
; Required character level
 +
: <code><nowiki>{{Skill data|Magic Arrow|reqlvl}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Magic Arrow|reqlvl}}
  
−
: <code><nowiki>{{Skill name|Tainted Fire Bolt}}</nowiki></code>
+
: <code><nowiki>{{Skill data|Immolation Arrow|reqlvl}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Tainted Fire Bolt}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|Immolation Arrow|reqlvl}}
  
 +
; Non-class skill (empty class and required level)
 +
: <code><nowiki>{{Skill data|Tainted Fire Bolt|class}}</nowiki></code>
 +
: <code>{{User:Trang Oul/Sandbox/Template:Skill data|Tainted Fire Bolt|class}}</code>&nbsp;(empty)
 +
 +
: <code><nowiki>{{Skill data|Tainted Fire Bolt|reqlvl}}</nowiki></code>
 +
: <code>{{User:Trang Oul/Sandbox/Template:Skill data|Tainted Fire Bolt|reqlvl}}</code>&nbsp;(empty)
 +
 +
; Omitted field (defaults to <code>label</code>, the localized skill name string)
 +
: <code><nowiki>{{Skill data|6}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|6}}
  
 
; Skill not defined
 
; Skill not defined
−
: <code><nowiki>{{Skill name|9999}}</nowiki></code>
+
: <code><nowiki>{{Skill data|9999|label}}</nowiki></code>
−
: {{User:Trang Oul/Sandbox/Template:Skill name|9999}}
+
: {{User:Trang Oul/Sandbox/Template:Skill data|9999|label}}
 +
 
 +
: <code><nowiki>{{Skill data|Other Skill|name}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Other Skill|name}}
 +
 
 +
: <code><nowiki>{{Skill data|Other Skill|class}}</nowiki></code>
 +
: <code>{{User:Trang Oul/Sandbox/Template:Skill data|Other Skill|class}}</code>&nbsp;(empty)
  
 +
: <code><nowiki>{{Skill data|9999|reqlvl}}</nowiki></code>
 +
: <code>{{User:Trang Oul/Sandbox/Template:Skill data|9999|reqlvl}}</code>&nbsp;(empty)
  
−
: <code><nowiki>{{Skill name|Other Skill}}</nowiki></code>
+
; Field not defined (returns the input unchanged)
−
: {{User:Trang Oul/Sandbox/Template:Skill name|Other Skill}}
+
: <code><nowiki>{{Skill data|6|unknown}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|6|unknown}}
  
 +
: <code><nowiki>{{Skill data|Fire Wall|unknown}}</nowiki></code>
 +
: {{User:Trang Oul/Sandbox/Template:Skill data|Fire Wall|unknown}}
  
 
</noinclude><includeonly>{{#switch: {{{1|}}}
 
</noinclude><includeonly>{{#switch: {{{1|}}}

Latest revision as of 14:10, 13 November 2026

Sources

Built automatically from:

  • skills.txt (cols: skill - unique internal name, Id/*Id - ID, skilldesc - foreign key referencing skilldesc.txt, charclass - class abbreviation, reqlevel - required level)
  • skilldesc.txt (cols: skilldesc - primary key (referenced by skilldesc col from skills.txt), str name - key for the localized skill name string)
  • data\local\lng\strings (localized string values; Key is matched with str name from skilldesc.txt; enUS locale was used)

Only skills with matching skilldesc entry are included.
Class codes and required levels are also taken from skills.txt. To be done manually (?):

  • Add links to non-class skills - which?
  • Use internal names if the localized skill name string re-uses an existing skill name (like Tainted Resist Fire).

Usage

{{Skill data|<skill ID or internal name>|<field>}}

Parameters

1 (required)
Skill ID or internal name from skills.txt (also used as a skill property value).
2 (optional, defaults to label)
Field to return:
  • id - numeric skill ID.
  • name - internal name from skills.txt (not the localized skill name string)
  • label - localized skill name string value (currently enUS) from the game's string file. Class skills are returned as links.
  • class - class code; empty for non-class skills.
  • reqlvl - required character level; empty for non-class skills.
Unknown skills return parameter 1 unchanged, except for class and reqlvl, which return an empty value. Unknown fields also return parameter 1 unchanged.

Examples

Localized skill name string by ID
{{Skill data|6|label}}
Magic Arrow
{{Skill data|371|label}}
Mark of the Bear
Localized skill name string by internal name (notice that the string text can differ from the internal name)
{{Skill data|Magic Arrow|label}}
Magic Arrow
{{Skill data|Sigil Death|label}}
Sigil: Death
{{Skill data|Delerium Change|label}}
Delirium
{{Skill data|Townportal O Skill|label}}
Town Portal
{{Skill data|Tainted Fire Bolt|label}}
Fire Bolt
Skill ID by internal name
{{Skill data|Magic Arrow|id}}
6
{{Skill data|Frozen Orb|id}}
64
Internal name by ID (not the localized skill name string)
{{Skill data|222|name}}
Plague Poppy
{{Skill data|400|name}}
Sigil Death
Class code by ID or internal name
{{Skill data|6|class}}
ama
{{Skill data|86|class}}
nec
{{Skill data|Magic Arrow|class}}
ama
{{Skill data|Hex Bane|class}}
war
Required character level
{{Skill data|Magic Arrow|reqlvl}}
1
{{Skill data|Immolation Arrow|reqlvl}}
24
Non-class skill (empty class and required level)
{{Skill data|Tainted Fire Bolt|class}}
 (empty)
{{Skill data|Tainted Fire Bolt|reqlvl}}
 (empty)
Omitted field (defaults to label, the localized skill name string)
{{Skill data|6}}
Magic Arrow
Skill not defined
{{Skill data|9999|label}}
9999
{{Skill data|Other Skill|name}}
Other Skill
{{Skill data|Other Skill|class}}
 (empty)
{{Skill data|9999|reqlvl}}
 (empty)
Field not defined (returns the input unchanged)
{{Skill data|6|unknown}}
6
{{Skill data|Fire Wall|unknown}}
Fire Wall