> For the complete documentation index, see [llms.txt](https://stuykgaming.gitbook.io/old/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stuykgaming.gitbook.io/old/installation/debugging.md).

# Debugging

How to debug the game mode

## Debugging Athena

If you have implemented code but are not sure how to find an error then there's a few ways to approach it.

## Table of Contents

* [Debugging Athena](#debugging-athena)
* [Table of Contents](#table-of-contents)
  * [Fixing Installation Issues](#fixing-installation-issues)
  * [Debugging Code](#debugging-code)
    * [npm run check](#npm-run-check)
    * [Open Console in-game](#open-console-in-game)
  * [Common Issues](#common-issues)
    * [Black Screen on Join](#black-screen-on-join)
  * [Can't find the Error?](#cant-find-the-error)

### Fixing Installation Issues

Issues with node\_modules or certain modules not being found when starting the gamemode can usually be resolved by running the following command.

```
npm run fix
```

After you should install the gamemode normally.

```
npm install
```

```
npm run update
```

### Debugging Code

#### npm run check

This command you run your terminal will use the generic typescript compiler to help you find a `bug` in your code. If there's an issue it will tell you the exact file, and line number.

If it's at the end of a `bracket` then it's inside of the bracket that is causing the error.

To utilize this simply run in your terminal:

Enter the following in a terminal:

```
npm run check
```

#### Open Console in-game

Open your console in-game by press `F8` and see if anything is red. If there is red text than you may have encoutered an issue that is preventing you from fully joining / experiencing the server.

It's best to read the errors, check discord, etc. to figure out what the issue is.

Try to solve it yourself before asking around.

### Common Issues

#### Black Screen on Join

This is likely due to the webserver taking on another port other than `3000`. What that means is you need to either restart your machine, or kill all `node process`, `altv-server` processes, and maybe even `restart vscode`.

If you are running `npm run dev` on a remote server and are trying to connect to it, it will not work. Development mode only works on the same machine.

### Can't find the Error?

* Does the same issue occur on a clean Athena server?
* Have you tried removing any files you've added to see if it boots?
* Have you tried removing any additional resources you added to Athena?

Otherwise, open a support ticket in the discord for help.