Roll20 Wiki

{{script overview
|name=Guidance: Starfinder Tools
|author={{user profile|927625|Russell_A._Sinclair}}
|version=2.0.1
|lastmodified=2021-02-19
|dependencies= [[Starfinder_simple|Starfinder_Simple_Sheet]] }}

'''Guidance: Starfinder Tools''' 
[[API]] for Roll20 and [[Starfinder simple|Starfinder (Simple)]]
Version 2.0.0

<p>This is a tool to support the usage of the This is a tool to support the usage of the [[Starfinder simple|Starfinder (Simple)]] character sheets in Roll20. It has the ability to read a statblock from the GMNotes section of a selected character and fill out the NPC section of the charactersheet. Statblocks from Archives of Nethys and Starjammer SRD are supported. Statblocks from PDFs can be used, but there may be parsing issues.</p> <p>&nbsp;</p> 

==THE MAIN COMMANDS==
<p>&nbsp;</p> <p><em><strong>!sf_character</strong></em></p> <p>This imports a Starfinder statblock in the GM Notes section of a character sheet and will out the NPC section of the [[Starfinder simple|Starfinder (Simple)]] character sheet. Furthermore, it configures the token's hit points and give EAC/KAC indicators.</p>
<p><em>How to:</em></p>
<ol> 
<li>Select and copy a stat block and paste it into the "GM Notes" section of a Character sheet. (Don't worry about removing any formatting)</li>
<li>Click Save.</li>
<li>Select the token that you have [[Link Token|linked to the character sheet]].</li>
<li>Type !sf_character. The script attempts to use the statblock to fill out the NPC section of the Starfinder (Simple) character sheet.</li>
</ol>
<p>The script supports character statblocks from the [https://www.aonsrd.com/Default.aspx Archives of Nethys] and the [https://www.starjammersrd.com/ Starjammer SRD]. <span style="font-style: italic;">Society PDFs, at least in the earlier ones, sometimes present issues. Double check the results after importing a statblock from a PDF.</span></p>
<p>&nbsp;</p> <p><strong><span style="font-style: italic;">!sf_starship</span></strong></p> <p>This imports a Starfinder starship statblock from the GM Notes section of a [https://wiki.roll20.net/Linking_Tokens_to_Journals linked character sheet] and populates the Starship page of the sheet. Furthermore, It adds gunnery and piloting check macros. If the statblock doesn&rsquo;t have stats for the pilot/gunner, the script adds prompts so that when you click the macro, you are prompted for the bonus.</p>
<p>This works the same as !sf_character but in practice, statblocks for starships are less consistent across platforms.</p> <p>&nbsp;</p> <p><em><strong>!sf_token</strong></em></p> <p>This populates the token with hitpoint, EAC, and KAC information in the event that the NPC sheet is setup, but the token isn't. The token will look like the one produced by !sf_character</p> <p>&nbsp;</p> <p><em><strong>!sf_clean</strong></em></p> <p>I've included this for completeness, but be warned - this command will <span style="text-decoration: underline;"><strong>PERMANENTLY ERASE</strong></span> things from the character sheet so use with caution. As above, this command requires selecting a token that has been [[Link Token|linked to the character sheet]].</p>
<p><em>How to:</em></p>
<p style="padding-left: 40px;"><em><strong>!sf_clean CONFIRM</strong></em> - This will erase ALL stats from the character sheet AND remove ALL formatting from the token. It will not touch the GM Notes section of the character sheet so it can be reimported using !sf_character.</p> <p style="padding-left: 40px;"><strong><em>!sf_clean ABILITIES</em></strong> - This will rease ALL macros from the character sheet.</p> <p>&nbsp;</p>

===OTHER USEFUL COMMANDS===
<p><em><strong>!sf_init</strong></em></p> <p>This rolls group initiative for all selected NPCs. The script refers to the Initiative bonus on the NPC tab of the character sheet to do this.</p> <p>&nbsp;</p> <p><em><strong>!sf_addtrick</strong></em></p> <p>This adds a macro to handle Trick Attacks for the NPC. Click over to the main "Character" page, and configure Trick Attacks to make it work.</p> <p>&nbsp;</p>
===The next two commands will require creating a simple macro to run correctly===
<p>The macro will look like this.</p>
<blockquote> <p style="padding-left: 40px;">!sf_ability ?{textToPaste}</p> </blockquote>
<p>&nbsp;</p> <p><em><strong>!sf_ability</strong></em></p> <p>This adds a special ability to the NPC character sheet for quick reference. If the macro has been created as described above, a box appears allowing you to paste the full text of a special ability.</p> <p>&nbsp;</p>
<p><em><strong>!sf_addspell</strong></em></p> <p>This adds a spell to the NPC character sheet as a macro. Similar to sf_ability, when you run the macro to call this, a box appears allowing you to paste the full text of the spell. The script formats the spellblock. Afterwards, I recommend manually editing the macro in the "description" tag to tailor the results of the macro for use in play.</p> <p>&nbsp;</p>  <p>[https://app.roll20.net/users/927625/kahn265 Feel free to reach out to me if you find any bug or have any suggestions!]</p>



[[Category:Starfinder]]