Skip to main content

Empowering Your Server Logic

The core Alt:V server environment is a high-performance, lightweight engine. To implement custom game mechanics, economy systems, or interactive UI elements, you must install specific “Modules” that provide the execution environment for programming languages like JavaScript, TypeScript, or C#.

Difficulty

Intermediate

Time

5 Minutes

Installation & Configuration

Follow these steps to enable the necessary scripting modules on your FREAKHOSTING server.
1

Upload Module Binaries

Place the appropriate module files into the /modules/ directory of your server.
  • Linux Environments (Recommended): Use shared object files (e.g., libjs-module.so).
  • Windows Environments: Use dynamic-link library files (e.g., csharp-module.dll).
2

Update server.cfg

Open your server.cfg (or server.toml) and register the modules within the modules array.
modules: [
  'csharp-module',
  'js-module'
]
3

Initialize the Environment

Restart your server and monitor the Console tab. You should observe log entries confirming that the selected modules have been successfully initialized and are ready for script execution.

Selecting Your Development Path

Alt:V supports multiple languages to accommodate different development workflows.
This is the most popular choice for the Alt:V community. It uses the js-module and provides access to the vast NPM ecosystem, making it ideal for rapid prototyping and large-scale web-integrated systems.

File Permission Requirements

When managing a Linux-based environment, ensure your module files have the appropriate execution permissions (typically chmod 755). If you are using our Game Panel, these permissions are automatically managed during the upload process.

Advanced Module Tips

It is important that your module versions exactly match your server binary version. A mismatch can lead to silent crashes or unexpected behavior during script execution.
Alt:V also supports third-party modules for languages like Python or Rust. While these follow a similar installation pattern, always consult the specific module’s documentation for unique dependency requirements.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!

Last Updated: January 2026 | Logic: Powering your gamemode.