Installation -
Sourcemod Plugin

Install and configure the Nexus Donate plugin for Source engine games

Overview

The Nexus Donate SourceMod plugin allows your Source engine game server (CS:GO, TF2, etc.) to communicate with your donation store and execute commands when players make purchases.

Prerequisites

  • Source engine game server (CS:GO, TF2, CS:S, etc.)
  • SourceMod installed and running
  • Server with internet access
  • Nexus Donate API key

1. Extracting the plugin

  1. Download the latest Nexus Donate SourceMod plugin
  2. Extract the plugin file to your server's addons/sourcemod/plugins/ directory
  3. The plugin file should be named nexus_donate.smx
  4. Ensure SourceMod is properly installed and running

2. Upload to your server and configure

After uploading the plugin, configure it by editing the addons/sourcemod/configs/nexus_donate.cfg file:

Code
// Nexus Donate Configuration

// Your Nexus Donate API Key

sm_nexus_donate_api_key "your_api_key_here"


// Your Nexus Donate Store URL

sm_nexus_donate_store_url "https://yourstore.com"


// Check interval in seconds

sm_nexus_donate_check_interval "30"


// Enable debug mode

sm_nexus_donate_debug "0"


// Server name

sm_nexus_donate_server_name "Your Server Name"

Configuration Options

  • sm_nexus_donate_api_key: Your Nexus Donate API key from the web panel
  • sm_nexus_donate_store_url: The URL of your Nexus Donate store
  • sm_nexus_donate_check_interval: How often the plugin checks for new donations (in seconds)
  • sm_nexus_donate_debug: Enable debug messages (1 = enabled, 0 = disabled)
  • sm_nexus_donate_server_name: Your server's display name

3. Reload The Plugin

  1. Use the command sm plugins reload nexus_donate to reload the plugin
  2. Alternatively, restart your server to load the plugin
  3. Check the server console for "Nexus Donate loaded successfully" message
  4. Look for any error messages related to the plugin

Verification

To verify the installation is working:

  1. Check the server console for successful plugin loading
  2. Use the command sm plugins list to see if Nexus Donate is listed
  3. Test the connection by making a test donation
  4. Check that commands execute properly when donations are processed

Commands

The plugin provides the following commands:

  • sm_nexus_donate_reload - Reload the plugin configuration
  • sm_nexus_donate_status - Check the plugin status and connection
  • sm_nexus_donate_test - Test the API connection

Permissions

The plugin uses the following permissions:

  • nexus_donate.admin - Access to admin commands
  • nexus_donate.status - Access to status commands

Troubleshooting

Common issues and solutions:

  • Plugin not loading: Check if SourceMod is properly installed
  • API connection failed: Verify your API key and store URL
  • No donations detected: Check the check interval and server connectivity
  • Commands not executing: Verify the command syntax and player permissions
Note: Make sure your server has internet access to communicate with the Nexus Donate API.