Roll20 uses cookies to improve your experience on our site. Cookies enable you to enjoy certain features, social sharing functionality, and tailor message and display ads to your interests on our site and others. They also help us understand how our site is being used. By continuing to use our site, you consent to our use of cookies. Update your cookie preferences .
×
Create a free account

[Help] I'm having trouble understanding how to submit a new character sheet.

1455747343

Edited 1455747472
Grim G.
Sheet Author
So after nearly a year of rage quitting HTML and procrastinating since I subscribed, I have finally made a sheet. Problem is I have no idea what I'm doing, I've already seen the article, Beginner's Guide to GitHub,&nbsp; <a href="https://wiki.roll20.net/Beginner's_Guide_to_GitHub" rel="nofollow">https://wiki.roll20.net/Beginner's_Guide_to_GitHub</a> but I'm stuck on the part labeled "CLONE Your Repository". Can anyone help? EDIT: Also while I'm asking questions I have to ask, Is there a private roll function for character sheets?
1455783851
vÍnce
Pro
Sheet Author
After you fork <a href="https://github.com/Roll20/roll20-character-sheets" rel="nofollow">https://github.com/Roll20/roll20-character-sheets</a> Install GitHub desktop&nbsp; <a href="https://desktop.github.com/" rel="nofollow">https://desktop.github.com/</a> from inside the desktop gui, you will find a clone option (big + symbol in the left pane, choose clone tab and highlight your fork) This will create a "clone" of your fork locally. &nbsp; Add a folder for your sheet with all the required files (htm, css, json, image) Open the desktop gui and make a Pull Request Go online to your github account/repo and accept/merge your changes and submit a PR to the Roll20 repo. wait for the repo manager to accept your PR wait some more for the roll20 servers to add/update your sheet. Those are the basic steps I follow. &nbsp;Not real detailed, but if you have questions or get stuck just ask. &nbsp;;-) Private roll? &nbsp;Not sure I understand. &nbsp;/talktomyself will hide your chat from other players and the gm.
1455792068

Edited 1455792151
Chris D.
Pro
Sheet Author
API Scripter
Compendium Curator
EDIT: Also while I'm asking questions I have to ask, Is there a private roll function for character sheets? As you are probably aware, roll20 supports two types of roll,&nbsp; /roll 2d6 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;is a public roll. /gmroll 2d6 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; is a roll that is only viewed by the person who made the roll and the gm.&nbsp; Personally, I have used the API to upgrade to a 3rd option&nbsp; !hiddenroll 2d6 &nbsp; &nbsp; &nbsp; Where the result is displayed to the GM ONLY, and not to the person who made the roll. Personally, I think this ought to made one of the standard rolls. There are many times when the GM wants a player to roll the dice, but not know the result.&nbsp; You don't need to use the API to do this, you can also do it with /w gm 2d6 The character sheet I have designed lets the user select which of the three types of roll are used used by that sheet. I always set NPCs to hidden rolls and most players leave it as public rolls, though they have the choice to set the default to gmroll.&nbsp;
Vince said: Add a folder for your sheet with all the required files (htm, css, json, image) That's the step I'm stuck on, I don't know what any of this is or what is required for them The character sheet I have designed lets the user select which of the three types of roll are used used by that sheet. I always set NPCs to hidden rolls and most players leave it as public rolls, though they have the choice to set the default to gmroll.&nbsp; Interesting, how do you add that in a sheet?
1455808100

Edited 1455808159
vÍnce
Pro
Sheet Author
You create the folder on your local clone. &nbsp;When you clone your fork, it creates a github folder with the fork's root and all of the sheet sub-folders. &nbsp;Just create your own sub-folder there with your files. &nbsp;When you make changes to your local clone, ALL changes will be added when you merge/PR. Whisper options can be added by creating a whisper selector attribute with your options, then you add the whisper option attribute to a button's value for the roll. &nbsp; example of the PF sheet: &lt;label&gt;NPC rolls: Whisper to GM or broadcast publicly &lt;span title="All NPC rolls will be whispered to the GM."&gt; &lt;select name="attr_NPC-whisper"&gt; &lt;option value="&nbsp;"&gt;Public Rolls&lt;/option&gt; &lt;option value="/w gm" selected&gt;Whisper GM&lt;/option&gt; &lt;/select&gt; &lt;/span&gt; &lt;/label&gt; You would just include @{NPC-whisper} wherever you want that option to whisper. Hope this helps. &nbsp;Cheers
Vince said: Just create your own sub-folder there with your files. What files?
1455823005
Finderski
Plus
Sheet Author
Compendium Curator
Grim G. said: Vince said: Just create your own sub-folder there with your files. What files? The html file, the css file, you'll want to create a preview image, create a readme.md, and a json file. You can look in github for examples of what the layout for each of those files.
1455863913
vÍnce
Pro
Sheet Author
You get it figured out Grim? &nbsp;The whole github thing can be rather confusing, but once you get it...
G V. said: Grim G. said: Vince said: Just create your own sub-folder there with your files. What files? The html file, the css file, you'll want to create a preview image, create a readme.md, and a json file. You can look in github for examples of what the layout for each of those files. do I have to create these files from scratch?
1456009142
Finderski
Plus
Sheet Author
Compendium Curator
Grim G. said: G V. said: Grim G. said: Vince said: Just create your own sub-folder there with your files. What files? The html file, the css file, you'll want to create a preview image, create a readme.md, and a json file. You can look in github for examples of what the layout for each of those files. do I have to create these files from scratch? Mostly. You've already created your html and css files. The preview image is nothing more than a screen cap of your character sheet in roll20. the readme.md and the sheet.json &nbsp;files you will need to create, but I just copy them from existing github folders and modify to suit my sheet.
G V. said: Grim G. said: G V. said: Grim G. said: Vince said: Just create your own sub-folder there with your files. What files? The html file, the css file, you'll want to create a preview image, create a readme.md, and a json file. You can look in github for examples of what the layout for each of those files. do I have to create these files from scratch? Mostly. You've already created your html and css files. The preview image is nothing more than a screen cap of your character sheet in roll20. the readme.md and the sheet.json &nbsp;files you will need to create, but I just copy them from existing github folders and modify to suit my sheet. So first off, I already created a html file in roll20, do I have to copy that and put it in notepad? 2, I'm not using a css file, what do I do about that? 3, the sheet is so big it has a scroll wheel, how do I screen cap that? 4, what are the readme.md and sheet.json files?
1456178161
Finderski
Plus
Sheet Author
Compendium Curator
Grim G. said: So first off, I already created a html file in roll20, do I have to copy that and put it in notepad? 2, I'm not using a css file, what do I do about that? 3, the sheet is so big it has a scroll wheel, how do I screen cap that? 4, what are the readme.md and sheet.json files? Yep, just copy/paste it from roll20 into notepad and save it as a .html file. Not sure...maybe create a blank text file and save it with a .css extension Depends on how you want to handle. Some people just grab what they can, others will take multiple screen shots of the sheet and stitch them together in a graphics program (like Gimp or Photoshop) They are just separate text documents. &nbsp;See below for examples... readme.md (for the BASH character sheet) BASH: Ultimate Edition Character Sheet ====================================== This character sheet is designed for ease of navigation—everything is on one sheet, with a similar layout to the standard BASH character sheet. Roll Buttons: Brawn, Agility, Mind, Agility Specialized Roll, Mind Specialized Roll, Stat of 0, and Powers, are all roll buttons. Merely click the word to roll the dice. It is anticipated that Brawn, Agility, and Mind would be used for skill rolls that aren't specialized. In addition, each weapon has it's own roll button for rolling damage. sheet.json (for BASH character sheet) { &nbsp; &nbsp;"html": "BASH.html", &nbsp; &nbsp;"css": "BASH.css", &nbsp; &nbsp;"authors": "Rich Finder", &nbsp; &nbsp;"roll20userid": "173448", &nbsp; &nbsp;"preview": "BASH.png", &nbsp; &nbsp;"instructions": "# BASH: Ultimate Edition Character Sheet\r## Stat & Skill Rolls\rThe three Core Stats are:\r\r* **Brawn**\r* **Agility**\r* **Mind**\r\rEach of those labels is also a roll button that will output 2d6, and if doubles will output an additional d6 (if that additional die outputs the same number as the doubles, another d6 will be rolled—after that, the player must manually roll any additional d6s).\r\rIt is anticipated that those three roll buttons will be used for any standard skill roll. &nbsp;If a character needs to make a specialized skill roll, there are two additional buttons:\r\r* **Agility Specialized** roll\r* **Mind Specialized** roll\r\rClicking on either of those labels will make the same type of roll as a standard skill roll, but will do it twice, so the higher of the two rolls can be taken.\r\r**Stat of Zero**\rIf a character has a stat that is zero, you can click on the Stat of 0 roll label and a single d6 roll will be output, automatically rolling any roll that comes up a 6. Unlike the Stat and Skill rolls, this die result will continue rolling until no more sixes are rolled, so no additional rolls will be necessary.\r\r## Powers\rThe label of the Powers section is also a roll button that outputs the result of a single d6 to indicate whether the character successfully activated a power. \r\rThe rest of the section is repeating section so you can add as many powers as necessary. The first row contains a field for the power name, and a number field to the right to indicate the rank. The second row of each power is a free-form text field to note any special information pertaining to the power.\r## Weapons\rThis is a repeating section with fields to document the weapon, damage, type of weapon (Ranged or Melee), and Ammo. Additionally, below each weapon is a free-form text field to capture any special notes about the weapon.\r\rEach weapon also contains a roll button for rolling damage, and will output a roll similar to that of skills and Stats.\r## A Note on Rolls\rAll rolls (except for Powers activation) will automatically prompt the user to enter any Dice Bonus/Penalty, Multiplier Mod, and Result Bonus/Penalty. &nbsp;These values will not be added/subtracted from the total, but will be displayed along with the roll result.\r\rStat and Skill (including specialized skill) rolls automatically include the value in the relevant field as part of the multiplier mod, so when this prompt is displayed, the player should only enter anything additional (and it will be added to the final output). The same is true for the Damage multiplier on Weapons.\r\rAdditionally for **melee** damage rolls, the Result bonus will automatically calculate the higher of Brawn * 5 or 15 and output whichever is lower, so the when prompted for Result bonus/penalty, only include anything additional beyond the basics.\r## Special Thanks\rA special thanks goes to **Gareth**, for his help in understanding how the rolls in BASH work, and for giving solid direction on what is needed for a BASH sheet." } The stuff in the double quotes after instructions is in markup format. That's not necessary, but makes the text description of the character sheet when selected from the drop easier to read. &nbsp;The "\r" is just the code for a new line, so even if you don't use the markup formatting, I would recommend using the "\r" to break things up. &nbsp;It also all has to be on one line (meaning, no carriage returns or line breaks by hitting enter), so I find it easier to create that file like I would a regular text document and then when I'm finished I go back and remove all the line breaks by replacing them with the "\r" until it's all on one line. If you need help with the sheet.json file, you can send me the stuff that should go in there, and I'm happy to help you get it formatted properly...just PM me.