Here is an inline FAQ on common problems.

We are filling it ourselves with common issues reported here or on the Discord. If you want to add something here specificaly though, you can always suggest it on the discord for example ;)

Dependencies installation fails

For versions < 2.4, TSCord relies on node-gyp for one of its core dependency. But man, node-gyp is a mess.

If you have issues with it while trying to install the dependencies of your project, first check if you have the native build tools required by node-gyp installed on your system. You can check all of this in its official documentation.

If you're still having issues while being absolutely sure you are all good on node-gyp dependencies, it may come from the use of Python 3.12, which doesn't support a core component of node-gyp anymore. If so, you should downgrade to Python 3.11 (reinstall or use something like pyenv to manage your Python versions).