cssharp logoCssharp Docs

快速入门

更简单的编写 CS2 插件的方法

什么是 Cssharp?

CounterStrikeSharp 是一款专为 Counter-Strike 2(CS2)服务器开发的插件框架,它为开发者提供了一种更加简洁和直观的方式来创建和管理游戏插件。

好的,下面是优化后的内容,使第二项的步骤看起来更加清晰和美观:


快速入门

要使用 CounterStrikeSharp 创建一个简单的插件,开发者只需按照以下步骤进行操作:

1. 安装基础运行环境

  • 下载并安装 .NET 8 Runtime,这是运行 CounterStrikeSharp 插件所必需的基础运行环境。

2. 安装服务器基础运行环境

  1. 下载必要工具

  2. 安装 Metamod

    • 解压下载的 Metamod 压缩包。
    • 将解压后的 /addons/ 目录复制到您的 CS2 安装目录的 /game/csgo/ 文件夹中。

    例如:

    C:\Program Files (x86)\Steam\steamapps\common\Counter-Strike 2\game\csgo\addons
  3. 修改 gameinfo.gi 文件

    • 进入 /game/csgo/ 目录,找到并打开 gameinfo.gi 文件。
    • SearchPaths 中,添加以下内容:
      Game_LowViolence csgo_lv
      Game csgo/addons/metamod
    • 修改完成后,保存文件。

    示例:
    在文件中正确添加路径后的效果应如下所示: gameinfo.gi 示例

  4. 确认 Metamod 是否加载

    • 重启服务器并打开控制台。
    • 输入以下命令:
      meta list
    • 如果 Metamod 安装成功,控制台应显示以下内容:
      meta list
      Listing 1 plugin:
        [01] CounterStrikeSharp (0.1.0) by Roflmuffin
    • 如果看到类似的输出,恭喜您,CounterStrikeSharp 已经成功安装!🎉

警告

对于 Windows 服务器,您必须安装 Visual Studio Redistributables,否则 CounterStrikeSharp 将无法运行。

升级 CounterStrikeSharp

要升级 CounterStrikeSharp,您只需下载最新版本并将其复制到您的服务器,与原始安装相同。

CounterStrikeSharp的设计保证了在某些情况下不会覆盖您的配置文件。由于CounterStrikeSharp已经安装,您可以下载不包含运行时的版本,但需要自行确保.NET运行时是最新版本。

故障排除指南

1. 初次安装要求

  • 如果这是您第一次安装该插件,您必须下载 with-runtime 版本。这个版本包含了运行插件所需的 .NET 运行时。
  • 根据您的操作系统,您可能需要使用包管理器安装 libicu(或 icu-libslibicu-dev),以便能够顺利运行 .NET 环境。

2. 错误提示:Unknown Command

  • 如果在控制台中出现 Unknown Command 错误(例如,输入 meta list 时),请检查以下几点:
    1. 确保文件夹已正确复制。
    2. 确认 gameinfo.gi 文件已正确修改。

3. 文件夹结构检查

确保您的文件夹结构符合以下规范:

<server_path>/game/csgo/addons
├── counterstrikesharp
│   ├── api
│   ├── bin
│   ├── dotnet
│   ├── plugins
│   └── gamedata

├── metamod
│   ├── bin
│   ├── counterstrikesharp.vdf
│   ├── metaplugins.ini
│   └── README.txt
├── metamod.vdf
└── metamod_x64.vdf

目录