CS2API 1.0.5

CS2API

A C# wrapper and transpiler for Counter-Strike 2's Workshop JavaScript API. Write your point_script scripts in C# with full type safety and IntelliSense, then automatically transpile them to clean JS.

Why?

CS2 Workshop scripts are written in JavaScript using the point_script entity API. CS2API lets you write those scripts in C# instead, giving you:

• Type safety -- catch errors at compile time, not in-game
• IntelliSense -- full autocomplete for every API method, event, and type
• Clean output -- transpiles to dependency-free JS that runs directly in CS2's V8 environment

Installation

dotnet add package CS2API

The package includes both the API stubs (for writing scripts) and the compiler (for transpiling to JS). After building your project, the transpiler runs automatically and outputs .js files to a Scripts/ directory.

Quick Start

Create a new console or class library project and add the CS2API package. Then write a script:

using CS2API;

namespace MyWorkshopMap;

public class Script
{
    public static void Main()
    {
        Instance.Msg("Hello from C#!");

        Instance.OnRoundStart(() =>
        {
            Instance.Msg("Round started!");
        });

        Instance.OnPlayerChat((e) =>
        {
            Instance.Msg($"Player said: {e.text}");
        });
    }
}

This transpiles to:

import { Instance } from "cs_script/point_script";
Instance.Msg("Hello from C#!");
Instance.OnRoundStart(() => {
  Instance.Msg("Round started!");
});
Instance.OnPlayerChat((e) => {
  Instance.Msg(`Player said: ${e.text}`);
});

Configuration

By default, the transpiler runs after every build and outputs to Scripts/. You can customize this in your .csproj:

<PropertyGroup>
  
  <CS2APIOutputDir>$(MSBuildProjectDirectory)\MyScripts</CS2APIOutputDir>

  
  <CS2APICompilerEnabled>false</CS2APICompilerEnabled>
</PropertyGroup>

Type Mappings

Project Structure

Your C# scripts should follow this pattern:

• Namespace -- used for organization, stripped in output
• Script class -- the wrapper class, unwrapped in output
• Main() method -- the entry point, its body becomes top-level statements
• Other methods -- transpiled to JS function declarations

License

See LICENSE.md for details.