CS2API 1.1.0

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;
using CS2API.Data;
using CS2API.Enumerations;

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}");
        });

        Instance.EntFireAtName("cover", "Enable");
    }
}

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}`);
});
Instance.EntFireAtName({ name: "cover", input: "Enable" });

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

C# equality operators are automatically converted to strict equality in JS. Casts, null-forgiving operators (!), numeric suffixes (1.5f), and generic type arguments are all stripped during transpilation.

Math and Random

Use System.Math directly -- all methods are automatically camelCased for JS (Math.Floor → Math.floor, Math.Cos → Math.cos). Constants like Math.PI are preserved as-is.

For random numbers, use Random.Shared.NextDouble() which transpiles to Math.random().

Supported Constructs

The transpiler supports the following C# constructs:

• Variables -- var, typed declarations, const
• Control flow -- if/else if/else, switch/case/default, ternary (a ? b : c)
• Loops -- for, foreach (-> for...of), while, do...while, break, continue
• Functions -- local functions, class methods, lambdas (both () => {} and x => {})
• Collections -- List<T> with Add, Contains, IndexOf, RemoveAt, Insert, Count; collection expressions ([1, 2, 3]); element access (list[i])
• Object creation -- new Vector(x, y, z) → JS object literals; object initializers (new Config { Prop = val })
• Strings -- interpolation ($"text {expr}"), System.String methods (auto-camelCased)
• Enums -- CS2API enums auto-convert to UPPER_SNAKE_CASE and are added to the import
• Config-object methods -- methods like EntFireAtName automatically wrap arguments into a JS object literal
• Tuples -- transpiled to JS objects using element names
• Namespaces and classes -- stripped (JS has no equivalent)

Not yet supported

• async/await
• LINQ (Where, Select, etc.)
• try/catch/finally
• Pattern matching (switch expressions, complex is patterns)
• string.Format (use string interpolation instead)

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
• Fields -- transpiled to top-level let/const declarations

License

See LICENSE.md for details.