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
m (Syntax: corrected syntax boxes)
(8 intermediate revisions by one user not shown)
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:'''
 +
 
 +
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:
+
Forum post here: https://app.roll20.net/forum/post/2723217/script-languages
 +
 
 +
'''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.
 +
<br clear="all">
  
Source Code:
+
=== Syntax ===
 
+
{{syntaxbox top|Languages}}
https://github.com/anthonytasca/roll20-api-scripts/tree/master/Languages
+
{{API command|}}{{API parameter|name=language}} {{API parameter|name=message}}
 
+
{{syntaxbox end}}
Command 1:
+
{{param description top}}
 
+
{{param description|name=language|value=The language to speak. See Default Languages below for a full list of options, or create your own language with the command available below.}}
!theLanguage {theText}
+
{{param description|name=message|value=The message to send. Players who have the language in their character-sheet will see the message, while everyone else only sees the gibberish.}}
 
+
{{param description bottom}}
Example:
+
 
+
!Draconic hello there dragonborn
+
 
+
Result:
+
 
+
- 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.
+
- 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.
+
- If the player who enters this is speaking as a player, they will be notified that players cannot speak character languages.
+
- GMs can speak any language with any player or character
+
 
+
Command 2:
+
 
+
!setLanguageTag {attribute name}
+
 
+
Example:
+
 
+
!setLanguageTag playerlanguages
+
 
+
Result:
+
 
+
- 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")
+
 
+
Command 3:
+
 
+
!deleteLanguage {language name}
+
 
+
Example:
+
 
+
!deleteLanguage Dwarven
+
  
Result:
+
{{syntaxbox top|Languages}}
 +
{{API command|setlanguagetag}} {{API parameter|name=attribute}}
 +
{{syntaxbox end}}
  
- If the player is a GM, Dwarven will be deleted as a language
+
{{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}}
  
Command 4:
+
{{syntaxbox top|Languages}}
 +
{{API command|createlanguage}} {{API parameter|name=languagename}} {{API parameter|name=seednumber}} {{API parameter|name=parentlanguage}}
 +
{{syntaxbox end}}
  
!createLanguage {language name} {seed number} {parent language}
+
{{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}}
  
Example:
+
{{syntaxbox top|Languages}}
 +
{{API command|deletelanguage}} {{API parameter|name=attribute}}
 +
{{syntaxbox end}}
  
!createLanguage Underdwarven 5 Dwarven
+
{{param description top}}
 +
{{param description|name=attribute|value=The name of the language you wish to delete}}
 +
{{param description bottom}}
  
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|* abyssal
 +
* aquan
 +
* auran
 +
* celestial
 +
* draconic
 +
* druidic
 +
* dwarven
 +
* elven
 +
* giant
 +
* gnoll
 +
* gnome
 +
* goblin
 +
* halfling
 +
* ignan
 +
* infernal
 +
* orc
 +
* sylvan
 +
* terran
 +
* thieves'cant
 +
* 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|1.1.1|2015-12-17|* Release}}

Revision as of 08:45, 8 September 2016

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

Languages:

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

Forum post here: https://app.roll20.net/forum/post/2723217/script-languages

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.

Syntax

!<language> <message>
Parameter Values
language The language to speak. See Default Languages below for a full list of options, or create your own language with the command available below.
message The message to send. Players who have the language in their character-sheet will see the 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:

  • abyssal
  • aquan
  • auran
  • celestial
  • draconic
  • druidic
  • dwarven
  • elven
  • giant
  • gnoll
  • gnome
  • goblin
  • halfling
  • ignan
  • infernal
  • orc
  • sylvan
  • terran
  • thieves'cant
  • undercommon

Changelog

v1.1.1 (2015-12-17)

  • Release