docx: update 404 page

Co-authored-by: Michael Wilson <roflmuffin@users.noreply.github.com>
Co-authored-by: Roflmuffin <shortguy014@gmail.com>

.github/workflows/cmake-single-platform.yml

@@ -3,7 +3,7 @@ name: Build & Publish
 on:
   push:
     paths-ignore:
-      - 'docs/**'
+      - 'docfx/**'
     branches: [ "main" ]
   pull_request:
     branches: [ "main" ]

.github/workflows/publish-docs.yml

@@ -1,42 +1,46 @@
-name: Deploy to GitHub Pages
-
 on:
-  # Trigger the workflow every time you push to the `main` branch
-  # Using a different branch name? Replace `main` with your branch’s name
   push:
-    paths:
-      - 'docs/**'
-    branches: [ main ]
+    branches:
+      - main
 
-  # Allows you to run this workflow manually from the Actions tab on GitHub.
-  workflow_dispatch:
-
-# Allow this job to clone the repo and create a page deployment
 permissions:
   contents: read
   pages: write
   id-token: write
 
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout your repository using git
-        uses: actions/checkout@v3
-      - name: Install, build, and upload your site
-        uses: withastro/action@v1
-        with:
-          path: ./docs # The root location of your Astro project inside the repository. (optional)
-          node-version: 20 # The specific version of Node that should be used to build your site. Defaults to 18. (optional)
-          package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
 
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
+jobs:
+  publish-docs:
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+
     steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Dotnet Setup
+        uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: 8.x
+
+      - run: dotnet tool update -g docfx
+
+      - run: docfx docfx/docfx.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v3
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: "docfx/_site"
+
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v1
+        uses: actions/deploy-pages@v2

.gitignore

@@ -1,6 +1,6 @@
 .ccls-cache/
 .cmake/
-cmake-build-debug/
+cmake-build-debug*/
 .kdev4/
 .vscode/
 generated/
@@ -548,4 +548,9 @@ $RECYCLE.BIN/
 
 _NCrunch*
 
-.idea/
+.idea/
+
+# docfx
+docfx/_site/
+docfx/api/
+docfx/_exported_templates/

docfx/404.md

@@ -0,0 +1,3 @@
+# 404
+
+We recently changed our docs. Your page may exist at a different location.

docfx/docfx.json

@@ -0,0 +1,46 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../managed/CounterStrikeSharp.API",
+          "files": ["**/*.csproj"],
+          "exclude": ["**/bin/**", "**/obj/**"]
+        }
+      ],
+      "filter": "filterConfig.yml",
+      "dest": "api",
+      "namespaceLayout": "nested"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": ["**/*.{md,yml}"],
+        "exclude": ["_site/**"]
+      }
+    ],
+    "resource": [
+      {
+        "files": ["images/**"]
+      }
+    ],
+    "output": "_site",
+    "template": ["default", "modern", "layouts/cssharp"],
+    "globalMetadata": {
+      "_appFaviconPath": "images/cssharp.svg",
+      "_appFooter": "<a href=\"https://docs.cssharp.dev\">docs.cssharp.dev</a>",
+      "_appLogoPath": "images/cssharp.svg",
+      "_appName": "CounterStrikeSharp",
+      "_appTitle": "CounterStrikeSharp",
+      "_disableNewTab": true,
+      "_enableNewTab": true,
+      "_enableSearch": true,
+      "pdf": false
+    },
+    "sitemap": {
+      "baseUrl": "https://docs.cssharp.dev",
+      "changefreq": "hourly"
+    }
+  }
+}

docfx/docs/admin-framework/admin-command-attributes.md

@@ -3,6 +3,10 @@ title: Admin Command Attributes
 description: A guide on using the Admin Command Attributes in plugins.
 ---
 
+# Admin Command Attributes
+
+A guide on using the Admin Command Attributes in plugins.
+
 ## Assigning permissions to a Command
 
 Assigning permissions to a Command is as easy as tagging the Command method (function callback) with either a `RequiresPermissions` or `RequiresPermissionsOr` attribute. The difference between the two attributes is that `RequiresPermissionsOr` needs only one permission to be present on the caller to be passed, while `RequiresPermissions` needs the caller to have all permissions listed. CounterStrikeSharp handles all of the permission checks behind the scenes for you.

docfx/docs/admin-framework/defining-admin-groups.md

@@ -3,6 +3,10 @@ title: Defining Admin Groups
 description: A guide on how to define admin groups for CounterStrikeSharp.
 ---
 
+# Defining Admin Groups
+
+A guide on how to define admin groups for CounterStrikeSharp.
+
 ## Adding Groups
 
 Groups can be created to group a series of permissions together under one tag. They are defined in `configs/admin_groups.json`. The important things you need to declare is the name of the group and the permissions they have.
@@ -34,9 +38,9 @@ You can add admins to groups using the `groups` array in `configs/admins.json`
 }
 ```
 
-:::note
-All group names MUST start with a hashtag # character, otherwise CounterStrikeSharp won't recognize the group.
-:::
+> [!NOTE]
+> All group names MUST start with a hashtag # character, otherwise CounterStrikeSharp won't recognize the group.
+
 
 Admins can be assigned to multiple groups and they will inherit their flags. You can manually assign groups to players in code with `AdminManager.AddPlayerToGroup` and `AdminManager.RemovePlayerFromGroup`.
 

docfx/docs/admin-framework/defining-admin-immunity.md

@@ -3,6 +3,10 @@ title: Defining Admin Immunity
 description: A guide on how to define immunity for admins for CounterStrikeSharp.
 ---
 
+# Defining Admin Immunity
+
+A guide on how to define immunity for admins for CounterStrikeSharp.
+
 ## Player Immunity
 
 Admins can be assigned an immunity value, similar to SourceMod. If an admin or player with a lower immunity value targets another admin or player with a larger immunity value, then the command will fail. You can define an immunity value by adding the `immunity` key to each admin in `configs/admins.json`.
@@ -31,6 +35,5 @@ You can even assign an immunity value to groups. If an admin has a lower immunit
 }
 ```
 
-:::note
-CounterStrikeSharp does not automatically handle immunity checking. It is up to individual plugins to handle immunity checks as they can implement different ways of targeting players. This can be done in code with `AdminManager.CanPlayerTarget`. You can also set a player's immunity in code with `AdminManager.SetPlayerImmunity`.
-:::
+> [!NOTE]
+> CounterStrikeSharp does not automatically handle immunity checking. It is up to individual plugins to handle immunity checks as they can implement different ways of targeting players. This can be done in code with `AdminManager.CanPlayerTarget`. You can also set a player's immunity in code with `AdminManager.SetPlayerImmunity`.

docfx/docs/admin-framework/defining-admins.md

@@ -3,6 +3,10 @@ title: Defining Admins
 description: A guide on how to define admins for CounterStrikeSharp.
 ---
 
+# Defining Admins
+
+A guide on how to define admins for CounterStrikeSharp.
+
 ## Admin Framework
 
 CounterStrikeSharp has a basic framework which allows plugin developers to assign permissions to commands. When CSS is initialized, a list of admins are loaded from `configs/admins.json`.
@@ -26,9 +30,8 @@ Adding an Admin is as simple as creating a new entry in the `configs/admins.json
 
 You can also manually assign permissions to players in code with `AdminManager.AddPlayerPermissions` and `AdminManager.RemovePlayerPermissions`. These changes are not saved to `configs/admins.json`.
 
-:::note
-All user permissions MUST start with an at-symbol @ character, otherwise CounterStrikeSharp will not recognize the permission.
-:::
+> [!NOTE]
+> All user permissions MUST start with an at-symbol @ character, otherwise CounterStrikeSharp will not recognize the permission.
 
 ### Standard Permissions
 
@@ -55,7 +58,5 @@ However there is a somewhat standardized list of flags that it is advised you us
 @css/root # Magically enables all flags and ignores immunity values.
 ```
 
-:::note
-CounterStrikeSharp does not implement traditional admin command such as `!slay`, `!kick`, and `!ban`. It is up to individual plugins to implement these commands.
-:::
-
+> [!NOTE]
+> CounterStrikeSharp does not implement traditional admin command such as `!slay`, `!kick`, and `!ban`. It is up to individual plugins to implement these commands.

docfx/docs/admin-framework/defining-command-overrides.md

@@ -3,6 +3,10 @@ title: Defining Command Overrides
 description: A guide on how to define command overrides for CounterStrikeSharp.
 ---
 
+# Defining Command Overrides
+
+A guide on how to define command overrides for CounterStrikeSharp.
+
 ## Defining Admin and Group specific overrides
 
 Command permissions can be overriden so specific admins or groups can execute the command, regardless of any permissions they may or may not have. You can define command overrides by adding the `command_overrides` key to each admin in `configs/admins.json` or group in `configs/admin_groups.json`. Command overrides can either be set to `true`, meaning the admin/group can execute the command, or `false`, meaning the admin/group cannot execute the command at all.

docfx/docs/admin-framework/toc.yml

@@ -0,0 +1,14 @@
+- name: Admin Command Attributes
+  href: admin-command-attributes.md
+
+- name: Defining Admins
+  href: defining-admins.md
+
+- name: Defining Command Overrides
+  href: defining-command-overrides.md
+
+- name: Defining Admin Groups
+  href: defining-admin-groups.md
+
+- name: Defining Admin Immunity
+  href: defining-admin-immunity.md

docfx/docs/features/console-commands.md

@@ -3,6 +3,10 @@ title: Console Commands
 description: How to add a new console command
 ---
 
+# Console Commands
+
+How to add a new console command
+
 ## Adding a Console Command
 
 ### Automatic registration

docfx/docs/features/console-variables.md

@@ -3,6 +3,10 @@ title: Console Variables
 description: How to read & write console variables (ConVars).
 ---
 
+# Console Variables
+
+How to read & write console variables (ConVars).
+
 ## Finding a ConVar
 
 Use the `ConVar.Find` static method to find a reference to an existing ConVar (or `null`).

docfx/docs/features/game-events.md

@@ -3,15 +3,18 @@ title: Game Events
 description: How to listen to Source 1 style game events.
 ---
 
+# Game Events
+
+How to listen to Source 1 style game events.
+
 ## Adding an Event Listener
 
 ### Automatic registration
 
 CounterStrikeSharp will automatically register event listeners marked with a `GameEventHandler` attribute on the `BasePlugin` class. These listeners are automatically registered/deregistered for you on hot reload.
 
-:::note
-The first parameter type must be a subclass of the `GameEvent` class. The names are automatically generated from the [game event list](https://cs2.poggu.me/dumped-data/game-events).
-:::
+> [!NOTE]
+> The first parameter type must be a subclass of the `GameEvent` class. The names are automatically generated from the [game event list](https://cs2.poggu.me/dumped-data/game-events).
 
 ```csharp
 [GameEventHandler]

docfx/docs/features/global-listeners.md

@@ -3,6 +3,10 @@ title: Global Listeners
 description: How to subscribe to CounterStrikeSharp global listeners.
 ---
 
+# Global Listeners
+
+How to subscribe to CounterStrikeSharp global listeners.
+
 ## Adding a Listener
 
 Global listeners come in a variety of shapes so there is no automatic registration for these, they must be registered in the `OnLoad` of your plugin (or anywhere you have access to the plugin instance). You can find the full list of event listeners in the `Listeners` class as seen below.

docfx/docs/features/toc.yml

@@ -0,0 +1,11 @@
+- name: Console Commands
+  href: console-commands.md
+
+- name: Console Variables
+  href: console-variables.md
+
+- name: Game Events
+  href: game-events.md
+
+- name: Global Listeners
+  href: global-listeners.md

docfx/docs/guides/dependency-injection.md

@@ -1,10 +1,12 @@
 ---
 title: Dependency Injection
 description: How to make use of dependency injection in CounterStrikeSharp
-sidebar:
-  order: 1
 ---
 
+# Dependency Injection
+
+How to make use of dependency injection in CounterStrikeSharp
+
 `CounterStrikeSharp` uses a standard <a href="https://learn.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection?view=aspnetcore-8.0" target="_blank">`IServiceCollection`</a> to allow for dependency injection in plugins.
 
 There are a handful of standard services that are predefined for you (`ILogger` for logging for instance), with more to come in the future. To add your own scoped & singleton services to the container, you can create a new class that implements the `IPluginServiceCollection<T>` interface for your plugin.

docfx/docs/guides/getting-started.md

@@ -1,26 +1,25 @@
 ---
 title: Getting Started
 description: How to get started installing & using CounterStrikeSharp.
-sidebar:
-  order: 0
 ---
 
-# Installation
+# Getting Started
 
-### Installing Metamod
+How to get started installing & using CounterStrikeSharp.
+
+## Installing Metamod
 
 `CounterStrikeSharp` uses `Metamod:Source` as its main way of communicating with the game server. To install it, you can follow the detailed instructions found <a href="https://cs2.poggu.me/metamod/installation/" target="_blank">here</a>.
 
-### Installing CounterStrikeSharp
+## Installing CounterStrikeSharp
 
 Download the latest release of CounterStrikeSharp from <a href="https://github.com/roflmuffin/CounterStrikeSharp/actions/workflows/cmake-single-platform.yml" target="_blank">GitHub actions build pages</a> (just choose the latest development snapshot). **You may need to be logged into GitHub to gain access to the downloads**.
 
-:::caution[.NET Runtime]
-If this is your first time installing, you will need to download the `with-runtime` version. This includes a copy of the .NET runtime, which is required to run the plugin.
-Depending on the os you might also either need to install `libicu` / `icu-libs` / `libicu-dev` using your package manager for .NET to run or setting `DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true` in your servers environment variables. You can find more infos about that <a href="https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md#enabling-the-invariant-mode" target="_blank">here</a> 
-
-Subsequent upgrades will not require the runtime, unless a version bump of the .NET runtime is required (i.e. from 7.0.x to 8.0.x). We will inform you when this occurs.
-:::
+> [!CAUTION]
+> If this is your first time installing, you will need to download the `with-runtime` version. This includes a copy of the .NET runtime, which is required to run the plugin.
+> Depending on the os you might also either need to install `libicu` / `icu-libs` / `libicu-dev` using your package manager for .NET to run or setting `DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true` in your servers environment variables. You can find more infos about that <a href="https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md#enabling-the-invariant-mode" target="_blank">here</a> 
+> 
+> Subsequent upgrades will not require the runtime, unless a version bump of the .NET runtime is required (i.e. from 7.0.x to 8.0.x). We will inform you when this occurs.
 
 Extract the `addons` folder to the `/csgo/` directory of the dedicated server. The contents of your addons folder should contain both the `counterstrikesharp` folder and the `metamod` folder as seen below.
 
@@ -28,22 +27,22 @@ Extract the `addons` folder to the `/csgo/` directory of the dedicated server. T
 <server_path>/game/csgo/addons > tree -L 2
 addons
 ├── counterstrikesharp
-│   ├── api
-│   ├── bin
-│   ├── dotnet
-│   ├── plugins
+│   ├── api
+│   ├── bin
+│   ├── dotnet
+│   ├── plugins
 │   └── gamedata
 │
 ├── metamod
-│   ├── bin
-│   ├── counterstrikesharp.vdf
-│   ├── metaplugins.ini
-│   └── README.txt
+│   ├── bin
+│   ├── counterstrikesharp.vdf
+│   ├── metaplugins.ini
+│   └── README.txt
 ├── metamod.vdf
 └── metamod_x64.vdf
 ```
 
-### Start the Server
+## Start the Server
 
 Launch your CS2 dedicated server as normal. If everything is working correctly, you should see a message in the console that says `CSSharp: CounterStrikeSharp.API Loaded Successfully.`.
 
@@ -53,4 +52,4 @@ Running the command `meta list` in the console should show 1 plugin loaded 🎉
 meta list
 Listing 1 plugin:
   [01] CounterStrikeSharp (0.1.0) by Roflmuffin
-```
+```

docfx/docs/guides/hello-world-plugin.md

@@ -1,10 +1,12 @@
 ---
 title: Hello World Plugin
 description: How to write your first plugin for CounterStrikeSharp
-sidebar:
-  order: 0
 ---
 
+# Hello World Plugin
+
+How to write your first plugin for CounterStrikeSharp
+
 ## Creating a New Project
 
 First, ensure you have the relevant .NET 7.0 SDK for your platform installed on your machine. You can find the links to the latest downloads on the <a href="https://dotnet.microsoft.com/en-us/download/dotnet/7.0" target="_blank"> official Microsoft download page</a>.
@@ -36,12 +38,11 @@ Use your IDE (Visual Studio/Rider) to add a reference to the `CounterStrikeSharp
 </Project>
 ```
 
-:::tip
-Instead of manually adding a reference to `CounterStrikeSharp.Api.dll`, you can install the NuGet package `CounterStrikeSharp.Api` using the following:
-```shell
-dotnet add package CounterStrikeSharp.API
-```
-:::
+> [!TIP]
+> Instead of manually adding a reference to `CounterStrikeSharp.Api.dll`, you can > install the NuGet package `CounterStrikeSharp.Api` using the following:
+> ```shell
+> dotnet add package CounterStrikeSharp.API
+> ```
 
 ### Creating a Plugin File
 
@@ -78,20 +79,17 @@ Locate the `plugins` folder in your CS2 dedicated server (`/game/csgo/addons/cou
     └── HelloWorldPlugin.pdb
 ```
 
-:::caution
-If you have installed external nuget packages for your plugin, you may need to include their respective `.dll`s. For example, if you utilize the `Stateless` C# library, include `stateless.dll` in your `HelloWorld` plugin directory.
-:::
+> [!CAUTION]
+> If you have installed external nuget packages for your plugin, you may need to include their respective `.dll`s. For example, if you utilize the `Stateless` C# library, include `stateless.dll` in your `HelloWorld` plugin directory.
 
-:::note
-Note that some of these dependencies may change depending on the version of CounterStrikeSharp being used.
-:::
+> [!NOTE]
+> Note that some of these dependencies may change depending on the version of CounterStrikeSharp being used.
 
 ### Start the Server
 
 Now start your CS2 dedicated server. Just before the `CounterStrikeSharp.API Loaded Successfully.` message you should see your `Hello World!` console write that we called from the load function, neat!
 
-:::note[Hot Reloading!]
-By default, CounterStrikeSharp will automatically hot reload your plugin if you replace the .dll file in your plugin folder. When it does so, it will call the `Unload` and `Load` functions respectively, with the `hotReload` flag set to true.
-
-It is worth noting that the framework will automatically deregister any event handlers or listeners for you automatically, so you can safely reregister these on load without checking this flag. However you may want to do some specific actions on a hot reload, which you can do in your `Load()` call by checking the flag!
-:::
+> [!NOTE]
+> By default, CounterStrikeSharp will automatically hot reload your plugin if you replace the .dll file in your plugin folder. When it does so, it will call the `Unload` and `Load` functions respectively, with the `hotReload` flag set to true.
+> 
+> It is worth noting that the framework will automatically deregister any event handlers or listeners for you automatically, so you can safely reregister these on load without checking this flag. However you may want to do some specific actions on a hot reload, which you can do in your `Load()` call by checking the flag!

docfx/docs/guides/toc.yml

@@ -0,0 +1,8 @@
+- name: Getting Started
+  href: getting-started.md
+
+- name: Hello World Plugin
+  href: hello-world-plugin.md
+
+- name: Dependency Injection
+  href: dependency-injection.md

docfx/docs/reference/core-configuration.md

@@ -3,6 +3,10 @@ title: Core Configuration
 description: Summary for core configuration values
 ---
 
+# Core Configuration
+
+Summary for core configuration values
+
 ## PublicChatTrigger
 
 List of characters to use for public chat triggers.
@@ -21,9 +25,9 @@ Enabling this option will block plugins from using functionality that is known t
 This option only has any effect on CS2. Note that this does NOT guarantee that you cannot
 receive a ban.
 
-:::note
-Disable this option at your own risk.
-:::
+> [!NOTE]
+> Disable this option at your own risk.
+
 
 ## PluginHotReloadEnabled
 

docfx/docs/reference/referencing-players.md

@@ -3,6 +3,10 @@ title: Referencing Players
 description: Difference between player slots, indexes, userids, controllers & pawns.
 ---
 
+# Referencing Players
+
+Difference between player slots, indexes, userids, controllers & pawns.
+
 ## Controllers & Pawns
 
 All players in CS2 are split between a player controller & a player pawn. The player controller represents the player on the server, and the player pawn represents the players physical character in the game world. This means to edit a players health for example, you would need to edit their `PlayerPawn`'s health; but to check for a player's SteamID, you would check the `PlayerController`.
@@ -44,13 +48,12 @@ var player = Utilities.GetPlayerFromIndex(index);
 var player = Utilities.GetPlayerFromSlot(slot);
 ```
 
-:::note[Entity Safety]
-Wherever possible, you should check the validity of any handle you are accessing before assuming it is safe to use. 
-```csharp
-RegisterEventHandler<EventPlayerSpawn>((@event, info) =>
-{
-    if (!@event.Userid.IsValid) return 0; // Checks that the PlayerController is valid
-    if (!@event.Userid.PlayerPawn.IsValid) return 0; // Checks that the value of the CHandle is pointing to a valid PlayerPawn.
-}
-```
-:::
+> [!NOTE]
+> Wherever possible, you should check the validity of any handle you are accessing before assuming it is safe to use. 
+> ```csharp
+> RegisterEventHandler<EventPlayerSpawn>((@event, info) =>
+> {
+>     if (!@event.Userid.IsValid) return 0; // Checks that the PlayerController is valid
+>     if (!@event.Userid.PlayerPawn.IsValid) return 0; // Checks that the value of the CHandle is pointing to a valid PlayerPawn.
+> }
+> ```

docfx/docs/reference/toc.yml

@@ -0,0 +1,5 @@
+- name: Core Configuration
+  href: core-configuration.md
+
+- name: Referencing Players
+  href: referencing-players.md

docfx/docs/toc.yml

@@ -0,0 +1,16 @@
+items:
+  - name: Guides
+    href: guides/toc.yml
+    expanded: true
+
+  - name: Features
+    href: features/toc.yml
+    expanded: true
+
+  - name: Admin Framework
+    href: admin-framework/toc.yml
+    expanded: true
+
+  - name: Reference
+    href: reference/toc.yml
+    expanded: true

docfx/examples/HelloWorld.md

@@ -0,0 +1,5 @@
+[!INCLUDE [HelloWorld](../../examples/HelloWorld/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/HelloWorld" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/HelloWorld/HelloWorldPlugin.cs)]

docfx/examples/WarcraftPlugin.md

@@ -0,0 +1,13 @@
+# Warcraft Plugin
+
+This Warcraft plugin is migrated from the previous VSP.NET project to give you an idea of the kind of power this scripting runtime is capable of.
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WarcraftPlugin" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+## Demonstrated
+- Hook events
+- Create commands
+- Use third party libraries
+  - SQLite
+- Entity manipulation
+

docfx/examples/WithCommands.md

@@ -0,0 +1,5 @@
+[!INCLUDE [WithCommands](../../examples/WithCommands/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WithCommands" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/WithCommands/WithCommandsPlugin.cs)]

docfx/examples/WithConfig.md

@@ -0,0 +1,5 @@
+[!INCLUDE [WithConfig](../../examples/WithConfig/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WithConfig" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/WithConfig/WithConfigPlugin.cs)]

docfx/examples/WithDatabase.md

@@ -0,0 +1,5 @@
+[!INCLUDE [Database](../../examples/WithDatabaseDapper/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WithDatabaseDapper" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/WithDatabaseDapper/WithDatabaseDapperPlugin.cs)]

docfx/examples/WithDependencyInjection.md

@@ -0,0 +1,5 @@
+[!INCLUDE [WithDependencyInjection](../../examples/WithDependencyInjection/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WithDependencyInjection" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/WithDependencyInjection/WithDependencyInjectionPlugin.cs)]

docfx/examples/WithGameEventHandlers.md

@@ -0,0 +1,5 @@
+[!INCLUDE [WithGameEventHandlers](../../examples/WithGameEventHandlers/README.md)]
+
+<a href="https://github.com/roflmuffin/CounterStrikeSharp/tree/main/examples/WithGameEventHandlers" class="btn btn-secondary">View project on Github <i class="bi bi-github"></i></a>
+
+[!code-csharp[](../../examples/WithGameEventHandlers/WithGameEventHandlersPlugin.cs)]

docfx/examples/toc.yml

@@ -0,0 +1,15 @@
+items:
+  - name: Hello World
+    href: HelloWorld.md
+  - name: Commands
+    href: WithCommands.md
+  - name: Config
+    href: WithConfig.md
+  - name: Dependency Injection
+    href: WithDependencyInjection.md
+  - name: Game Event Handlers
+    href: WithGameEventHandlers.md
+  - name: Database (Dapper)
+    href: WithDatabase.md
+  - name: Warcraft Plugin
+    href: WarcraftPlugin.md

docfx/filterConfig.yml

@@ -0,0 +1,4 @@
+apiRules:
+- exclude:
+    uidRegex: ^System\.Object
+    type: Type

docfx/images/cssharp.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="50" height="50" viewBox="0 0 13.229 13.229"><path d="M9.91 0 4.881.039c-.545.004-1.073.02-1.577.057A6.957 6.957 0 0 0 .403.934c-.233.124-.403.338-.403.6a.652.652 0 0 0 .98.563l.004-.002a5.434 5.434 0 0 1 2.098-.66c2.123-.227 3.599.534 4.595 1.428 1.095.982 2.108 2.982 1.74 5.175-.22 1.313-.826 2.42-1.77 3.28l-.002.002c-.171.156-.312.337-.312.568a.674.674 0 0 0 1.1.52c.027-.02.058-.049.073-.063a7.327 7.327 0 0 0 1.76-2.566l2.679-6.357c.126-.287.232-.583.265-.871.142-1.26-.531-1.985-1.383-2.32-.436-.172-1.05-.224-1.72-.23L9.91 0Zm.725.802c.476.02.94.363.88.99-.073.758-.83 1.287-1.16 1.785h1.16c.07.102.07.433 0 .535-.583-.057-1.233-.047-1.874-.045-.274-1.001 1.42-1.674 1.249-2.498-.081-.389-.636-.4-.536.179h-.669c-.012-.663.475-.966.95-.946Z" style="display:inline;opacity:1;fill:#ff6000;fill-opacity:1;stroke-width:.0470931" transform="translate(0 .334)"/><g style="display:inline"><path fill="#a179dc" d="M7.52 5.702a.743.743 0 0 0-.09-.374.715.715 0 0 0-.272-.264C6.16 4.489 5.163 3.916 4.167 3.34a.734.734 0 0 0-.796.008C2.974 3.583.987 4.72.395 5.064a.692.692 0 0 0-.363.638V9.17c0 .139.03.26.088.367.06.109.15.2.275.27.592.344 2.579 1.482 2.976 1.717a.735.735 0 0 0 .796.007c.996-.575 1.995-1.148 2.992-1.723a.713.713 0 0 0 .275-.271.747.747 0 0 0 .087-.367V5.702"/><path fill="#280068" d="M3.788 7.424.12 9.538c.06.109.15.2.275.27.592.344 2.579 1.482 2.976 1.717a.735.735 0 0 0 .796.007c.996-.575 1.995-1.148 2.992-1.723a.713.713 0 0 0 .275-.271L3.788 7.424"/><path fill="#390091" d="M7.52 5.702a.743.743 0 0 0-.09-.374L3.787 7.425l3.646 2.112a.748.748 0 0 0 .087-.367V5.702"/><path fill="#fff" d="M5.948 6.635v.395h.395v-.395h.197v.395h.395v.197H6.54v.395h.395v.198H6.54v.394h-.197V7.82h-.395v.394H5.75V7.82h-.395v-.198h.395v-.395h-.395V7.03h.395v-.395Zm.395.592h-.395v.395h.395z"/><path fill="#fff" d="M3.796 4.652c1.03 0 1.93.56 2.41 1.39l-.004-.007-1.212.698a1.385 1.385 0 0 0-1.178-.683h-.016a1.386 1.386 0 1 0 1.208 2.066l-.006.01 1.21.7a2.783 2.783 0 0 1-2.38 1.394h-.032a2.784 2.784 0 1 1 0-5.568z"/></g></svg>

docfx/index.md

@@ -0,0 +1,23 @@
+---
+_layout: landing
+uid: home
+title: CounterStrikeSharp
+_appTitle: ''
+description: Write Counter-Strike 2 server plugins in C#.
+---
+
+<div class="row justify-content-md-center">
+  <div class="col-12 col-lg-10 col-xl-8 col-xxl-6">
+    <div class="text-center">
+      <img src="images/cssharp.svg" height="128" width="128">
+      <h1 class="h1">CounterStrikeSharp</h1>
+      <span>CounterStrikeSharp is a simpler way to write CS2 server plugins.</span>
+      <div>
+        <a href="docs/guides/getting-started.md" class="btn btn-primary btn-lg fw-bold my-5">Get Started <i class="bi bi-arrow-right"></a>
+      </div>
+    </div>
+
+[!code-csharp[](../examples/HelloWorld/HelloWorldPlugin.cs)]
+
+  </div>
+</div>

docfx/layouts/cssharp/layout/_master.tmpl

@@ -0,0 +1,152 @@
+{{!Licensed to the .NET Foundation under one or more agreements. The .NET Foundation licenses this file to you under the MIT license.}}
+{{!include(/^public/.*/)}}
+{{!include(favicon.ico)}}
+{{!include(logo.svg)}}
+<!DOCTYPE html>
+<html {{#_lang}}lang="{{_lang}}"{{/_lang}}>
+  <head>
+    <meta charset="utf-8">
+    {{#redirect_url}}
+      <meta http-equiv="refresh" content="0;URL='{{redirect_url}}'">
+    {{/redirect_url}}
+    {{^redirect_url}}
+      <title>{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}</title>
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <meta name="title" content="{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}">
+      {{#_description}}<meta name="description" content="{{_description}}">{{/_description}}
+      <link rel="icon" href="{{_rel}}{{{_appFaviconPath}}}{{^_appFaviconPath}}favicon.ico{{/_appFaviconPath}}">
+      <link rel="stylesheet" href="{{_rel}}public/docfx.min.css">
+      <link rel="stylesheet" href="{{_rel}}public/main.css">
+      <meta name="docfx:navrel" content="{{_navRel}}">
+      <meta name="docfx:tocrel" content="{{_tocRel}}">
+      {{#_noindex}}<meta name="searchOption" content="noindex">{{/_noindex}}
+      {{#_enableSearch}}<meta name="docfx:rel" content="{{_rel}}">{{/_enableSearch}}
+      {{#_disableNewTab}}<meta name="docfx:disablenewtab" content="true">{{/_disableNewTab}}
+      {{#_disableTocFilter}}<meta name="docfx:disabletocfilter" content="true">{{/_disableTocFilter}}
+      {{#docurl}}<meta name="docfx:docurl" content="{{docurl}}">{{/docurl}}
+      <meta name="loc:inThisArticle" content="{{__global.inThisArticle}}">
+      <meta name="loc:searchResultsCount" content="{{__global.searchResultsCount}}">
+      <meta name="loc:searchNoResults" content="{{__global.searchNoResults}}">
+      <meta name="loc:tocFilter" content="{{__global.tocFilter}}">
+      <meta name="loc:nextArticle" content="{{__global.nextArticle}}">
+      <meta name="loc:prevArticle" content="{{__global.prevArticle}}">
+      <meta name="loc:themeLight" content="{{__global.themeLight}}">
+      <meta name="loc:themeDark" content="{{__global.themeDark}}">
+      <meta name="loc:themeAuto" content="{{__global.themeAuto}}">
+      <meta name="loc:changeTheme" content="{{__global.changeTheme}}">
+      <meta name="loc:copy" content="{{__global.copy}}">
+      <meta name="loc:downloadPdf" content="{{__global.downloadPdf}}">
+    {{/redirect_url}}
+      <script data-goatcounter="https://cssharp.goatcounter.com/count" async src="//gc.zgo.at/count.js"></script>
+      <link rel="preconnect" href="https://fonts.googleapis.com">
+      <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+      <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100;0,9..40,200;0,9..40,300;0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700;0,9..40,800;0,9..40,900;0,9..40,1000;1,9..40,100;1,9..40,200;1,9..40,300;1,9..40,400;1,9..40,500;1,9..40,600;1,9..40,700;1,9..40,800;1,9..40,900;1,9..40,1000&family=JetBrains+Mono:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800&display=swap" rel="stylesheet">
+  </head>
+
+  {{^redirect_url}}
+  <script type="module" src="./{{_rel}}public/docfx.min.js"></script>
+
+  <script>
+    const theme = localStorage.getItem('theme') || 'auto'
+    document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
+  </script>
+
+  {{#_googleAnalyticsTagId}}
+  <script async src="https://www.googletagmanager.com/gtag/js?id={{_googleAnalyticsTagId}}"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag() { dataLayer.push(arguments); }
+    gtag('js', new Date());
+    gtag('config', '{{_googleAnalyticsTagId}}');
+  </script>
+  {{/_googleAnalyticsTagId}}
+
+  <body class="tex2jax_ignore" data-layout="{{_layout}}{{layout}}" data-yaml-mime="{{yamlmime}}">
+    <header class="bg-body border-bottom">
+      <nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
+        <div class="container-xxl flex-nowrap">
+          <a class="navbar-brand" href="{{_appLogoUrl}}{{^_appLogoUrl}}{{_rel}}index.html{{/_appLogoUrl}}">
+            <img id="logo" class="svg" src="{{_rel}}{{{_appLogoPath}}}{{^_appLogoPath}}logo.svg{{/_appLogoPath}}" alt="{{_appName}}" >
+            {{_appName}}
+          </a>
+          <button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation">
+            <i class="bi bi-three-dots"></i>
+          </button>
+          <div class="collapse navbar-collapse" id="navpanel">
+            <div id="navbar">
+              {{#_enableSearch}}
+              <form class="search" role="search" id="search">
+                <i class="bi bi-search"></i>
+                <input class="form-control" id="search-query" type="search" disabled placeholder="{{__global.search}}" autocomplete="off" aria-label="Search">
+              </form>
+              {{/_enableSearch}}
+            </div>
+          </div>
+        </div>
+      </nav>
+    </header>
+
+    <main class="container-xxl">
+      <div class="toc-offcanvas">
+        <div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
+          <div class="offcanvas-header">
+            <h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
+            <button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
+          </div>
+          <div class="offcanvas-body">
+            <nav class="toc" id="toc"></nav>
+          </div>
+        </div>
+      </div>
+
+      <div class="content">
+        <div class="actionbar">
+          <button class="btn btn-lg border-0 d-md-none" style="margin-top: -.65em; margin-left: -.8em"
+              type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas"
+              aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
+            <i class="bi bi-list"></i>
+          </button>
+
+          <nav id="breadcrumb"></nav>
+        </div>
+
+        <article data-uid="{{uid}}">
+          {{!body}}
+        </article>
+
+        {{^_disableContribution}}
+        <div class="contribution d-print-none">
+          {{#sourceurl}}
+          <a href="{{sourceurl}}" class="edit-link">{{__global.improveThisDoc}}</a>
+          {{/sourceurl}}
+          {{^sourceurl}}{{#docurl}}
+          <a href="{{docurl}}" class="edit-link">{{__global.improveThisDoc}}</a>
+          {{/docurl}}{{/sourceurl}}
+        </div>
+        {{/_disableContribution}}
+
+        {{^_disableNextArticle}}
+        <div class="next-article d-print-none border-top" id="nextArticle"></div>
+        {{/_disableNextArticle}}
+
+      </div>
+
+      <div class="affix">
+        <nav id="affix"></nav>
+      </div>
+    </main>
+
+    {{#_enableSearch}}
+    <div class="container-xxl search-results" id="search-results"></div>
+    {{/_enableSearch}}
+
+    <footer class="border-top text-secondary">
+      <div class="container-xxl">
+        <div class="flex-fill">
+          {{{_appFooter}}}{{^_appFooter}}<span>Made with <a href="https://dotnet.github.io/docfx">docfx</a></span>{{/_appFooter}}
+        </div>
+      </div>
+    </footer>
+  </body>
+  {{/redirect_url}}
+</html>

docfx/layouts/cssharp/public/main.css

@@ -0,0 +1,4 @@
+:root {
+    --bs-font-sans-serif: "DM Sans", system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+    --bs-font-monospace: "Jetbrains Mono", SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+}

docfx/layouts/cssharp/public/main.js

@@ -0,0 +1,14 @@
+export default {
+  iconLinks: [
+    {
+      icon: "github",
+      href: "https://github.com/roflmuffin/CounterStrikeSharp",
+      title: "GitHub",
+    },
+    {
+      icon: "discord",
+      href: "https://discord.gg/X7r3PmuYKq",
+      title: "Discord",
+    },
+  ],
+};

docfx/toc.yml

@@ -0,0 +1,6 @@
+- name: Docs
+  href: docs/
+- name: Examples
+  href: examples/
+- name: API
+  href: api/

docs/.gitignore

@@ -1,21 +0,0 @@
-# build output
-dist/
-# generated types
-.astro/
-
-# dependencies
-node_modules/
-
-# logs
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-
-# environment variables
-.env
-.env.production
-
-# macOS-specific files
-.DS_Store

docs/.prettierrc

@@ -1,6 +0,0 @@
-{
-  "trailingComma": "es5",
-  "tabWidth": 2,
-  "semi": true,
-  "singleQuote": true
-}

docs/astro.config.mjs

@@ -1,61 +0,0 @@
-import { defineConfig } from 'astro/config';
-import starlight from '@astrojs/starlight';
-
-// https://astro.build/config
-export default defineConfig({
-  integrations: [
-    starlight({
-      title: 'CounterStrikeSharp Docs',
-      customCss: [
-        '@fontsource/dm-sans/400.css',
-        '@fontsource/dm-sans/500.css',
-        '@fontsource/dm-sans/700.css',
-        '@fontsource/jetbrains-mono/400.css',
-        '@fontsource/jetbrains-mono/600.css',
-        './src/styles/custom.css',
-      ],
-      head: [
-        {
-          tag: 'script',
-          attrs: {
-            src: 'https://gc.zgo.at/count.js',
-            'data-goatcounter': 'https://cssharp.goatcounter.com/count',
-            async: true,
-          },
-        },
-      ],
-      social: {
-        github: 'https://github.com/roflmuffin/CounterStrikeSharp',
-      },
-      sidebar: [
-        {
-          label: 'Guides',
-          autogenerate: { directory: 'guides' },
-        },
-        {
-          label: 'Features',
-          autogenerate: { directory: 'features' },
-        },
-        {
-          label: 'Admin Framework',
-          autogenerate: { directory: 'admin-framework' },
-        },
-        {
-          label: 'Reference',
-          autogenerate: { directory: 'reference' },
-        },
-      ],
-      editLink: {
-        baseUrl:
-          'https://github.com/roflmuffin/CounterStrikeSharp/edit/main/docs/',
-      },
-    }),
-  ],
-  base: '/',
-  site: 'https://docs.cssharp.dev',
-  markdown: {
-    shikiConfig: {
-      wrap: false,
-    },
-  },
-});

docs/package.json

@@ -1,22 +0,0 @@
-{
-  "name": "",
-  "type": "module",
-  "version": "0.0.1",
-  "scripts": {
-    "dev": "astro dev",
-    "start": "astro dev",
-    "build": "astro build",
-    "preview": "astro preview",
-    "astro": "astro"
-  },
-  "dependencies": {
-    "@astrojs/starlight": "^0.11.1",
-    "@fontsource/dm-sans": "^5.0.15",
-    "@fontsource/jetbrains-mono": "^5.0.15",
-    "astro": "^3.2.3",
-    "sharp": "^0.32.5"
-  },
-  "devDependencies": {
-    "prettier": "^3.0.3"
-  }
-}

docs/src/content/config.ts

@@ -1,7 +0,0 @@
-import { defineCollection } from 'astro:content';
-import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
-
-export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
-  i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
-};

docs/src/content/docs/index.mdx

@@ -1,52 +0,0 @@
----
-title: CounterStrikeSharp
-description: Write Counter-Strike 2 server plugins in C#.
-template: splash
-hero:
-  tagline: <code class="csharp">CounterStrikeSharp</code> is a simpler way to write CS2 server plugins.
-  actions:
-    - text: Get started
-      link: ./guides/getting-started/
-      icon: right-arrow
-      variant: primary
-    - text: Browse source
-      link: https://github.com/roflmuffin/CounterStrikeSharp/
-      icon: github
----
-
-```csharp
-using CounterStrikeSharp.API.Core;
-
-namespace HelloWorldPlugin;
-
-public class HelloWorldPlugin : BasePlugin
-{
-    public override string ModuleName => "Hello World Plugin";
-
-    public override string ModuleVersion => "0.0.1";
-
-    public override string ModuleAuthor => "roflmuffin";
-
-    public override string ModuleDescription => "Simple hello world plugin";
-
-    public override void Load(bool hotReload)
-    {
-        Logger.LogInformation("Plugin loaded successfully!");
-    }
-
-    [GameEventHandler]
-    public HookResult OnPlayerConnect(EventPlayerConnect @event, GameEventInfo info)
-    {
-        // Userid will give you a reference to a CCSPlayerController class
-        Logger.LogInformation("Player {Name} has connected!", @event.Userid.PlayerName);
-
-        return HookResult.Continue;
-    }
-
-    [ConsoleCommand("issue_warning", "Issue warning to player")]
-    public void OnCommand(CCSPlayerController? player, CommandInfo command)
-    {
-        Logger.LogWarning("Player shouldn't be doing that");
-    }
-}
-```

docs/src/env.d.ts

@@ -1,2 +0,0 @@
-/// <reference path="../.astro/types.d.ts" />
-/// <reference types="astro/client" />

docs/src/styles/custom.css

@@ -1,19 +0,0 @@
-:root {
-  --sl-font: 'DM Sans', serif;
-  --sl-font-mono: 'Jetbrains Mono', monospace;
-}
-
-.hero {
-  grid-template-columns: 1fr;
-}
-
-.hero .copy {
-  align-items: center;
-}
-
-.hero .actions {
-  justify-content: center;
-}
-
-.hero {
-}

docs/tsconfig.json

@@ -1,3 +0,0 @@
-{
-  "extends": "astro/tsconfigs/strict"
-}

examples/WithConfig/README.md

@@ -1,2 +1,2 @@
-# WithConfig
+# With Config
 This example shows how you can implement the `IPluginConfig` interface to allow for semi-automatic config parsing & loading.

examples/WithDatabaseDapper/README.md

@@ -0,0 +1,2 @@
+# With Database (Dapper)
+Simple SQLite database example using Dapper library to track kills.

examples/WithDatabaseDapper/WithDatabaseDapper.csproj

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+    <PropertyGroup>
+        <TargetFramework>net7.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
+        <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+    </PropertyGroup>
+    <ItemGroup>
+      <ProjectReference Include="..\..\managed\CounterStrikeSharp.API\CounterStrikeSharp.API.csproj" />
+    </ItemGroup>
+    <ItemGroup>
+      <PackageReference Include="Dapper" Version="2.1.24" />
+      <PackageReference Include="Microsoft.Data.Sqlite" Version="7.0.14" />
+    </ItemGroup>
+</Project>

examples/WithDatabaseDapper/WithDatabaseDapperPlugin.cs

@@ -0,0 +1,89 @@
+using CounterStrikeSharp.API;
+using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Core.Attributes;
+using CounterStrikeSharp.API.Core.Attributes.Registration;
+using CounterStrikeSharp.API.Modules.Commands;
+using Dapper;
+using Microsoft.Data.Sqlite;
+using Microsoft.Extensions.Logging;
+
+namespace WithDatabaseDapper;
+
+[MinimumApiVersion(80)]
+public class WithDatabaseDapperPlugin : BasePlugin
+{
+    public override string ModuleName => "Example: With Database (Dapper)";
+    public override string ModuleVersion => "1.0.0";
+    public override string ModuleAuthor => "CounterStrikeSharp & Contributors";
+    public override string ModuleDescription => "A plugin that reads and writes from the database.";
+
+    private SqliteConnection _connection = null!;
+
+    public override void Load(bool hotReload)
+    {
+        Logger.LogInformation("Loading database from {Path}", Path.Join(ModuleDirectory, "database.db"));
+        _connection = new SqliteConnection($"Data Source={Path.Join(ModuleDirectory, "database.db")}");
+        _connection.Open();
+
+        // Create the table if it doesn't exist
+        // Run in a separate thread to avoid blocking the main thread
+        Task.Run(async () =>
+        {
+            await _connection.ExecuteAsync(@"
+                CREATE TABLE IF NOT EXISTS `players` (
+	                `steamid` UNSIGNED BIG INT NOT NULL,
+	                `kills` INT NOT NULL DEFAULT 0,
+	                PRIMARY KEY (`steamid`));");
+        });
+    }
+
+    [GameEventHandler]
+    public HookResult OnPlayerKilled(EventPlayerDeath @event, GameEventInfo info)
+    {
+        // Don't count suicides.
+        if (@event.Attacker == @event.Userid) return HookResult.Continue;
+
+        // Capture the steamid of the player as `@event` will not be available outside of this function.
+        var steamId = @event.Attacker.AuthorizedSteamID?.SteamId64;
+
+        if (steamId == null) return HookResult.Continue;
+
+        // Run in a separate thread to avoid blocking the main thread
+        Task.Run(async () =>
+        {
+            // insert or update the player's kills
+            await _connection.ExecuteAsync(@"
+                INSERT INTO `players` (`steamid`, `kills`) VALUES (@SteamId, 1)
+                ON CONFLICT(`steamid`) DO UPDATE SET `kills` = `kills` + 1;",
+                new
+                {
+                    SteamId = steamId
+                });
+        });
+
+        return HookResult.Continue;
+    }
+
+    [ConsoleCommand("css_kills", "Get count of kills for a player")]
+    public void OnKillsCommand(CCSPlayerController? player, CommandInfo commandInfo)
+    {
+        if (player == null) return;
+
+        // Capture the SteamID of the player as `@event` will not be available outside of this function.
+        var steamId = player.AuthorizedSteamID.SteamId64;
+
+        // Run in a separate thread to avoid blocking the main thread
+        Task.Run(async () =>
+        {
+            var result = await _connection.QueryFirstOrDefaultAsync(@"SELECT `kills` FROM `players` WHERE `steamid` = @SteamId;",
+                new
+                {
+                    SteamId = steamId
+                });
+
+            // Print the result to the player's chat. Note that this needs to be run on the game thread.
+            // So we use `Server.NextFrame` to run it on the next game tick.
+            Server.NextFrame(() => { player.PrintToChat($"Kills: {result?.kills ?? 0}"); });
+        });
+    }
+}

managed/CounterStrikeSharp.API/Core/API.cs

@@ -157,6 +157,30 @@ namespace CounterStrikeSharp.API.Core
 			}
 		}
 
+        public static string GetClientConvarValue(int clientindex, string convarname){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(clientindex);
+			ScriptContext.GlobalScriptContext.Push(convarname);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0xAE4B1B79);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			return (string)ScriptContext.GlobalScriptContext.GetResult(typeof(string));
+			}
+		}
+
+        public static void SetFakeClientConvarValue(int clientindex, string convarname, string convarvalue){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(clientindex);
+			ScriptContext.GlobalScriptContext.Push(convarname);
+			ScriptContext.GlobalScriptContext.Push(convarvalue);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0x4C61E8BB);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			}
+		}
+
         public static T DynamicHookGetReturn<T>(IntPtr hook, int datatype){
 			lock (ScriptContext.GlobalScriptContext.Lock) {
 			ScriptContext.GlobalScriptContext.Reset();
@@ -455,6 +479,16 @@ namespace CounterStrikeSharp.API.Core
 			}
 		}
 
+        public static void QueueTaskForNextWorldUpdate(IntPtr callback){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(callback);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0xAD51A0C9);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			}
+		}
+
         public static IntPtr GetValveInterface(int interfacetype, string interfacename){
 			lock (ScriptContext.GlobalScriptContext.Lock) {
 			ScriptContext.GlobalScriptContext.Reset();
@@ -598,6 +632,28 @@ namespace CounterStrikeSharp.API.Core
 			}
 		}
 
+        public static ulong GetPlayerAuthorizedSteamid(int slot){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(slot);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0xD1F30B3B);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			return (ulong)ScriptContext.GlobalScriptContext.GetResult(typeof(ulong));
+			}
+		}
+
+        public static string GetPlayerIpAddress(int slot){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(slot);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0x46A45CB0);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			return (string)ScriptContext.GlobalScriptContext.GetResult(typeof(string));
+			}
+		}
+
         public static void HookEvent(string name, InputArgument callback, bool ispost){
 			lock (ScriptContext.GlobalScriptContext.Lock) {
 			ScriptContext.GlobalScriptContext.Reset();
@@ -1031,6 +1087,16 @@ namespace CounterStrikeSharp.API.Core
 			}
 		}
 
+        public static bool IsServerPaused(){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.SetIdentifier(0xB216AAAC);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			return (bool)ScriptContext.GlobalScriptContext.GetResult(typeof(bool));
+			}
+		}
+
         public static IntPtr CreateTimer(float interval, InputArgument callback, int flags){
 			lock (ScriptContext.GlobalScriptContext.Lock) {
 			ScriptContext.GlobalScriptContext.Reset();

managed/CounterStrikeSharp.API/Core/Listeners.g.cs

@@ -126,5 +126,26 @@ namespace CounterStrikeSharp.API.Core
         /// <param name="hostname">New hostname of the server</param>
         [ListenerName("OnHostNameChanged")]
         public delegate void OnHostNameChanged(string hostname);
+
+        /// <summary>
+        /// Called before the server enters fatal shutdown.
+        /// </summary>
+        [ListenerName("OnPreFatalShutdown")]
+        public delegate void OnServerPreFatalShutdown();
+
+        /// <summary>
+        /// Called when the server is in a loading stage.
+        /// </summary>
+        /// <param name="frameTime"></param>
+        [ListenerName("OnUpdateWhenNotInGame")]
+        public delegate void OnUpdateWhenNotInGame(float frameTime);
+
+        /// <summary>
+        /// Called before the world updates.
+        /// This seems to be called even when the server is hibernating.
+        /// </summary>
+        /// <param name="simulating"><see langword="true"/> if simulating, <see langword="false"/> otherwise</param>
+        [ListenerName("OnServerPreWorldUpdate")]
+        public delegate void OnServerPreWorldUpdate(bool simulating);
     }
 }

managed/CounterStrikeSharp.API/Core/Model/CCSPlayerController.cs

@@ -1,4 +1,7 @@
 using System;
+
+using CounterStrikeSharp.API.Modules.Cvars;
+using CounterStrikeSharp.API.Modules.Entities;
 using CounterStrikeSharp.API.Modules.Entities.Constants;
 using CounterStrikeSharp.API.Modules.Memory;
 using CounterStrikeSharp.API.Modules.Utils;
@@ -49,13 +52,15 @@ public partial class CCSPlayerController
     {
         VirtualFunctions.ClientPrint(this.Handle, HudDestination.Center, message, 0, 0, 0, 0);
     }
+
+    public void PrintToCenterHtml(string message) => PrintToCenterHtml(message, 5);
     
-    public void PrintToCenterHtml(string message)
+    public void PrintToCenterHtml(string message, int duration)
     {
         var @event = new EventShowSurvivalRespawnStatus(true)
         {
             LocToken = message,
-            Duration = 5,
+            Duration = duration,
             Userid = this
         };
         @event.FireEventToClient(this);
@@ -139,6 +144,57 @@ public partial class CCSPlayerController
             team);
     }
 
+    /// <summary>
+    /// Get a ConVar value for given player
+    /// </summary>
+    /// <param name="conVar">Name of the convar to retrieve</param>
+    /// <returns>ConVar string value</returns>
+    public string GetConVarValue(string conVar)
+    {
+        return NativeAPI.GetClientConvarValue(this.Slot, conVar);
+    }
+
+    public string GetConVarValue(ConVar? conVar)
+    {
+        if (conVar == null)
+        {
+            throw new Exception("Invalid convar passed to 'GetConVarValue'");
+        }
+
+        return GetConVarValue(conVar.Name);
+    }
+
+    /// <summary>
+    /// Sets a ConVar value on a fake client (bot).
+    /// </summary>
+    /// <param name="conVar">Console variable name</param>
+    /// <param name="value">String value to set</param>
+    /// <exception cref="InvalidOperationException">Player is not a bot</exception>
+    public void SetFakeClientConVar(string conVar, string value)
+    {
+        if (!IsBot)
+        {
+            throw new InvalidOperationException("'SetFakeClientConVar' can only be called for fake clients (bots)");
+        }
+
+        NativeAPI.SetFakeClientConvarValue(this.Slot, conVar, value);
+    }
+
+    /// <summary>
+    /// <inheritdoc cref="SetFakeClientConVar(string,string)"/>
+    /// </summary>
+    /// <exception cref="ArgumentException"><paramref name="conVar"/> is <see langword="null"/></exception>
+    /// <inheritdoc cref="SetFakeClientConVar(string,string)" select="exception"/>
+    public void SetFakeClientConVar(ConVar conVar, string value)
+    {
+        if (conVar == null)
+        {
+            throw new ArgumentException("Invalid convar passed to 'SetFakeClientConVar'");
+        }
+
+        SetFakeClientConVar(conVar.Name, value);
+    }
+
     /// <summary>
     /// Gets the active pawns button state. Will work even if the player is dead or observing.
     /// </summary>
@@ -147,4 +203,35 @@ public partial class CCSPlayerController
     public void ExecuteClientCommand(string command) => NativeAPI.IssueClientCommand(Slot, command);
 
     public int Slot => (int)Index - 1;
+
+    /// <summary>
+    /// Returns the authorized SteamID of this user which has been validated with the SteamAPI.
+    /// </summary>
+    public SteamID? AuthorizedSteamID
+    {
+        get
+        {
+            if (!this.IsValid) return null;
+            var authorizedSteamId = NativeAPI.GetPlayerAuthorizedSteamid(this.Slot);
+            if ((long)authorizedSteamId == -1) return null;
+
+            return (SteamID)authorizedSteamId;
+        }
+    }
+    
+    /// <summary>
+    /// Returns the IP address (and possibly port) of this player.
+    /// <remarks>Returns 127.0.0.1 if the player is a bot.</remarks>
+    /// </summary>
+    public string? IpAddress
+    {
+        get
+        {
+            if (!this.IsValid) return null;
+            var ipAddress = NativeAPI.GetPlayerIpAddress(this.Slot);
+            if (string.IsNullOrWhiteSpace(ipAddress)) return null;
+
+            return ipAddress;
+        }
+    }
 }

managed/CounterStrikeSharp.API/Core/Model/CEntityInstance.cs

@@ -36,12 +36,12 @@ public partial class CEntityInstance : IEquatable<CEntityInstance>
     
     public bool Equals(CEntityInstance? other)
     {
-        return this.EntityHandle == other?.EntityHandle;
+        return this.EntityHandle.Equals(other?.EntityHandle);
     }
 
     public override bool Equals(object? obj)
     {
-        return ReferenceEquals(this, obj) || obj is CEntityInstance other && Equals(other);
+        return obj is CEntityInstance other && Equals(other);
     }
 
     public override int GetHashCode()

managed/CounterStrikeSharp.API/Core/Plugin/PluginContext.cs

@@ -73,11 +73,14 @@ namespace CounterStrikeSharp.API.Core.Plugin
 
                 _fileWatcher.Deleted += async (s, e) =>
                 {
-                    if (e.FullPath == path)
+                    Server.NextWorldUpdate(() =>
                     {
-                        _logger.LogInformation("Plugin {Name} has been deleted, unloading...", Plugin.ModuleName);
-                        Unload(true);
-                    }
+                        if (e.FullPath == path)
+                        {
+                            _logger.LogInformation("Plugin {Name} has been deleted, unloading...", Plugin.ModuleName);
+                            Unload(true);
+                        }
+                    });
                 };
 
                 _fileWatcher.Filter = "*.dll";
@@ -88,11 +91,14 @@ namespace CounterStrikeSharp.API.Core.Plugin
 
         private Task OnReloadedAsync(object sender, PluginReloadedEventArgs eventargs)
         {
-            _logger.LogInformation("Reloading plugin {Name}", Plugin.ModuleName);
-            Loader = eventargs.Loader;
-            Unload(hotReload: true);
-            Load(hotReload: true);
-
+            Server.NextWorldUpdate(() =>
+            {
+                _logger.LogInformation("Reloading plugin {Name}", Plugin.ModuleName);
+                Loader = eventargs.Loader;
+                Unload(hotReload: true);
+                Load(hotReload: true);
+            });
+            
             return Task.CompletedTask;
         }
 

managed/CounterStrikeSharp.API/Modules/Admin/AdminGroup.cs

@@ -94,7 +94,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             // The server console should have access to all commands, regardless of groups.
             if (player == null) return true;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
-            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            var playerData = GetPlayerAdminData((SteamID)player.AuthorizedSteamID);
             return playerData?.Groups.IsSupersetOf(groups) ?? false;
         }
 
@@ -119,7 +119,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
         {
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
-            AddPlayerToGroup((SteamID)player.SteamID, groups);
+            AddPlayerToGroup((SteamID)player.AuthorizedSteamID, groups);
         }
 
         /// <summary>
@@ -161,7 +161,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
         {
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
-            RemovePlayerFromGroup((SteamID)player.SteamID, true, groups);
+            RemovePlayerFromGroup((SteamID)player.AuthorizedSteamID, true, groups);
         }
 
         /// <summary>

managed/CounterStrikeSharp.API/Modules/Admin/AdminPermissions.cs

@@ -102,7 +102,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             // The server console should have access to all commands, regardless of permissions.
             if (player == null) return true;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
-            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            var playerData = GetPlayerAdminData(player.AuthorizedSteamID);
             return playerData?.Flags.IsSupersetOf(flags) ?? false;
         }
 
@@ -136,7 +136,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             // The server console should have access to all commands, regardless of permissions.
             if (player == null) return true;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
-            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            var playerData = GetPlayerAdminData((SteamID)player.AuthorizedSteamID);
             return playerData?.CommandOverrides.ContainsKey(command) ?? false;
         }
 
@@ -165,7 +165,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             // The server console should have access to all commands, regardless of permissions.
             if (player == null) return true;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
-            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            var playerData = GetPlayerAdminData((SteamID)player.AuthorizedSteamID);
             return playerData?.CommandOverrides.GetValueOrDefault(command) ?? false;
         }
 
@@ -193,7 +193,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             // The server console should have access to all commands, regardless of permissions.
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
-            SetPlayerCommandOverride((SteamID)player.SteamID, command, state);
+            SetPlayerCommandOverride((SteamID)player.AuthorizedSteamID, command, state);
         }
 
         /// <summary>
@@ -235,7 +235,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
         {
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
-            AddPlayerPermissions((SteamID)player.SteamID, flags);
+            AddPlayerPermissions((SteamID)player.AuthorizedSteamID, flags);
         }
         
         /// <summary>
@@ -278,7 +278,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
 
-            RemovePlayerPermissions((SteamID)player.SteamID, flags);
+            RemovePlayerPermissions((SteamID)player.AuthorizedSteamID, flags);
         }
 
         /// <summary>
@@ -306,7 +306,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
 
-            ClearPlayerPermissions((SteamID)player.SteamID);
+            ClearPlayerPermissions((SteamID)player.AuthorizedSteamID);
         }
 
         /// <summary>
@@ -335,7 +335,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
 
-            SetPlayerImmunity((SteamID)player.SteamID, value);
+            SetPlayerImmunity((SteamID)player.AuthorizedSteamID, value);
         }
 
         /// <summary>
@@ -366,10 +366,10 @@ namespace CounterStrikeSharp.API.Modules.Admin
             if (target == null) return false;
             if (!target.IsValid || target.Connected != PlayerConnectedState.PlayerConnected) return false;
 
-            var callerData = GetPlayerAdminData((SteamID)caller.SteamID);
+            var callerData = GetPlayerAdminData((SteamID)caller.AuthorizedSteamID);
             if (callerData == null) return false;
 
-            var targetData = GetPlayerAdminData((SteamID)target.SteamID);
+            var targetData = GetPlayerAdminData((SteamID)target.AuthorizedSteamID);
             if (targetData == null) return true;
 
             return callerData.Immunity >= targetData.Immunity;

managed/CounterStrikeSharp.API/Modules/Admin/BaseRequiresPermissions.cs

@@ -31,7 +31,8 @@ namespace CounterStrikeSharp.API.Modules.Admin
         {
             // If we have a command in the "command_overrides" section in "configs/admins.json",
             // we skip the checks below and just return the defined value.
-            var adminData = AdminManager.GetPlayerAdminData((SteamID)caller.SteamID);
+            if (caller?.AuthorizedSteamID == null) return false;
+            var adminData = AdminManager.GetPlayerAdminData(caller.AuthorizedSteamID);
             if (adminData == null) return false;
             if (adminData.CommandOverrides.ContainsKey(Command))
             {

managed/CounterStrikeSharp.API/Modules/Admin/RequiresPermissionsOr.cs

@@ -23,7 +23,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             var groupPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.GroupPermissionChar));
             var userPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.UserPermissionChar));
 
-            var adminData = AdminManager.GetPlayerAdminData((SteamID)caller.SteamID);
+            var adminData = AdminManager.GetPlayerAdminData(caller.AuthorizedSteamID);
             if (adminData == null) return false;
             return (groupPermissions.Intersect(adminData.Groups).Count() + userPermissions.Intersect(adminData.Flags).Count()) > 0;
         }

managed/CounterStrikeSharp.API/Modules/Entities/Constants/SteamAccountInstance.cs

@@ -0,0 +1,32 @@
+namespace CounterStrikeSharp.API.Modules.Entities.Constants;
+
+/// <summary>
+/// Represents the instance types for a Steam account.
+/// </summary>
+public enum SteamAccountInstance
+{
+    /// <summary>
+    /// Invalid instance.
+    /// </summary>
+    Invalid = -1,
+
+    /// <summary>
+    /// All instances.
+    /// </summary>
+    All = 0,
+
+    /// <summary>
+    /// Desktop instance.
+    /// </summary>
+    Desktop = 1,
+
+    /// <summary>
+    /// Console instance.
+    /// </summary>
+    Console = 2,
+
+    /// <summary>
+    /// Web instance.
+    /// </summary>
+    Web = 4
+}

managed/CounterStrikeSharp.API/Modules/Entities/Constants/SteamAccountType.cs

@@ -0,0 +1,70 @@
+using System.Runtime.Serialization;
+
+namespace CounterStrikeSharp.API.Modules.Entities.Constants;
+
+/// <summary>
+/// Represents the types of Steam accounts.
+/// </summary>
+public enum SteamAccountType
+{
+    /// <summary>
+    /// Invalid account type.
+    /// </summary>
+    [EnumMember(Value = "I")]
+    Invalid = 0,
+    /// <summary>
+    /// Individual account type.
+    /// </summary>
+    [EnumMember(Value = "U")]
+    Individual,
+    /// <summary>
+    /// MultiSeat account type.
+    /// </summary>
+    [EnumMember(Value = "M")]
+    MultiSeat,
+    /// <summary>
+    /// Game Server account type.
+    /// </summary>
+    [EnumMember(Value = "G")]
+    GameServer,
+    /// <summary>
+    /// Anonymous Game Server account type.
+    /// </summary>
+    [EnumMember(Value = "A")]
+    AnonGameServer,
+    /// <summary>
+    /// Pending account type.
+    /// </summary>
+    [EnumMember(Value = "P")]
+    Pending,
+    /// <summary>
+    /// Content Server account type.
+    /// </summary>
+    [EnumMember(Value = "C")]
+    ContentServer,
+    /// <summary>
+    /// Clan account type.
+    /// </summary>
+    [EnumMember(Value = "g")]
+    Clan,
+    /// <summary>
+    /// Chat account type.
+    /// </summary>
+    [EnumMember(Value = "T")]
+    Chat,
+    /// <summary>
+    /// Console user account type.
+    /// </summary>
+    [EnumMember(Value = "c")]
+    ConsoleUser,
+    /// <summary>
+    /// P2P Super Seeder account type.
+    /// </summary>
+    [EnumMember(Value = " ")]
+    P2PSuperSeeder,
+    /// <summary>
+    /// Anonymous user account type.
+    /// </summary>
+    [EnumMember(Value = "a")]
+    AnonUser,
+}

managed/CounterStrikeSharp.API/Modules/Entities/Constants/SteamAccountUniverse.cs

@@ -0,0 +1,32 @@
+namespace CounterStrikeSharp.API.Modules.Entities.Constants;
+
+/// <summary>
+/// Represents the universe of a Steam account.
+/// </summary>
+public enum SteamAccountUniverse
+{
+    /// <summary>
+    /// Individual / unspecified universe.
+    /// </summary>
+    Unspecified = 0,
+
+    /// <summary>
+    /// Public universe.
+    /// </summary>
+    Public = 1,
+
+    /// <summary>
+    /// Beta universe.
+    /// </summary>
+    Beta = 2,
+
+    /// <summary>
+    /// Internal universe.
+    /// </summary>
+    Internal = 3,
+
+    /// <summary>
+    /// Development universe.
+    /// </summary>
+    Dev = 4,
+}

managed/CounterStrikeSharp.API/Modules/Entities/SteamID.cs

@@ -1,4 +1,5 @@
-using System;
+using CounterStrikeSharp.API.Modules.Entities.Constants;
+using CounterStrikeSharp.API.Modules.Utils;
 
 namespace CounterStrikeSharp.API.Modules.Entities
 {
@@ -12,6 +13,7 @@ namespace CounterStrikeSharp.API.Modules.Entities
 
         public static explicit operator SteamID(ulong u) => new(u);
         public static explicit operator SteamID(string s) => new(s);
+
         ulong ParseId(string id)
         {
             var parts = id.Split(':');
@@ -34,7 +36,7 @@ namespace CounterStrikeSharp.API.Modules.Entities
 
         public string SteamId3
         {
-            get => $"[U:1:{SteamId64 - Base}]";
+            get => $"[{EnumUtils.GetEnumMemberAttributeValue(AccountType)}:{(int)AccountUniverse}:{SteamId64 - Base}]";
             set => SteamId64 = ParseId3(value);
         }
         
@@ -44,20 +46,54 @@ namespace CounterStrikeSharp.API.Modules.Entities
             set => SteamId64 = (ulong)value + Base;
         }
 
+        public int AccountId => (int)((SteamId64 >> 0) & 0xFFFFFFFF);
+
+        public SteamAccountInstance AccountInstance => 
+            (SteamAccountInstance)((SteamId64 >> 32) & 0xFFFFF);
+ 
+        public SteamAccountType AccountType => 
+            (SteamAccountType)((SteamId64 >> 52) & 0xF);
+
+        public SteamAccountUniverse AccountUniverse => 
+            (SteamAccountUniverse)((SteamId64 >> 56) & 0xF);
+
+        public bool IsValid()
+        {
+            if (AccountUniverse == SteamAccountUniverse.Unspecified 
+                || AccountType == SteamAccountType.Invalid 
+                || AccountInstance == SteamAccountInstance.Invalid)
+                return false;
+            if (AccountType == SteamAccountType.Individual 
+                && (AccountId == 0 || AccountInstance != SteamAccountInstance.Desktop))
+                return false;
+            if (AccountType == SteamAccountType.Clan 
+                && (AccountId == 0 || AccountInstance != SteamAccountInstance.All))
+                return false;
+            if (AccountType == SteamAccountType.GameServer && AccountId == 0)
+                return false;
+            return true;
+        }
+
         public override string ToString() => $"[SteamID {SteamId64}, {SteamId2}, {SteamId3}]";
 
+        public Uri ToCommunityUrl()
+        {
+            string url = string.Empty;
+            if (AccountType == SteamAccountType.Individual)
+                url = "https://steamcommunity.com/profiles/" + SteamId64;
+            if (AccountType == SteamAccountType.Clan)
+                url = "https://steamcommunity.com/gid/" + SteamId64;
+            return new Uri(url);
+        }
+
         public bool Equals(SteamID? other)
         {
-            if (ReferenceEquals(null, other)) return false;
-            if (ReferenceEquals(this, other)) return true;
-            return SteamId64 == other.SteamId64;
+            return other != null && SteamId64 == other.SteamId64;
         }
 
         public override bool Equals(object? obj)
         {
-            if (ReferenceEquals(null, obj)) return false;
-            if (ReferenceEquals(this, obj)) return true;
-            if (obj.GetType() != this.GetType()) return false;
+            if (obj?.GetType() != this.GetType()) return false;
             return Equals((SteamID)obj);
         }
         

managed/CounterStrikeSharp.API/Modules/Memory/VirtualFunctionVoid.cs

@@ -94,7 +94,7 @@ public partial class VirtualFunctionVoid<TArg1, TArg2, TArg3>
     {
         this.Function = VirtualFunction.CreateVoid<TArg1, TArg2, TArg3>(signature);
     }
-    
+
     public VirtualFunctionVoid(string signature, string binarypath)
     {
         this.Function = VirtualFunction.CreateVoid<TArg1, TArg2, TArg3>(signature, binarypath);

managed/CounterStrikeSharp.API/Modules/Memory/VirtualFunctionWithReturn.cs

@@ -99,7 +99,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TResult>
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TResult>(signature, binarypath);
@@ -124,7 +124,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TResu
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TResult>(signature, binarypath);
@@ -149,7 +149,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TResult>(signature, binarypath);
@@ -174,7 +174,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TResult>(signature, binarypath);
@@ -199,7 +199,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TResult>(signature, binarypath);
@@ -224,7 +224,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TResult>(signature, binarypath);
@@ -249,7 +249,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TArg9, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TArg9, TResult>(signature, binarypath);
@@ -274,7 +274,7 @@ public partial class VirtualFunctionWithReturn<TArg1, TArg2, TArg3, TArg4, TArg5
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TArg9, TArg10, TResult>(signature);
     }
-    
+
     public VirtualFunctionWithReturn(string signature, string binarypath)
     {
         this.Function = VirtualFunction.Create<TArg1, TArg2, TArg3, TArg4, TArg5, TArg6, TArg7, TArg8, TArg9, TArg10, TResult>(signature, binarypath);

managed/CounterStrikeSharp.API/Modules/Utils/CHandle.cs

@@ -62,17 +62,12 @@ public class CHandle<T> : IEquatable<CHandle<T>> where T : NativeEntity
 
     public bool Equals(CHandle<T>? other)
     {
-        if (ReferenceEquals(null, other)) return false;
-        if (ReferenceEquals(this, other)) return true;
-        return Raw == other.Raw;
+        return other != null && Raw == other.Raw;
     }
 
     public override bool Equals(object? obj)
     {
-        if (ReferenceEquals(null, obj)) return false;
-        if (ReferenceEquals(this, obj)) return true;
-        if (obj.GetType() != this.GetType()) return false;
-        return Equals((CHandle<T>)obj);
+        return Equals(obj as CHandle<T>);
     }
 
     public override int GetHashCode()

managed/CounterStrikeSharp.API/Server.cs

@@ -45,12 +45,28 @@ namespace CounterStrikeSharp.API
         // Currently only used to keep the delegate from being garbage collected
         private static List<Action> nextFrameTasks = new List<Action>();
 
+        /// <summary>
+        /// Queue a task to be executed on the next game frame.
+        /// <remarks>Does not execute if the server is hibernating.</remarks>
+        /// </summary>
         public static void NextFrame(Action task)
         {
             nextFrameTasks.Add(task);
             var ptr = Marshal.GetFunctionPointerForDelegate(task);
             NativeAPI.QueueTaskForNextFrame(ptr);
         }
+        
+        /// <summary>
+        /// Queue a task to be executed on the next pre world update.
+        /// <remarks>Executes if the server is hibernating.</remarks>
+        /// </summary>
+        /// <param name="task"></param>
+        public static void NextWorldUpdate(Action task)
+        {
+            nextFrameTasks.Add(task);
+            var ptr = Marshal.GetFunctionPointerForDelegate(task);
+            NativeAPI.QueueTaskForNextWorldUpdate(ptr);
+        }
 
         public static void PrintToChatAll(string message)
         {

managed/CounterStrikeSharp.API/Utilities.cs

@@ -67,7 +67,7 @@ namespace CounterStrikeSharp.API
 
         public static CCSPlayerController? GetPlayerFromSteamId(ulong steamId)
         {
-            return Utilities.GetPlayers().FirstOrDefault(player => player.SteamID == steamId);
+            return Utilities.GetPlayers().FirstOrDefault(player => player.AuthorizedSteamID == (SteamID)steamId);
         }
 
         public static TargetResult ProcessTargetString(string pattern, CCSPlayerController player)

managed/CounterStrikeSharp.sln

@@ -22,6 +22,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WithCommands", "..\examples
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WithGameEventHandlers", "..\examples\WithGameEventHandlers\WithGameEventHandlers.csproj", "{3032F3FA-E20A-4581-9A08-2FB5FF1524F4}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WithDatabaseDapper", "..\examples\WithDatabaseDapper\WithDatabaseDapper.csproj", "{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -68,6 +70,10 @@ Global
 		{3032F3FA-E20A-4581-9A08-2FB5FF1524F4}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{3032F3FA-E20A-4581-9A08-2FB5FF1524F4}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{3032F3FA-E20A-4581-9A08-2FB5FF1524F4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(NestedProjects) = preSolution
 		{57E64289-5D69-4AA1-BEF0-D0D96A55EE8F} = {7DF99C35-881D-4FF2-B1C9-246BD3DECB9A}
@@ -77,5 +83,6 @@ Global
 		{E497E40C-A7B4-41A7-A1C6-2EC6698FF3BF} = {7DF99C35-881D-4FF2-B1C9-246BD3DECB9A}
 		{EA2F596E-2236-4999-B476-B1FDA287674A} = {7DF99C35-881D-4FF2-B1C9-246BD3DECB9A}
 		{3032F3FA-E20A-4581-9A08-2FB5FF1524F4} = {7DF99C35-881D-4FF2-B1C9-246BD3DECB9A}
+		{A641D8D7-35F1-48AB-AABA-EDFB6B7FC49B} = {7DF99C35-881D-4FF2-B1C9-246BD3DECB9A}
 	EndGlobalSection
 EndGlobal

src/core/globals.cpp

@@ -78,6 +78,7 @@ ChatManager chatManager;
 ServerManager serverManager;
 
 GetLegacyGameEventListener_t* GetLegacyGameEventListener = nullptr;
+std::thread::id gameThreadId;
 
 void Initialize()
 {

src/core/globals.h

@@ -6,6 +6,8 @@
 #undef protected
 #undef private
 
+#include <thread>
+
 #include "ISmmAPI.h"
 #include "eiface.h"
 #include "iserver.h"
@@ -107,6 +109,7 @@ extern CGameConfig* gameConfig;
 typedef IGameEventListener2 *GetLegacyGameEventListener_t(CPlayerSlot slot);
 
 extern GetLegacyGameEventListener_t* GetLegacyGameEventListener;
+extern std::thread::id gameThreadId;
 
 void Initialize();
 // Should only be called within the active game loop (i e map should be loaded

src/core/managers/event_manager.cpp

@@ -103,7 +103,6 @@ bool EventManager::HookEvent(const char* szName, CallbackT fnCallback, bool bPos
     } else {
         if (!pHook->m_pPreHook) {
             pHook->m_pPreHook = globals::callbackManager.CreateCallback("");
-            ;
         }
 
         pHook->m_pPreHook->AddListener(fnCallback);
@@ -130,18 +129,17 @@ bool EventManager::UnhookEvent(const char* szName, CallbackT fnCallback, bool bP
         pCallback = pHook->m_pPreHook;
     }
 
-    // Remove from function list
-    if (pCallback == nullptr) {
-        return false;
-    }
+    pCallback->RemoveListener(fnCallback);
 
-    if (bPost) {
-        pHook->m_pPostHook = nullptr;
-    } else {
-        pHook->m_pPreHook = nullptr;
-    }
+    if (pCallback->GetFunctionCount() == 0) {
+        globals::callbackManager.ReleaseCallback(pCallback);
 
-    // TODO: Clean up callback if theres noone left attached.
+        if (bPost) {
+            pHook->m_pPostHook = nullptr;
+        } else {
+            pHook->m_pPreHook = nullptr;
+        }
+    }
 
     CSSHARP_CORE_TRACE("Unhooking event: {0} with callback pointer: {1}", szName, (void*)fnCallback);
 

src/core/managers/player_manager.cpp

@@ -38,6 +38,7 @@
 #include <sourcehook/sourcehook.h>
 
 #include "core/log.h"
+#include "core/timer_system.h"
 #include "scripting/callback_manager.h"
 #include <iplayerinfo.h>
 // extern CEntitySystem *g_pEntitySystem;
@@ -303,9 +304,9 @@ int PlayerManager::NumPlayers() const { return m_player_count; }
 
 int PlayerManager::MaxClients() const { return m_max_clients; }
 
-CPlayer* PlayerManager::GetPlayerByIndex(int client) const
+CPlayer* PlayerManager::GetPlayerBySlot(int client) const
 {
-    if (client > m_max_clients || client < 1) {
+    if (client > m_max_clients || client < 0) {
         return nullptr;
     }
 
@@ -434,11 +435,11 @@ PlayerManager::PlayerManager()
 
 void PlayerManager::RunAuthChecks()
 {
-    if (globals::getGlobalVars()->curtime - m_last_auth_check_time < 0.5F) {
+    if (globals::timerSystem.GetTickedTime() - m_last_auth_check_time < 0.5F) {
         return;
     }
 
-    m_last_auth_check_time = globals::getGlobalVars()->curtime;
+    m_last_auth_check_time = globals::timerSystem.GetTickedTime();
 
     for (int i = 0; i <= m_max_clients; i++) {
         if (m_players[i].IsConnected()) {

src/core/managers/player_manager.h

@@ -151,7 +151,7 @@ public:
 public:
     int NumPlayers() const;
     int MaxClients() const;
-    CPlayer *GetPlayerByIndex(int client) const;
+    CPlayer *GetPlayerBySlot(int client) const;
     CPlayer *GetClientOfUserId(int user_id) const;
 
 private:

src/core/managers/server_manager.cpp

@@ -23,6 +23,9 @@ SH_DECL_HOOK1_void(ISource2Server, ServerHibernationUpdate, SH_NOATTRIB, 0, bool
 SH_DECL_HOOK0_void(ISource2Server, GameServerSteamAPIActivated, SH_NOATTRIB, 0);
 SH_DECL_HOOK0_void(ISource2Server, GameServerSteamAPIDeactivated, SH_NOATTRIB, 0);
 SH_DECL_HOOK1_void(ISource2Server, OnHostNameChanged, SH_NOATTRIB, 0, const char*);
+SH_DECL_HOOK0_void(ISource2Server, PreFatalShutdown, const, 0);
+SH_DECL_HOOK1_void(ISource2Server, UpdateWhenNotInGame, SH_NOATTRIB, 0, float);
+SH_DECL_HOOK1_void(ISource2Server, PreWorldUpdate, SH_NOATTRIB, 0, bool);
 
 namespace counterstrikesharp {
 
@@ -39,11 +42,20 @@ void ServerManager::OnAllInitialized() {
                 SH_MEMBER(this, &ServerManager::GameServerSteamAPIDeactivated), true);
     SH_ADD_HOOK(ISource2Server, OnHostNameChanged, globals::server,
                 SH_MEMBER(this, &ServerManager::OnHostNameChanged), true);
+    SH_ADD_HOOK(ISource2Server, PreFatalShutdown, globals::server,
+                SH_MEMBER(this, &ServerManager::PreFatalShutdown), true);
+    SH_ADD_HOOK(ISource2Server, UpdateWhenNotInGame, globals::server,
+                SH_MEMBER(this, &ServerManager::UpdateWhenNotInGame), true);
+    SH_ADD_HOOK(ISource2Server, PreWorldUpdate, globals::server,
+                SH_MEMBER(this, &ServerManager::PreWorldUpdate), true);
 
     on_server_hibernation_update_callback = globals::callbackManager.CreateCallback("OnServerHibernationUpdate");
     on_server_steam_api_activated_callback = globals::callbackManager.CreateCallback("OnGameServerSteamAPIActivated");
     on_server_steam_api_deactivated_callback = globals::callbackManager.CreateCallback("OnGameServerSteamAPIDeactivated");
     on_server_hostname_changed_callback = globals::callbackManager.CreateCallback("OnHostNameChanged");
+    on_server_pre_fatal_shutdown = globals::callbackManager.CreateCallback("OnPreFatalShutdown");
+    on_server_update_when_not_in_game = globals::callbackManager.CreateCallback("OnUpdateWhenNotInGame");
+    on_server_pre_world_update = globals::callbackManager.CreateCallback("OnServerPreWorldUpdate");
 }
 
 void ServerManager::OnShutdown() {
@@ -55,11 +67,20 @@ void ServerManager::OnShutdown() {
                 SH_MEMBER(this, &ServerManager::GameServerSteamAPIDeactivated), true);
     SH_REMOVE_HOOK(ISource2Server, OnHostNameChanged, globals::server,
                 SH_MEMBER(this, &ServerManager::OnHostNameChanged), true);
+    SH_REMOVE_HOOK(ISource2Server, PreFatalShutdown, globals::server,
+                SH_MEMBER(this, &ServerManager::PreFatalShutdown), true);
+    SH_REMOVE_HOOK(ISource2Server, UpdateWhenNotInGame, globals::server,
+                SH_MEMBER(this, &ServerManager::UpdateWhenNotInGame), true);
+    SH_REMOVE_HOOK(ISource2Server, PreWorldUpdate, globals::server,
+                SH_MEMBER(this, &ServerManager::PreWorldUpdate), true);
 
     globals::callbackManager.ReleaseCallback(on_server_hibernation_update_callback);
     globals::callbackManager.ReleaseCallback(on_server_steam_api_activated_callback);
     globals::callbackManager.ReleaseCallback(on_server_steam_api_deactivated_callback);
     globals::callbackManager.ReleaseCallback(on_server_hostname_changed_callback);
+    globals::callbackManager.ReleaseCallback(on_server_pre_fatal_shutdown);
+    globals::callbackManager.ReleaseCallback(on_server_update_when_not_in_game);
+    globals::callbackManager.ReleaseCallback(on_server_pre_world_update);
 }
 
 void* ServerManager::GetEconItemSystem()
@@ -67,6 +88,11 @@ void* ServerManager::GetEconItemSystem()
     return globals::server->GetEconItemSystem();
 }
 
+bool ServerManager::IsPaused()
+{
+    return globals::server->IsPaused();
+}
+
 void ServerManager::ServerHibernationUpdate(bool bHibernating)
 {
     CSSHARP_CORE_TRACE("Server hibernation update {0}", bHibernating);
@@ -117,4 +143,58 @@ void ServerManager::OnHostNameChanged(const char *pHostname)
     }
 }
 
+void ServerManager::PreFatalShutdown()
+{
+    CSSHARP_CORE_TRACE("Pre fatal shutdown");
+
+    auto callback = globals::serverManager.on_server_pre_fatal_shutdown;
+
+    if (callback && callback->GetFunctionCount()) {
+        callback->ScriptContext().Reset();
+        callback->Execute();
+    }
+}
+
+void ServerManager::UpdateWhenNotInGame(float flFrameTime)
+{
+    CSSHARP_CORE_TRACE("Update when not in game {}", flFrameTime);
+
+    auto callback = globals::serverManager.on_server_update_when_not_in_game;
+
+    if (callback && callback->GetFunctionCount()) {
+        callback->ScriptContext().Reset();
+        callback->ScriptContext().Push(flFrameTime);
+        callback->Execute();
+    }
+}
+
+void ServerManager::PreWorldUpdate(bool bSimulating)
+{
+    std::lock_guard<std::mutex> lock(m_nextWorldUpdateTasksLock);
+
+    if (!m_nextWorldUpdateTasks.empty()) {
+        CSSHARP_CORE_TRACE("Executing queued tasks of size: {0} at time {1}", m_nextWorldUpdateTasks.size(),
+                       globals::getGlobalVars()->curtime);
+
+        for (size_t i = 0; i < m_nextWorldUpdateTasks.size(); i++) {
+            m_nextWorldUpdateTasks[i]();
+        }
+
+        m_nextWorldUpdateTasks.clear();
+    }
+
+    auto callback = globals::serverManager.on_server_pre_world_update;
+
+    if (callback && callback->GetFunctionCount()) {
+        callback->ScriptContext().Reset();
+        callback->ScriptContext().Push(bSimulating);
+        callback->Execute();
+    }
+}
+
+void ServerManager::AddTaskForNextWorldUpdate(std::function<void()>&& task)
+{
+    std::lock_guard<std::mutex> lock(m_nextWorldUpdateTasksLock);
+    m_nextWorldUpdateTasks.push_back(std::forward<decltype(task)>(task));
+}
 }  // namespace counterstrikesharp

src/core/managers/server_manager.h

@@ -30,17 +30,29 @@ public:
     void OnAllInitialized() override;
     void OnShutdown() override;
     void* GetEconItemSystem();
+    bool IsPaused();
+    void AddTaskForNextWorldUpdate(std::function<void()> &&task);
 
 private:
     void ServerHibernationUpdate(bool bHibernating);
     void GameServerSteamAPIActivated();
     void GameServerSteamAPIDeactivated();
     void OnHostNameChanged(const char *pHostname);
+    void PreFatalShutdown();
+    void UpdateWhenNotInGame(float flFrameTime);
+    void PreWorldUpdate(bool bSimulating);
+
 
     ScriptCallback *on_server_hibernation_update_callback;
     ScriptCallback *on_server_steam_api_activated_callback;
     ScriptCallback *on_server_steam_api_deactivated_callback;
     ScriptCallback *on_server_hostname_changed_callback;
+    ScriptCallback *on_server_pre_fatal_shutdown;
+    ScriptCallback *on_server_update_when_not_in_game;
+    ScriptCallback *on_server_pre_world_update;
+
+    std::vector<std::function<void()>> m_nextWorldUpdateTasks;
+    std::mutex m_nextWorldUpdateTasksLock;
 };
 
 }  // namespace counterstrikesharp

src/mm_plugin.cpp

@@ -41,6 +41,17 @@ DLL_EXPORT void InvokeNative(counterstrikesharp::fxNativeContext& context)
     if (context.nativeIdentifier == 0)
         return;
 
+    if (context.nativeIdentifier != counterstrikesharp::hash_string_const("QUEUE_TASK_FOR_NEXT_FRAME") &&
+        context.nativeIdentifier != counterstrikesharp::hash_string_const("QUEUE_TASK_FOR_NEXT_WORLD_UPDATE") &&
+        counterstrikesharp::globals::gameThreadId != std::this_thread::get_id())
+    {
+        counterstrikesharp::ScriptContextRaw scriptContext(context);
+        scriptContext.ThrowNativeError("Invoked on a non-main thread");
+
+        CSSHARP_CORE_CRITICAL("Native {:x} was invoked on a non-main thread", context.nativeIdentifier);
+        return;
+    }
+
     counterstrikesharp::ScriptEngine::InvokeNative(context);
 }
 
@@ -67,6 +78,7 @@ bool CounterStrikeSharpMMPlugin::Load(PluginId id, ISmmAPI* ismm, char* error, s
 {
     PLUGIN_SAVEVARS();
     globals::ismm = ismm;
+    globals::gameThreadId = std::this_thread::get_id();
 
     Log::Init();
 
@@ -164,6 +176,8 @@ void CounterStrikeSharpMMPlugin::AllPluginsLoaded()
 
 void CounterStrikeSharpMMPlugin::AddTaskForNextFrame(std::function<void()>&& task)
 {
+   
+    std::lock_guard<std::mutex> lock(m_nextTasksLock);
     m_nextTasks.push_back(std::forward<decltype(task)>(task));
 }
 
@@ -177,6 +191,8 @@ void CounterStrikeSharpMMPlugin::Hook_GameFrame(bool simulating, bool bFirstTick
      */
     globals::timerSystem.OnGameFrame(simulating);
 
+    std::lock_guard<std::mutex> lock(m_nextTasksLock);
+
     if (m_nextTasks.empty())
         return;
 
@@ -225,4 +241,4 @@ const char* CounterStrikeSharpMMPlugin::GetURL()
 {
     return "https://github.com/roflmuffin/CounterStrikeSharp";
 }
-} // namespace counterstrikesharp
+} // namespace counterstrikesharp

src/mm_plugin.h

@@ -61,6 +61,7 @@ public:
 
 private:
     std::vector<std::function<void()>> m_nextTasks;
+    std::mutex m_nextTasksLock;
 };
 
 static ScriptCallback *on_activate_callback;

src/scripting/listeners/server.yaml

@@ -1,4 +1,7 @@
 OnServerHibernationUpdate: isHibernating:bool
 OnGameServerSteamAPIActivated:
 OnGameServerSteamAPIDeactivated:
-OnHostNameChanged: hostname:string
+OnHostNameChanged: hostname:string
+PreFatalShutdown:
+UpdateWhenNotInGame: frameTime:float
+PreWorldUpdate: simulating:bool

src/scripting/natives/natives_commands.cpp

@@ -124,6 +124,23 @@ static void IssueClientCommand(ScriptContext& script_context)
     globals::engine->ClientCommand(CPlayerSlot(entity_index), command);
 }
 
+static const char* GetClientConVarValue(ScriptContext& script_context)
+{
+    auto playerSlot = script_context.GetArgument<int>(0);
+    auto convarName = script_context.GetArgument<const char*>(1);
+
+    return globals::engine->GetClientConVarValue(CPlayerSlot(playerSlot), convarName);
+}
+
+static void SetFakeClientConVarValue(ScriptContext& script_context)
+{
+    auto playerSlot = script_context.GetArgument<int>(0);
+    auto convarName = script_context.GetArgument<const char*>(1);
+    auto convarValue = script_context.GetArgument<const char*>(2);
+
+    globals::engine->SetFakeClientConVarValue(CPlayerSlot(playerSlot), convarName, convarValue);
+}
+
 ConVar* FindConVar(ScriptContext& script_context)
 {
     auto name = script_context.GetArgument<const char*>(0);
@@ -163,5 +180,7 @@ REGISTER_NATIVES(commands, {
     ScriptEngine::RegisterNativeHandler("SET_CONVAR_STRING_VALUE", SetConVarStringValue);
 
     ScriptEngine::RegisterNativeHandler("ISSUE_CLIENT_COMMAND", IssueClientCommand);
+    ScriptEngine::RegisterNativeHandler("GET_CLIENT_CONVAR_VALUE", GetClientConVarValue);
+    ScriptEngine::RegisterNativeHandler("SET_FAKE_CLIENT_CONVAR_VALUE", SetFakeClientConVarValue);
 })
 } // namespace counterstrikesharp

src/scripting/natives/natives_commands.yaml

@@ -8,4 +8,6 @@ COMMAND_GET_COMMAND_STRING: command:pointer -> string
 COMMAND_GET_ARG_BY_INDEX: command:pointer,index:int -> string
 ISSUE_CLIENT_COMMAND: clientIndex:int,command:string -> void
 FIND_CONVAR: name:string -> pointer
-SET_CONVAR_STRING_VALUE: convar:pointer,value:string -> void
+SET_CONVAR_STRING_VALUE: convar:pointer,value:string -> void
+GET_CLIENT_CONVAR_VALUE: clientIndex:int,convarName:string -> string
+SET_FAKE_CLIENT_CONVAR_VALUE: clientIndex:int,convarName:string,convarValue:string -> void

src/scripting/natives/natives_engine.cpp

@@ -30,6 +30,7 @@
 #include "core/memory.h"
 #include "core/log.h"
 #include "core/function.h"
+#include "core/managers/server_manager.h"
 // clang-format on
 
 #if _WIN32
@@ -217,6 +218,14 @@ void QueueTaskForNextFrame(ScriptContext& script_context)
     globals::mmPlugin->AddTaskForNextFrame([func]() { reinterpret_cast<voidfunc*>(func)(); });
 }
 
+void QueueTaskForNextWorldUpdate(ScriptContext& script_context)
+{
+    auto func = script_context.GetArgument<void*>(0);
+
+    typedef void(voidfunc)(void);
+    globals::serverManager.AddTaskForNextWorldUpdate([func]() { reinterpret_cast<voidfunc*>(func)(); });
+}
+
 enum InterfaceType
 {
     Engine,
@@ -308,6 +317,7 @@ REGISTER_NATIVES(engine, {
     ScriptEngine::RegisterNativeHandler("TRACE_RAY", TraceRay);
     ScriptEngine::RegisterNativeHandler("GET_TICKED_TIME", GetTickedTime);
     ScriptEngine::RegisterNativeHandler("QUEUE_TASK_FOR_NEXT_FRAME", QueueTaskForNextFrame);
+    ScriptEngine::RegisterNativeHandler("QUEUE_TASK_FOR_NEXT_WORLD_UPDATE", QueueTaskForNextWorldUpdate);
     ScriptEngine::RegisterNativeHandler("GET_VALVE_INTERFACE", GetValveInterface);
     ScriptEngine::RegisterNativeHandler("GET_COMMAND_PARAM_VALUE", GetCommandParamValue);
     ScriptEngine::RegisterNativeHandler("PRINT_TO_SERVER_CONSOLE", PrintToServerConsole);

src/scripting/natives/natives_engine.yaml

@@ -21,6 +21,7 @@ TRACE_FILTER_PROXY_SET_SHOULD_HIT_ENTITY_CALLBACK: trace_filter:pointer, callbac
 NEW_TRACE_RESULT: -> pointer
 GET_TICKED_TIME: -> double
 QUEUE_TASK_FOR_NEXT_FRAME: callback:pointer -> void
+QUEUE_TASK_FOR_NEXT_WORLD_UPDATE: callback:pointer -> void
 GET_VALVE_INTERFACE: interfaceType:int, interfaceName:string -> pointer
 GET_COMMAND_PARAM_VALUE: param:string, dataType:DataType_t, defaultValue:any -> any
 PRINT_TO_SERVER_CONSOLE: msg:string -> void

src/scripting/natives/natives_entities.cpp

@@ -21,6 +21,8 @@
 #include "scripting/script_engine.h"
 #include "core/memory.h"
 #include "core/log.h"
+#include "core/managers/player_manager.h"
+
 #include <public/entity2/entitysystem.h>
 
 namespace counterstrikesharp {
@@ -114,6 +116,33 @@ void* GetConcreteEntityListPointer(ScriptContext& script_context) {
     return &globals::entitySystem->m_EntityList;
 }
 
+unsigned long GetPlayerAuthorizedSteamID(ScriptContext& script_context) {
+    auto iSlot = script_context.GetArgument<int>(0);
+
+    auto pPlayer = globals::playerManager.GetPlayerBySlot(iSlot);
+    if (pPlayer == nullptr || !pPlayer->m_is_authorized) {
+        return -1;
+    }
+
+    auto pSteamId = pPlayer->GetSteamId();
+    if (pSteamId == nullptr) {
+        return -1;
+    }
+
+    return pSteamId->ConvertToUint64();
+}
+
+const char* GetPlayerIpAddress(ScriptContext& script_context) {
+    auto iSlot = script_context.GetArgument<int>(0);
+
+    auto pPlayer = globals::playerManager.GetPlayerBySlot(iSlot);
+    if (pPlayer == nullptr) {
+        return nullptr;
+    }
+
+    return pPlayer->GetIpAddress();
+}
+
 REGISTER_NATIVES(entities, {
     ScriptEngine::RegisterNativeHandler("GET_ENTITY_FROM_INDEX", GetEntityFromIndex);
     ScriptEngine::RegisterNativeHandler("GET_USERID_FROM_INDEX", GetUserIdFromIndex);
@@ -126,5 +155,7 @@ REGISTER_NATIVES(entities, {
     ScriptEngine::RegisterNativeHandler("IS_REF_VALID_ENTITY", IsRefValidEntity);
     ScriptEngine::RegisterNativeHandler("PRINT_TO_CONSOLE", PrintToConsole);
     ScriptEngine::RegisterNativeHandler("GET_FIRST_ACTIVE_ENTITY", GetFirstActiveEntity);
+    ScriptEngine::RegisterNativeHandler("GET_PLAYER_AUTHORIZED_STEAMID", GetPlayerAuthorizedSteamID);
+    ScriptEngine::RegisterNativeHandler("GET_PLAYER_IP_ADDRESS", GetPlayerIpAddress);
 })
 }  // namespace counterstrikesharp

src/scripting/natives/natives_entities.yaml

@@ -7,4 +7,6 @@ GET_ENTITY_POINTER_FROM_REF: entityRef:uint -> pointer
 GET_CONCRETE_ENTITY_LIST_POINTER: -> pointer
 IS_REF_VALID_ENTITY: entityRef:uint -> bool
 PRINT_TO_CONSOLE: index:int, message:string -> void
-GET_FIRST_ACTIVE_ENTITY: -> pointer
+GET_FIRST_ACTIVE_ENTITY: -> pointer
+GET_PLAYER_AUTHORIZED_STEAMID: slot:int -> uint64
+GET_PLAYER_IP_ADDRESS: slot:int -> string

src/scripting/natives/natives_server.cpp

@@ -24,8 +24,14 @@ static void *GetEconItemSystem(ScriptContext& scriptContext) {
     return globals::serverManager.GetEconItemSystem();
 }
 
+static bool IsServerPaused(ScriptContext& scriptContext)
+{
+    return globals::serverManager.IsPaused();
+}
+
 REGISTER_NATIVES(server, {
     ScriptEngine::RegisterNativeHandler("GET_ECON_ITEM_SYSTEM", GetEconItemSystem);
+    ScriptEngine::RegisterNativeHandler("IS_SERVER_PAUSED", IsServerPaused);
 })
 
 }

src/scripting/natives/natives_server.yaml

@@ -1 +1,2 @@
-GET_ECON_ITEM_SYSTEM: -> pointer
+GET_ECON_ITEM_SYSTEM: -> pointer
+IS_SERVER_PAUSED: -> bool

src/scripting/script_engine.h

@@ -55,6 +55,18 @@ inline uint32_t hash_string(const char *string) {
     return result;
 }
 
+template<size_t N>
+constexpr uint32_t hash_string_const(char const (&string)[N])
+{
+    unsigned long result = 5381;
+
+    for (size_t i = 0; i < N-1; i++) {
+        result = ((result << 5) + result) ^ string[i];
+    }
+
+    return result;
+}
+
 struct fxNativeContext {
     int numArguments;
     int numResults;