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
(A comprehensive language script for any campaign)
 
m (Syntax: corrected syntax boxes)
(10 intermediate revisions by one user not shown)
Line 1: Line 1:
Introduction:
+
{{script overview
This script is a re-work of "WhatSaywithUnknown.js" by derekkoehl which is an enhancement on "What Did He Say?" by Stephen S.
+
|name=Languages
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
+
|author={{user profile|1000007|Anthony}}
 +
|version=1.1.1
 +
|lastmodified=2015-12-17}}
  
Installation:
+
'''Languages:'''
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:
+
A re-work of "WhatSaywithUnknown.js" by derekkoehl which is an enhancement on "What Did He Say?" by Stephen S.
https://github.com/anthonytasca/roll20-api-scripts/tree/master/Languages
+
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
  
Command 1:
+
Forum post here: https://app.roll20.net/forum/post/2723217/script-languages
  
!theLanguage {theText}
+
'''Installation:'''
  
Example:
+
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">
!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:
+
=== Syntax ===
 +
{{syntaxbox top|Languages}}
 +
{{API command|}}{{API parameter|name=language}} {{API parameter|name=message}}
 +
{{syntaxbox end}}
 +
{{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.}}
 +
{{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}}
  
!deleteLanguage Dwarven
+
{{syntaxbox top|Languages}}
 +
{{API command|setlanguagetag}} {{API parameter|name=attribute}}
 +
{{syntaxbox end}}
  
Result:
+
{{param description top}}
- If the player is a GM, Dwarven will be deleted as a language
+
{{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 ===
- If the player is a GM, Underdwarven will be created as a seed 5 language of Dwarven
+
The following languages come setup in this script:
  
Default Languages:
+
{{multicol|3|* abyssal
Abyssal, Aquan, Auran, Celestial, Draconic, Druidic, Dwarven, Elven, Giant, Gnome, Goblin, Gnoll, Halfling, Ignan, Infernal, Orc, Sylvan, Terran, Thieve'sCant, Undercommon, Unknown
+
* aquan
 +
* auran
 +
* celestial
 +
* draconic
 +
* druidic
 +
* dwarven
 +
* elven
 +
* giant
 +
* gnoll
 +
* gnome
 +
* goblin
 +
* halfling
 +
* ignan
 +
* infernal
 +
* orc
 +
* sylvan
 +
* terran
 +
* thieves'cant
 +
* undercommon}}
  
Notes:
+
=== Changelog ===
Please post here or message me if you find any bugs or have ideas for features that I can add to this script
+
{{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