Note: Page was last properly updated in 2016, so may be outdated and not display all features or user cases for the API

Overview

Star Wars: Fantasy Flight Games - Dice Roller is made to roll the special dice used in Fantasy Flight Games' Star Wars RPG.

The API have a version 6.4.3 in the repository added in 2018, but it wasn't made the current version for some reason.

This API is intended to be used with the Star Wars: FFG (API-Compatible)-Character Sheet. The script had it's last major updated in March 2018. See also Star Wars FFG for related things.

This Dice Roller is adapted from a previous script (Eote-Dice.js) and provides for a display of the dice for the FFG Star Wars RPG system.

API Chat Commands

Note: Page was last properly updated in 2016, so may be outdated and not display all features or user cases for the API

Settings

Log

• default: 'on' and 'single'
• Description: Sets the visual output in the chat window for the dice rolls
• Command: !eed log on|off|multi|single

Graphics

• default: 'on' and 'm'
• Description: Sets chat window dice output as graphic, small, medium, or large if "on" or as text if "off"
• Command: !eed graphics on|off|s|m|l

Test

• Description: Output every side of every die to the chat window
•  !eed test

Debug

• default: 'off'
• Description: Sets the logging level of the script in the API console. If you are having issues with the script rolling incorrect dice, turn on debug logging and post the result in the forums. No need to restart the script with this command.
• Command: !eed debug on|off

Roll

Label

• default: null
• Description: set the skill name of the roll
• Command: !eed label(Name of Skill)

Initiative

• default: false
• Description: Set NPC/PC initiative true
• Command: !eed npcinit or pcinit and #b #g #y #blk #p #r #w

Skill

• default:
• Description: create the ability and proficiency dice for a skill check
• Command: !eed skill(char_value|skill_value)

Opposed

• default:
• Description: create the difficulty and challenge dice for an opposed skill check
• Command: !eed opposed(char_value|skill_value)

Dice

• default:
• Description: Loop thru the dice and adds or subtracts them from the dice object
• Command: !eed #g #y #b #blk #r #p #w #s #a

Upgrade

• default:
• Description: upgrades ability and difficulty dice
• Command: !eed upgrade(ability|#) or upgrade(difficulty|#)

Downgrade

• default:
• Description: downgrades proficiency and challenge dice
• Command: !eed downgrade(proficiency|#) or downgrade(challenge|#)

Destiny

• default:
• Description: Rolls 1w die and adds the result to the destiny pool
• Command: !eed #w destiny doRoll

Other

Charsheet

• default:
• Description: Generates a blank character sheet and automatically makes it viewable and editable by the person calling the script.
• Command: !charsheet

Script Information

 The script does a few things for the Fantasy Flight Games Star Wars system.

• Rolls the custom dice with the symbols.
  • The Blue Boost Die
  • The Green Ability Die
  • The Yellow Proficiency Die
  • The White Force Die
  • The Black Setback Die
  • The Purple Difficulty Die
  • The Red Challenge Die
• It auto-cancels the dice.
  • Success
    • These exist on the Blue/Green/Yellow Dice.
    • Represented by a picture that looks like an explosion
    • Can be cancelled out by a Failure.
  • Failure
    • These exist on the Black/Purple/Red Dice.
    • Represented by a picture that looks like an unside-down triangle.
    • Can be cancelled out by a Success.
  • Advantage
    • These exist on the Blue/Green/Yellow Dice.
    • Represented by a picture that looks like antlers with a dot in the middle.
    • Can be cancelled out by a Threat.
  • Threat
    • These exist on the Black/Purple/Red Dice.
    • Represented by a picture that looks like Tie Fighter windows.
    • Can be cancelled out by an Advantage.
  • Triumph
    • These exist only on the Yellow Dice.
    • Represented by a picture that looks like a circle, surrounding an explosion branching out into 2 perpendicular lines.
      • The picture is similar to the "Star Wars: A New Hope" poster with Luke holding his lightsaber up to the sky.
    • Has 2 symbols associated with it. A Success and the Triumph.
      • The Success can be cancelled out by a Failure.
      • The Triumph cannot be cancelled out.
  • Despair
    • These exist only on the Red Dice.
    • Represented by a picture that looks like a Circle with an upside-down triangle in it.
    • Has 2 symbols associated with it. A Failure and the Despair.
      • The Failure can be cancelled out by a Success.
      • The Despair cannot be cancelled out.
  • Black Force Pips
    • These exist only on the White Dice.
    • Represented by a Black circle.
    • Force Pips cannot be cancelled out.
    • If you are not a Dark Side Force User you can use Dark Side pips to activate Force Powers as long as you spend 1 Destiny Point and take 1 strain for each Dark Side pip you are using.
      • Note: This does not work for all Force Powers, some situations require a certain color Force Pip.
  • White Force Pips
    • These exist only on the White Dice.
    • Represented by a White circle, outlined in Black.
    • Force Pips cannot be cancelled out.
• In combination with the Character Sheet it was designed for, it Provides the ability to;
  • Roll Critical Injuries / Critical Hits
  • Roll and Track Destiny Points
  • Auto apply encumbrance threshold breaches (If you are over your encumbrance threshold it auto adds setback dice.
  • Auto apply setbacks to negative handling in vehicles.
  • Applies settings that support Roll Templates for Dice Rolls.

Changelog

Version 6.3.0 (March 2018)

• Added Skill Roll Suggestion Engine, NPC Sheet, collapsible sections, and much more

Version 4.0.4.3 (March 2016)

• PR
• Made by KnowledgeRhino

Older Versions

• Version 4.0.4.2 - Not Compatible with Depreciated Star Wars - Edge of the Empire (API-Compatible) Character Sheet - Needs to use 4.0.4.0 or higher to utilize. - Added Roll Templates
• Version 4.0.2.17 - Compatible with Depreciated Star Wars - Edge of the Empire (API-Compatible) Character Sheet - Added code cleanup and Character Sheet Auto Creator
• Version 3.0 - Compatible with Depreciated Star Wars - Edge of the Empire (API-Compatible) Character Sheet - Added Destiny Rolls
• Version 2.6 - Compatible with Depreciated Star Wars - Edge of the Empire (API-Compatible) Character Sheet

Credits

 Note: The credits listed below are for the Character Sheet and the Script, at times functionality overlaps between the two, Additionally, historically it has been used for the display of the credits of both projects.

 Original creator: Konrad J.
 Helped with Dice specs: Alicia G. and Blake the Lake
 Dice graphics hosted by Alicia G. at galacticcampaigns.com
 Dice graphics borrowed from the awesome google+ hangouts EotE Dice App
 Basic Character Sheet and Advanced Dice Roller: Steve Day
 GM Sheet Campaign Details design inspiration: www.reddit.com/user/JohnSquiggleton
 Sheet Autocreator: www.reddit.com/user/lowdownfool
 New Tab Labels: Steve D., GM Knowledge Rhino, and Loki
 Skill Description by: Gribble - https://dl.dropboxusercontent.com/u/9077657/SW-EotE-Reference-Sheets.pdf
 Critical Descriptions by: Gribble - https://dl.dropboxusercontent.com/u/9077657/SW-EotE-Reference-Sheets.pdf
 Debugger: Arron
 Basic Roll Templates for basic rolls: Josh A.
 Initiative Roller: Andrew H.
 Opposed Roller: Tom F.

Work done by GM Knowledge Rhino

• Group Tab
• Companion Tab
• GM Resources
• ReDesign of Vehicle Tab
• Riding Beast Display
• Roll Template Code Fixes
• Roll Templates integrated with all Rolls

See Also

• Star Wars: FFG (API-Compatible) - character sheet meant for the API
• FFG SWRPG Dice Roller sourcecode
• List of Star Wars RPGs on Roll20