💻
alt:V Athena Docs v3.0.0
  • Info
    • Introduction
    • Patreon & Support
    • Athena Discord
    • FAQ
  • Installation
    • Common Issues
    • Windows
    • Linux (Ubuntu 20.04+)
    • Debugging
    • Updating
  • Info
    • Admin
    • Configuration
    • Console
    • Database
    • Hotkeys
    • Identifier
  • Plugins
    • Load Plugins
    • Create Plugins
    • Mods
    • Clothing
  • Controllers
    • What is a Controller?
    • Blip Controller
    • Interaction Controller
    • Marker Controller
    • Object Controller
    • Ped Controller
    • Text Label Controller
    • World Notification Controller
  • Systems
    • Interiors
    • Inventory & Items
    • Inventory Rules
    • Jobs
    • Time
    • Weather
  • Menus
    • Menu Types
    • Action Menus
    • Input Menu
    • Wheel Menu
  • Player
    • Admin-Commands
    • Animations
    • Attach Objects
    • Credits
    • Currency
    • Commands
    • Error Screen
    • Message
    • Meta
    • Notifications
    • Particle
    • Progress Bar
    • Save
    • Shard
    • Sound
    • Spinners
    • Task Timeline
  • Custom WebViews
    • Introduction
    • Your First Page
    • CSS Framework
  • Misc
    • Custom Sounds
    • Custom Streamers
    • Custom Icons
    • Adding Locale / Translations
    • Adding Vehicle Rules
    • Adding Whitelist
    • Adding Wheel Menus
    • Adding Parking Garages
Powered by GitBook
On this page
  • Debugging Athena
  • Table of Contents
  • Fixing Installation Issues
  • Debugging Code
  • Common Issues
  • Can't find the Error?
Edit on GitHub
  1. Installation

Debugging

How to debug the game mode

PreviousLinux (Ubuntu 20.04+)NextUpdating

Last updated 2 years ago

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

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.

Debugging Athena
Table of Contents
Fixing Installation Issues
Debugging Code
npm run check
Open Console in-game
Common Issues
Black Screen on Join
Can't find the Error?