Installation

Step-by-step guide to installing Plugify as a Metamod plugin for Source 2 dedicated servers.

This guide will walk you through the installation process for MM-Loader on your server. Plugify requires Metamod to be installed as a loader on the server. Follow the steps below to get everything set up.

Prerequisites

Install Metamod

Metamod (> 2.0) is required for loading Plugify.

Installation Steps

Download Plugify

Download the latest version of MM-Loader from our download page:
MM-Loader Download.

Extract Plugify

Extract the downloaded archive into your server’s game folder. For example, if your server’s game folder is located at ../my_server/game/csgo, extract the files there.

After extraction, your folder structure should look like this:

Start/Restart the Server

After extracting the files, start or restart your server to apply the changes.

Validate the Installation

To ensure that Plugify has been installed correctly, open your server console and type the following command:

meta list

If you are not working directly on your server, use rcon to access the console. The output should look something like this:

meta list
Listing 1 plugin:
[01] Plugify (1.0.0.0) by untrustedmodders

Alternative Validation

You can also verify the installation by using the version command in the server console:

plg --version

This will display the current version of Plugify installed on your server.

Installing Plugins and Language Modules

After validating that Plugify is working correctly, you'll need to install plugins and language modules to start developing and running plugins.

Install Basic Source 2 Plugins

These are the essential plugins required for developing Source 2 plugins:

# Install C++ language module (required to run C++ plugins)
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-cpp/" plugify-module-cpp

# Install plugin configuration support
mamba install -n plugins -c "https://untrustedmodders.github.io/plugify-plugin-configs/" plugify-plugin-configs

# Install PolyHook for function hooking
mamba install -n plugins -c "https://untrustedmodders.github.io/plugify-plugin-polyhook/" plugify-plugin-polyhook

# Install Source 2 SDK plugin (provides Source 2 game functions)
mamba install -n plugins -c "https://untrustedmodders.github.io/plugify-plugin-s2sdk/" plugify-plugin-s2sdk

What these plugins do:

  • plugify-module-cpp: Language module that allows you to run C++ plugins
  • plugify-plugin-configs: Provides configuration file support for plugins
  • plugify-plugin-polyhook: Enables function hooking capabilities
  • plugify-plugin-s2sdk: Core plugin with many Source 2 engine functions and utilities

Install Additional Language Modules (Optional)

If you want to develop plugins in languages other than C++, install the corresponding language module:

# For C# plugins
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-dotnet/" plugify-module-dotnet

# For Python plugins
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-python3/" plugify-module-python3

# For JavaScript plugins
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-v8/" plugify-module-v8

# For Go plugins
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-golang/" plugify-module-golang

# For Lua plugins
mamba install -n modules -c "https://untrustedmodders.github.io/plugify-module-lua/" plugify-module-lua

Choose only the language modules you need for your development.

Verify Installed Plugins

Check that your plugins and modules are installed:

plg modules
plg plugins

This will show all installed plugins and their status.

Video Tutorial

TODO
A video tutorial will be added here soon to provide a visual guide for the installation process.

Troubleshooting

Common Issues

  1. Plugify Not Listed in meta list:
    • Ensure that the files were extracted to the correct directory.
    • Verify that Metamod is installed and functioning correctly.
  2. Server Crashes on Startup:
    • Check the server logs for any errors related to Plugify or Metamod.
    • Ensure that you are using compatible versions of Plugify, Metamod, and your game server.
  3. Commands Not Working:
    • Verify that Plugify is loaded by running meta list.
    • Ensure that the plugify command is available in your server console.