# qwqCounterStrikeSharpPlugin
**Repository Path**: vincent-zyu/qwqCounterStrikeSharpPlugin
## Basic Information
- **Project Name**: qwqCounterStrikeSharpPlugin
- **Description**: 🎮 CS2 服务端 C# 插件模板项目 — 玩家输入 qwq，服务端回复 qwq！✨ 基于 CounterStrikeSharp，GitHub Actions 自动构建发布 🚀qwq......qwq!
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-09-06
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
> **[📖 English](README.md)**
> **[📖 简体中文(大陆)](README.zh-cn.md)**
[](https://github.com/VincentZyuApps/qwqCounterStrikeSharpPlugin)
[](https://gitee.com/vincent-zyu/qwqCounterStrikeSharpPlugin)
[](https://github.com/roflmuffin/CounterStrikeSharp)
[](https://developer.valvesoftware.com/wiki/Counter-Strike_2/Dedicated_Servers)
[](https://dotnet.microsoft.com/)
[](https://qm.qq.com/q/4vjto4V7Di)
💬 插件使用问题 / 🐛 Bug反馈 / 👨💻 插件开发交流，欢迎加入QQ群：259248174 🎉（这个群G了
💬 插件使用问题 / 🐛 Bug反馈 / 👨💻 插件开发交流，欢迎加入QQ群：1085190201 🎉
💡 在群里直接艾特我，回复的更快哦~ ✨
# 🎮 ✨ 🚀 💬 qwqCounterStrikeSharpPlugin
一个 Counter-Strike 2 服务端插件：聊天框输入 `qwq` 会收到 `qwq!`。真人玩家进服时，所有人会看到 `qwq！！！`；真人玩家离服时，所有人会看到 `qwq.....`。
基于 [CounterStrikeSharp](https://github.com/roflmuffin/CounterStrikeSharp) 框架，使用 C# (.NET 10) 编写。
## 🏃 💨 🔜 快速开始
### 📦 🔧 部署到服务器
1. **安装 Metamod:Source**
参考 https://cs2.poggu.me/metamod/installation/
下载对应的发行版，比如 Linux 版，解压到 `csgo/` 目录
解压后结构：
```
csgo/addons/
└── metamod/
```
2. **安装 CounterStrikeSharp**
下载 [with-runtime 版本](https://github.com/roflmuffin/CounterStrikeSharp/releases)
解压 `addons/` 合并到 `csgo/` 目录
合并后结构：
```
csgo/
└── addons/
├── metamod/
└── counterstrikesharp/
├── api/
├── dotnet/
└── plugins/
```
3. **放入插件**
CSS 要求插件放在 `plugins/<插件名>/<插件名>.dll` 子目录中（目录名 = DLL 文件名）。
从 [Releases](https://github.com/VincentZyuApps/qwqCounterStrikeSharpPlugin/releases/latest) 下载 `.dll`：
```bash
# 一般默认的steam路径在 ~/.local 里面
cd "path/to/Steam/steamapps/common/Counter-Strike Global Offensive/game"
TAG=<最新版本号>
PLUGIN_DIR=csgo/addons/counterstrikesharp/plugins/qwqCounterStrikeSharpPlugin
mkdir -p $PLUGIN_DIR
cd $PLUGIN_DIR
wget "https://github.com/VincentZyuApps/qwqCounterStrikeSharpPlugin/releases/download/$TAG/qwqCounterStrikeSharpPlugin-$TAG.dll"
mv qwqCounterStrikeSharpPlugin-$TAG.dll qwqCounterStrikeSharpPlugin.dll
```
最终插件结构：
```
plugins/
└── qwqCounterStrikeSharpPlugin/
└── qwqCounterStrikeSharpPlugin.dll
```
4. **启动服务器**
```bash
./cs2 -dedicated -game csgo +map de_dust2 +sv_lan 1
```
控制台看到 `Finished loading plugin qwq CounterStrikeSharp Plugin` 即加载成功。
5. **进游戏测试**
聊天框输入 `qwq` → 收到绿色回复 `qwq!`
真人玩家进服时 → 所有人会在左下角聊天区看到 `qwq！！！`；真人玩家离服时 → 所有人会在那里看到 `qwq.....`
> **[📋 我的自己的环境的部署指令记录](doc/images/prod/prod.md)**
## 🤖 ⚙️ 🔄 GitHub Actions
推送到 GitHub 时，**commit 信息中的关键词控制流水线行为**。
详细说明见下方 [「构建工作流指南」](#构建工作流指南)。
| 关键词 | 构建 | 发布 Release |
|---|---|---|
| `build action` | ✅ | ❌ |
| `build release` | ✅ | ✅ |
[](https://github.com/VincentZyuApps/qwqCounterStrikeSharpPlugin/commits/main)
[](https://github.com/VincentZyuApps/qwqCounterStrikeSharpPlugin/actions)
## 📋 🏗️ 🚀 构建工作流指南
推送到 GitHub 时，**commit 信息中的关键词**控制 CI/CD 流水线的行为。
### 🔑 📌 关键词速查
| 关键词 | Build（编译 DLL） | Release（发布到 Releases） |
|---|---|---|
| `build action` | ✅ | ❌ |
| `build release` | ✅ | ✅ |
#### ⚠️ 关键词不匹配
如果 commit 信息中**没有上述任一关键词**，流水线**不执行**，不会浪费 Actions 配额。
### 🏭 📊 流水线阶段
```
check ──→ build ──→ release
│ │ │
│ │ └── 下载 artifact → 创建 GitHub Release → 上传 zip
│ │
│ └── dotnet restore → dotnet build → 打包 zip → 上传 artifact
│
└── 解析 commit 信息 → 输出控制 flag
```
#### 🔍 阶段一：check（解析 commit）
- 读取最新一条 commit 的 message
- 匹配关键词，设置 `should_build` / `should_release` 开关
- 从 `qwqCounterStrikeSharpPlugin.csproj` 的 `` 标签提取版本号
- Release 标签格式：`v{版本号}-{run_number}` （例如 `vx.y.z-k`）
#### 🛠️ 阶段二：build（编译）
- `dotnet restore` 还原 NuGet 依赖
- `dotnet build -c Release` 编译插件
- 产出 `QwqCounterStrikeSharpPlugin.dll` + `.pdb` 打包为 `qwqCounterStrikeSharpPlugin.zip`
- 上传到 Actions Artifact
#### 🎯 阶段三：release（发布）
- 下载 Artifact
- 使用版本号创建 Git tag
- 创建 GitHub Release，附上 zip 文件
### 📝 💻 使用示例
```bash
# 只构建，不发布
git commit -m "fix: 修了个bug, build action"
# 构建并发布 Release
git commit -m "feat: 加了个新功能, build release"
```
### 📦 📄 产物说明
Artifact / Release 中的 zip 包含：
| 文件 | 说明 |
|---|---|
| `QwqCounterStrikeSharpPlugin.dll` | 插件主程序（放到服上 `addons/counterstrikesharp/plugins/`） |
| `QwqCounterStrikeSharpPlugin.pdb` | 调试符号文件（可选，保留方便报错时定位行号） |
### 🔖 🔢 自定义版本号
编辑 `qwqCounterStrikeSharpPlugin.csproj` 中的 `` 字段：
```xml
x.y.z
```
编辑 `QwqCounterStrikeSharpPlugin.cs` 中的类属性字符串 `ModuleVersion` 的值：
```cs
public override string ModuleVersion => "x.y.z";
```
下次触发 Release 时，标签会自动变成 `vx.y.z-{run_number}`。