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

Submitting my first character sheet

1592518281
Joshua S.
Pro
Sheet Author
API Scripter
I've got a character sheet working the way I want it to using the custom character sheet tool (for Fate of the Norns if anyone is interested). I've talked to the game developers and they want me to submit it as an official character sheet to roll20. Can someone walk me through the process of doing that? Thanks!
1592569348

Edited 1592570126
GiGs
Pro
Sheet Author
API Scripter
It's easier than you might expect. First, make sure your folder has the correct files in it: Setting up the Folder You need a html file, a css file, an image file which is a screenshot of your character sheet, and a special file called sheet.json. Create a file in notepad called  sheet.json , and put text like this inside it: {     "html": "your html filename.html",     "css": "your CSS filename.css",     "authors": "Joshua S.",     "roll20userid": "1220608",     "preview": "your preview image filename.jpg",     "instructions": "any description you want to appear here" } I've added your name and roll20 id there. You fill in the rest. Save this file in the same folder as your html and css file, and make sure you have a screenshot of the sheet saved too. The description is what gets seen when people are picking a character sheet to play. So you dont need to put much there. For best results, make sure the folder name only uses letters and numbers. In your case thats going to be easy. Then you can do the uploading to Github. Uploading to Github: a step-by-step guide Here's a simple 10-step procedure to get your sheet uploaded to github. It may look like a lot, but each one is extremely simple - usually just taking one or two mouseclicks. Just follow the steps one at a time, and you'll be fine. Create a github account Download and install github desktop Go to the roll20 repository , and click the Fork button (over on the right near the top), so it copies the repo to your github account Once the fork completes, click the Clone or Download on your fork. A prompt will appear: click Open in Desktop . This will open Github desktop and download the repo to your computer. It might take a while. Once its finished, it'll open a page in the Github Desktop. Find and click the Show in Explorer button.  Now copy your sheet folder to the repo folder on your harddrive. As a safety check: your folder should contain an html file, a css file, an image file of the character sheet to show as a preview, and a json file. You might also have a translations file, but that's optional. Once you have copied the files, navigate back to github desktop, and it will detect that files have changed. Enter a name and description (this will be displayed to the roll20 github devs, so you just need to let them know its a new sheet. Then click the Commit button After a few moments on the right side, a blue Publish Branch button will appear. Click that. After a few seconds, that button will be replaced by Create Pull Request . click that. This will open a browser page, which contains a green Create Pull Request button. Click that and you're done . And that's it. There's a bigger guide on the wiki for handling github, but for your first submission, the above should get you through it.
1592580275
David
Sheet Author
Joshua S. said: I've got a character sheet working the way I want it to using the custom character sheet tool (for Fate of the Norns if anyone is interested). I've talked to the game developers and they want me to submit it as an official character sheet to roll20. Can someone walk me through the process of doing that? Thanks! Does it use tables?
1592585913
Joshua S.
Pro
Sheet Author
API Scripter
David said: Does it use tables? Like, roll tables? No, or at least not yet. FotN is a diceless system and I haven't needed them
1592586180
Joshua S.
Pro
Sheet Author
API Scripter
GiG, I currently have it pulling image resources from my github. Should I change that to relative linkages?
1592587072
GiGs
Pro
Sheet Author
API Scripter
David meant are you using html tables for layout purposes. If so, roll20 wont accept the sheet. Joshua S. said: GiG, I currently have it pulling image resources from my github. Should I change that to relative linkages? Pulling from your github is fine, but once the sheet is accepted, people often switch to using the roll20 githib locations. Though I think you still need to use full address, not relative addresses. I dont think relative linkages are reliable through roll20s image server. Though to be fair, I havent tried it.
1592587495
Andreas J.
Forum Champion
Sheet Author
Translator
Joshua S. said: GiG, I currently have it pulling image resources from my github. Should I change that to relative linkages? <a href="https://wiki.roll20.net/Image_use_in_character_sheets" rel="nofollow">https://wiki.roll20.net/Image_use_in_character_sheets</a>
1592588851
GiGs
Pro
Sheet Author
API Scripter
I'd never seen that page, it's very good Andreas.
1592592123

Edited 1592592195
Andreas J.
Forum Champion
Sheet Author
Translator
GiGs said: I'd never seen that page, it's very good Andreas. I split up it from the related section on the main "Building Char Sheets "article at some point.
So excited for this! I've been waiting a long time for a viable sheet to use on Roll20!
1592670376
Joshua S.
Pro
Sheet Author
API Scripter
GiGs said: David meant are you using html tables for layout purposes. If so, roll20 wont accept the sheet. I'm using a grid layout ZymurgyOnHigh said: So excited for this! I've been waiting a long time for a viable sheet to use on Roll20! Awesome! I'll be releasing a companion script soon after that handles rune drawing, playmat usage, and a few other odds and ends. In fact, does anyone know how the process of submitting scripts works? is it basically the same as character sheets?
1593112993

Edited 1593113152
I honestly have no clue, but if Roll20 beats all other TTRPG Web-based UIs to the punch, and manages to provide support for this game, I will love them forever!!!!!! Please keep me informed about your progress. If you have discord, I can be reached there through my username: ZymurgyOnHigh#8238 Otherwise, I'll be checking this thread often to monitor progress! I'm DYING TO PLAY!!!!
1593114413
GiGs
Pro
Sheet Author
API Scripter
Joshua S. said: Awesome! I'll be releasing a companion script soon after that handles rune drawing, playmat usage, and a few other odds and ends. In fact, does anyone know how the process of submitting scripts works? is it basically the same as character sheets? It's basically the same as character sheets. You use the roll20-api-scripts github instead of the roll20-character-sheets one.
1593189537
Joshua S.
Pro
Sheet Author
API Scripter
ZymurgyOnHigh said: I honestly have no clue, but if Roll20 beats all other TTRPG Web-based UIs to the punch, and manages to provide support for this game, I will love them forever!!!!!! Please keep me informed about your progress. If you have discord, I can be reached there through my username: ZymurgyOnHigh#8238 Otherwise, I'll be checking this thread often to monitor progress! I'm DYING TO PLAY!!!! The character sheet is now live. I am still working on some features for the companion script, but it is functional now and you can download the script here &nbsp;and the readme here . It currently handles drawing and placing runes to the playmat, cleaning up runes from the playmat, and reflecting status from the character sheet to the playmat. I am currently working on a feature that will build your rune deck automatically based on the character sheet (right now you have to do it manually) and place alka tokens. If you are looking for an easy entry point for the game, I know that the FotN developers are going to release a starter adventure module based off of the one in the core rule book to the roll20 marketplace timed to coincide with the full release of the companion script (probably a week or two).