Need Help with Publishing a New Character Sheet

I was following the steps listed here,&nbsp; <a href="https://app.roll20.net/forum/post/8843571/slug%7D" rel="nofollow">https://app.roll20.net/forum/post/8843571/slug%7D</a> &nbsp;, I got to step 7 where I wrote a name and description that it is a new character sheet and waited for the blue publish button to appear as stated in step 8 but nothing has happened yet. I am using GitHub Desktop on MacOS. While writing this post, my GitHub Desktop changed and I tried clicking on Publish Branch but nothing happened. Now it says Publish Repository and I honestly don't want to click on anything else cause I don't know GitHub at all and I don't want to mess anything up. Any help would be very much appreciated.

I'm not familiar with MacOS, so I miht be able to help you there. But don't worry about trying things out - nothing you do is set in stone, everything is reversible. You can't make changes to Roll20's repo without them lookig over those changes and deciding whether to accept thim, and you can change anything you submit.

GiGs said: I'm not familiar with MacOS, so I miht be able to help you there. But don't worry about trying things out - nothing you do is set in stone, everything is reversible. You can't make changes to Roll20's repo without them lookig over those changes and deciding whether to accept thim, and you can change anything you submit. Thanks for responding, GiGs. If you know anyone who is good with GitHub and knows MacOS, send them this way. I'm friends with the creator of this new sci-fi ttrpg called The Uplifted Universe. He just setup an instagram page for it. He asked me to make a sheet despite me knowing very little about coding and now he's almost finished with it and he wants to make sure the character sheet is available to everyone on Roll20 and not just Pro accounts that can paste it in a custom sheet in the settings. Everything was going pretty smoothly until step 8 so I'm a little disappointed. I tried following the instructions about publishing to GitHub in the Roll20 Wiki but it was just way too confusing, pictures were outdated, and none of it translated to MacOS which is all I've got. Hopefully somebody somewhere can help me out.

The biggest advice I can give is to use the command line instead of github desktop. I know the command line looks intimidating, but it is infinitely easier to do things with git using it and it is easier to figure out what has gone wrong when something does go wrong. Also, github desktop masks the actual operations behind buttons and links that don't have any relation to the actual git commands that are carried out (e.g. there is no such thing as "publish" in git, that's a github desktop thing that combines like three commands into one thing and frequently causes issues by doing so). This masking and the lack of error messages in github desktop make it essentially impossible to troubleshoot or look for answers online as pretty much every post talking about git will be referencing the errors received or the commands used; none of which is available to you if you are using the desktop app. The wiki has a pretty good&nbsp; short guide on using the cli . I'd recommend deleting your fork of the roll20 repository, and then start over using the command line instructions instead. One benefit of this is that the command line instructions are the same regardless of if you are on mac, linux, pc, or whatever. If you really want a more gui interface for git, then I'd recommend one of the git extensions for vscode, although your mileage may vary with these, and you'll likely still run into the issue of having difficulty looking up solutions to any issues you run into.

Scott C. said: The wiki has a pretty good&nbsp; short guide on using the cli . I'd recommend deleting your fork of the roll20 repository, and then start over using the command line instructions instead. One benefit of this is that the command line instructions are the same regardless of if you are on mac, linux, pc, or whatever. Thanks for your response, Scott. Trying out the CLI today and running into a small issue. We followed all the steps for first time setup and everything went fine. However, the link you recommended doesn't have a specific section to help with How to add your custom character sheet. I'm am very much a follow-every-step kind of person but right after the first time setup it just goes into other stuff that could be helpful. There's just a lot in that wiki and we're not sure what steps need to be done and what steps are optional. There's also no indication while following these steps that a command will be interacting with what I need it to, the character sheet. It just uses words like repository or directories, which may be okay for most but I, and I'm sure some others, are not proficient with this kind of stuff and having things explained a bit more in detail would be nice. The Table of Contents looks like this... 1 Why Git CLI instead of GitHub Desktop? 2 Reading this guide 3 First Time Setup 3.1 Additional Configs 4 Sparse Checkout 4.1 Adding Directories to Sparse Checkout 4.2 Removing Directories from Sparse Checkout 5 Commonly used commands 6 Workflow 6.1 Update Your Fork 6.1.1 Updating a work-in-progress branch 6.2 Creating a small fix and saving your progress 6.3 Submit a Pull Request to Roll20(on Github) 6.4 Working with multiple branches 6.5 Fixing your master branch 6.6 Git Status/Unstage File 6.7 Clean up Commits 6.8 How to Collaborate 6.8.1 Create a copy of someone's branch 6.8.2 Creating a sheet update suggestion &amp; sending it to your collaborator 6.8.3 Updating your branch when your collaborator have updated theirs 7 Glossary 8 Related Pages 9 See Also ...but doesn't show anywhere a step by step guide on how to publish your character sheet. After doing First time setup, we didn't know where to go. We went to Submit a pull request to roll20 on github but first thing it says is "This is a continuation of the previous example, where you Create a PR based on a branch you have on your GitHub." Something I'm sure we don't have cause I don't recall seeing anything like that in First time setup. So we looked back but everything before 6.3 is about small fixes, work-in-progress, and updating a fork which all sound like things you do when your sheet is already published and needs to be updated. Again, nothing here indicates whether we need to do this for a new character sheet. So, it all just feels like information overload, especially when you've never worked with this before.

huh, could have sworn workflow &nbsp;had a thing about adding your sheet. But until I get the wiki updated with this, here's what you'll want to do: Open your fork of the R20 repo in the cli create a new branch for adding your new sheet ( get checkout -b your-branch-name-here ) create a directory for your sheet in the repo (do this via your file explorer), and add the necessary files to it Follow steps 5 - 8 of the Creating a small fix and saving progress &nbsp;workflow on the wiki Then follow the Submit a Pull Request to Roll20 (on Github) &nbsp;workflow

All right, Thank You Scott C. for your assistance in this. After everything, we got to this and I'm not sure if this means I have to start over or just wait? Getting mixed signals from that yellow box.

Did you mark it as a "New Sheet"? (I think it's one of the submission checkboxes on github)&nbsp; All new sheet's normally fail the validation check, but I've never noticed the "No Modify Root Rule".&nbsp; See if you can edit the submission checklist comments and check "New Sheet" if you haven't and/or if it's available.

The No Modify Sheet Rule indicates to me they tried to modify the yaml file which decides how sheets are displayed when you are creating a campaign and selecting a sheet. That file (and everything else outside the sufolders) van only be edited by roll20 devs themselves. When you are creating a completely new sheet, they'll add oit to the yaml file themselves, and if there is some uncertainty about where it should go, they will ask you. Also, if the system isn't yet published, the sheet will probably be rejected. The rule is that people must be able to access the sheet rules now , whether for free or purchase. They must be publically available somewhere.

Thanks for your responses everyone! The Uplifted Universe hasn't been published yet so it would make sense if that was the problem but at least now I've been through the process for publishing the character sheet and I have this forum topic here to come back to, if I have questions. You all have been absolutely awesome with your help!

Sirius said: All right, Thank You Scott C. for your assistance in this. After everything, we got to this and I'm not sure if this means I have to start over or just wait? Getting mixed signals from that yellow box. Ah, it looks like you might have cloned your fork of the repo into itself which has caused a copy of the repo to be placed inside the repo and is creating an error for the script that validates the sheets. This is an easy fix though. In your roll20 character sheets repo directory, look for a directory called roll20-character-sheets &nbsp;and delete that. Then follow&nbsp; Follow steps 5 - 8 of the&nbsp; Creating a small fix and saving progress &nbsp;workflow on the wiki again to push that change to your branch. This will update the pull request in real time and should &nbsp;fix the issue. NOTE: You can see what files have been changed from the " Files Changed " tab of the pull request. Note the `roll20-character-sheets` directory that was added (last in the list).