Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Script:Languages"

From Roll20 Wiki

Jump to: navigation, search
m
Line 1: Line 1:
Introduction:
+
{{script overview
 +
|name=Languages
 +
|author={{user profile|1000007|Anthony}}
 +
|version=1.1.1
 +
|lastmodified=2015-12-17}}
  
This script is a re-work of "WhatSaywithUnknown.js" by derekkoehl which is an enhancement on "What Did He Say?" by Stephen S.
+
'''Languages''' is a re-work of "WhatSaywithUnknown.js" by derekkoehl which is an enhancement on "What Did He Say?" by Stephen S.
 
It gets rid of the character sheet method for picking a language and implements a command line interface. It also includes features for creating languages, deleting languages, and, setting the character sheet language attribute name that the script uses for compatibility with all character sheets
 
It gets rid of the character sheet method for picking a language and implements a command line interface. It also includes features for creating languages, deleting languages, and, setting the character sheet language attribute name that the script uses for compatibility with all character sheets
 +
  
 
Installation:
 
Installation:
  
 
If the character sheets in your campaign do not use "prolanguages" as the attribute name for langauges then you must use the !setLanguageTag command as described below in order to set this script up for your campaign. Users will be notified, in game, if the language attribute is not set up properly.
 
If the character sheets in your campaign do not use "prolanguages" as the attribute name for langauges then you must use the !setLanguageTag command as described below in order to set this script up for your campaign. Users will be notified, in game, if the language attribute is not set up properly.
 +
 +
  
 
Source Code:
 
Source Code:
  
 
https://github.com/anthonytasca/roll20-api-scripts/tree/master/Languages
 
https://github.com/anthonytasca/roll20-api-scripts/tree/master/Languages
 +
<br clear="all">
  
Command 1:
+
=== Syntax ===
 
+
{{syntaxbox top|Languages|formal=true}}
!theLanguage {theText}
+
{{API command|}}{{API parameter|name=language}} {{API parameter|name=message}}
 
+
{{Formal API command|
Example:
+
{{token|S}} {{rarr}} {{API command|}}{{token|language}} {{token|message|-}}
 
+
{{token|message}} {{rarr}} {{string|-}}
!Draconic hello there dragonborn
+
{{token|language}} {{rarr}} aboleth<br>
 
+
{{token|language}} {{rarr}} abyssal<br>
Result:
+
{{token|language}} {{rarr}} aklo<br>
 
+
{{token|language}} {{rarr}} aquan<br>
- If the player who enters this is speaking as a character that has Draconic, under the languages on their character sheet, they will say "hello there dragonborn" in Draconic. Any player who is currently online and is speaking as a character that also has Draconic on their character sheet will be whispered "hello there dragonborn". Others will be whispered symbols representing the language.
+
{{token|language}} {{rarr}} auran<br>
- If the player who enters this is speaking as a character that does not have Draconic(under languages on their character sheet), they will "pretend to speak" Draconic.
+
{{token|language}} {{rarr}} boggard<br>
- If the player who enters this is speaking as a player, they will be notified that players cannot speak character languages.
+
{{token|language}} {{rarr}} celestial<br>
- GMs can speak any language with any player or character
+
{{token|language}} {{rarr}} cyclops<br>
 
+
{{token|language}} {{rarr}} draconic<br>
Command 2:
+
{{token|language}} {{rarr}} drow<br>
 
+
{{token|language}} {{rarr}} druidic<br>
!setLanguageTag {attribute name}
+
{{token|language}} {{rarr}} dwarven<br>
 
+
{{token|language}} {{rarr}} elven<br>
Example:
+
{{token|language}} {{rarr}} giant<br>
 
+
{{token|language}} {{rarr}} gnoll<br>
!setLanguageTag playerlanguages
+
{{token|language}} {{rarr}} gnome<br>
 
+
{{token|language}} {{rarr}} goblin<br>
Result:
+
{{token|language}} {{rarr}} halfling<br>
 
+
{{token|language}} {{rarr}} ignan<br>
- If the player who enters this is a GM and playerlanguages is the name of a character sheet attribute in the campaign, the script will use "playerlanguages" when it searches character sheet attributes for player's languages (instead of the default "prolanguages")
+
{{token|language}} {{rarr}} infernal<br>
 
+
{{token|language}} {{rarr}} orc<br>
Command 3:
+
{{token|language}} {{rarr}} protean<br>
 
+
{{token|language}} {{rarr}} sphinx<br>
!deleteLanguage {language name}
+
{{token|language}} {{rarr}} sylvan<br>
 
+
{{token|language}} {{rarr}} tengu<br>
Example:
+
{{token|language}} {{rarr}} terran<br>
 
+
{{token|language}} {{rarr}} treant<br>
!deleteLanguage Dwarven
+
{{token|language}} {{rarr}} undercommon
 
+
}}
Result:
+
{{syntaxbox end}}
 
+
- If the player is a GM, Dwarven will be deleted as a language
+
  
Command 4:
+
{{param description top}}
 +
{{param description|name=language|value=The language to speak. See Supported Languages below for a full list of options.}}
 +
{{param description|name=message|value=The message to send. Players with control over the language's character sheet will see the original message, while everyone else only sees the gibberish.}}
 +
{{param description bottom}}
  
!createLanguage {language name} {seed number} {parent language}
+
{{syntaxbox top|Languages|formal=true}}
 +
{{API command|}}{{API parameter|name=setlanguagetag}} {{API parameter|name=attribute}}
 +
{{param description top}}
 +
{{param description|name=attribute|value=The name of the attribute that character sheets in your campaign use for languages}}
 +
{{param description bottom}}
 +
{{syntaxbox end}}
  
Example:
+
{{syntaxbox top|Languages|formal=true}}
 +
{{API command|}}{{API parameter|name=createlanguage}} {{API parameter|name=languagename}} {{API parameter|name=seednumber}} {{API parameter|name=parentlanguage}}
 +
{{param description top}}
 +
{{param description|name=languagename|value=The name of the language that you wish to create}}
 +
{{param description|name=seednumber|value=A single digit number that represents how related this language is to its parent}}
 +
{{param description|name=parentlanguage|value=The name of the parent language that the new language gets it's name from}}
 +
{{param description bottom}}
 +
{{syntaxbox end}}
  
!createLanguage Underdwarven 5 Dwarven
+
{{syntaxbox top|Languages|formal=true}}
 +
{{API command|}}{{API parameter|name=deletelanguage}} {{API parameter|name=attribute}}
 +
{{param description top}}
 +
{{param description|name=attribute|value=The name of the language you wish to delete}}
 +
{{param description bottom}}
 +
{{syntaxbox end}}
  
Result:
+
=== Default Languages ===
 +
The following languages come setup in this script:
  
- If the player is a GM, Underdwarven will be created as a seed 5 language of Dwarven
+
{{multicol|3|* aboleth
 +
* abyssal
 +
* aklo
 +
* aquan
 +
* auran
 +
* boggard
 +
* celestial
 +
* cyclops
 +
* draconic
 +
* drow
 +
* druidic
 +
* dwarven
 +
* elven
 +
* giant
 +
* gnoll
 +
* gnome
 +
* goblin
 +
* halfling
 +
* ignan
 +
* infernal
 +
* orc
 +
* protean
 +
* sphinx
 +
* sylvan
 +
* tengu
 +
* terran
 +
* treant
 +
* undercommon}}
  
Default Languages:
+
=== Changelog ===
Abyssal, Aquan, Auran, Celestial, Draconic, Druidic, Dwarven, Elven, Giant, Gnome, Goblin, Gnoll, Halfling, Ignan, Infernal, Orc, Sylvan, Terran, Thieve'sCant, Undercommon, Unknown
+
{{changelog version|2.0|2014-10-11|* Release}}

Revision as of 22:04, 17 December 2015

API ScriptAuthor: Anthony
Version: 1.1.1
Last Modified: 2015-12-17
Code: Languages
Dependencies: None
Conflicts: None

Languages is a re-work of "WhatSaywithUnknown.js" by derekkoehl which is an enhancement on "What Did He Say?" by Stephen S. It gets rid of the character sheet method for picking a language and implements a command line interface. It also includes features for creating languages, deleting languages, and, setting the character sheet language attribute name that the script uses for compatibility with all character sheets


Installation:

If the character sheets in your campaign do not use "prolanguages" as the attribute name for langauges then you must use the !setLanguageTag command as described below in order to set this script up for your campaign. Users will be notified, in game, if the language attribute is not set up properly.


Source Code:

https://github.com/anthonytasca/roll20-api-scripts/tree/master/Languages

Syntax

!<language> <message>
Formally:

S

→ !language
message


message

string

language

→ aboleth

language

→ abyssal

language

→ aklo

language

→ aquan

language

→ auran

language

→ boggard

language

→ celestial

language

→ cyclops

language

→ draconic

language

→ drow

language

→ druidic

language

→ dwarven

language

→ elven

language

→ giant

language

→ gnoll

language

→ gnome

language

→ goblin

language

→ halfling

language

→ ignan

language

→ infernal

language

→ orc

language

→ protean

language

→ sphinx

language

→ sylvan

language

→ tengu

language

→ terran

language

→ treant

language

→ undercommon
Parameter Values
language The language to speak. See Supported Languages below for a full list of options.
message The message to send. Players with control over the language's character sheet will see the original message, while everyone else only sees the gibberish.
!<setlanguagetag> <attribute>
Parameter Values
attribute The name of the attribute that character sheets in your campaign use for languages
!<createlanguage> <languagename> <seednumber> <parentlanguage>
Parameter Values
languagename The name of the language that you wish to create
seednumber A single digit number that represents how related this language is to its parent
parentlanguage The name of the parent language that the new language gets it's name from
!<deletelanguage> <attribute>
Parameter Values
attribute The name of the language you wish to delete

Default Languages

The following languages come setup in this script:

  • aboleth
  • abyssal
  • aklo
  • aquan
  • auran
  • boggard
  • celestial
  • cyclops
  • draconic
  • drow
  • druidic
  • dwarven
  • elven
  • giant
  • gnoll
  • gnome
  • goblin
  • halfling
  • ignan
  • infernal
  • orc
  • protean
  • sphinx
  • sylvan
  • tengu
  • terran
  • treant
  • undercommon

Changelog

v2.0 (2014-10-11)

  • Release