Trying to register a new system
Hey everyone, I am new to Foundry system development. I am working with the boilerplate system and have the folder properly updated and placed my /Data/systems/ folder. However, when I launch Foundry VTT, I do not see this system registered to the Game Systems tab to begin testing. How do I ensure I properly connect this and set it up so I can begin development and test along the way?
Thank you!
24 Replies
Does it tell you any error in the console?
Make sure your system's
id
defined in the system.json
matches exactly with the name of the folderAnd it needs to be all lowercase
It doesn't (or at least to, it didn't used to)
Oh my mistake then
https://foundryvtt.com/article/system-development/
This article explains a lot, including how the manifest should look like
Introduction to System Development | Foundry Virtual Tabletop
The official website and community for Foundry Virtual Tabletop.
Very much recommended to use only a-z and 0-9 and hyphens. (And preferably not even hyphens.)
while I agree that only using lowercase is recommended (since various OS treat case sensitivity in file names differently), is there any real reason to avoid hyphens?
Convenience when using your own system/module id.
@Jeff "Arbron" Hitchcock So it does match, which is why I find it weird it hasn't registered to Foundry. The folder is "wands-and-wizards", which matches the ID in system.json. If this helps in your deduction, the boilerplate system's folder is also located under /Data/systems/, and it is not showing up in the Foundry application, either.
Thank you for providing that, but I had already reviewed that documentation last night before finding this Discord to post here.
@GM Shyann gave LeaguePoints™ to @Forien (#225 • 3)
I would go back to this message https://discord.com/channels/732325252788387980/1193778645974646866/1193780093013733416
Check if there are any errors in Setup/Console
errors can also be here
Okay, strange, its giving me the following error. But this does exist in the files, so what exactly is it wanting me to do? Is there a place it need to be linked?
can you show the part of manifest with
esmodules
?From system.json
looks good... and the screen you showed is inside your foundry data, right? or your project that is separate? 🤔
The console error I shared is from inside the Foundry application itself, yes.
I meant this screen. Is this folder structure you see in
FoundryData/Data/systems/wandsandwizards/
? or is it your project? If it's your project, can you make sure your mjs
file is in the FoundryData as well?It is both. It is my project, but I am developing it inside my /Data/systems folder in Foundry.
Full path to the project folder is "C:\Users\hello\AppData\Local\FoundryVTT\Data\systems\wandsandwizards"
ok, so weird... and
C:\Users\hello\AppData\Local\FoundryVTT\Data\systems\wandsandwizards\module\wandsandwizards.mjs
I guess is valid path to file as well...
and error shows up through Foundry restarts as well I assume?
I genuinely have no clue now 🤔Yeah, its where my D&D 5e system lives that does show up in the application so I'm unsure as well. I also did several resets hoping that was all that was needed with nothing new happening.
Yeah, I know its weird. I do have quite a bit of experience in dev (my full time job), but I am totally stumped by this 😓
@Forien Success! Instead of restarting just the application, tried one last hail mary and reset my whole computer. Upon launch Foundry this time, the new system was in there! Thank you for your assistance with troubleshooting. I was going a lil crazy for a sec lol
@GM Shyann gave LeaguePoints™ to @Forien (#207 • 4)
whole system? something must've really go wrong there lol
but good it works now!