Sven Co-op Plugin Manager

Sven Co-op Plugin Manager — a small Windows GUI utility to view and manage Sven Co-op server plugin entries (enabled/disabled) stored in the game's plugin files.

Purpose

• Make it easy to inspect, enable/disable, and save plugin entries for Sven Co-op.
• Maintain two files in the game install: default_plugins.txt (enabled plugins) and disabled_plugins.txt (disabled plugins).

Installation

• Download the application from the Releases section
• Launch the executable for initial setup, this will search for your Sven Co-op game install.

Usage

🔍 Plugin List (Left Panel)

• Browse available plugins: Each plugin is listed with a checkbox.
• Enable/Disable plugins: Toggle the checkbox to activate or deactivate a plugin.
• ✔: the plugin is enabled
• ☐: the plugin is disabled

⚙ Plugin Configuration (Right Panel)

When a plugin is selected, you can configure its behavior:

• Name: Display name of the plugin.
• Script: Path and filename (without .as extension) for the plugin script. The path begins from scripts/plugins.

Optional fields:

• Command NS: Namespace prefix for plugin commands.
• Admin Level: Choose required access level from the dropdown.
• Included Maps: List of maps where the plugin is active.
• Excluded Maps: List of maps where the plugin is disabled.

✅ Plugin Controls (Bottom Section)

• ☐ Enabled: Checkbox to toggle plugin activation.
• Add new: Opens a file selection dialogue box to install a new plugin.
• Remove: Delete the selected plugin.
• Apply: Applies changes to the current plugin.
• Save: Save all changes to plugins. This will exit the application.

When a plugin is added, the script file be installed to svencoop_addon/scripts/plugins. When a plugin is removed, it will no longer be present in your default_plugins.txt file. The plugin script will still be present in your game if you wish to reinstall it in the future.

💡 Tips

• Use the Apply button before switching plugins to avoid losing changes.
• The Save button writes all plugin states to the Sven Co-op plugin file. Ensure you have applied your changes first before saving.
• If a plugin doesn’t behave as expected, check the Included Maps and Excluded Maps fields

For more detailed information on how to configure plugins, please refer to to the official documentation.

Quick Plugin Install

You can quickly install plugins simply by dragging a .as plugin script file onto the executable. The plugin will be installed to svencoop_addon/scripts/plugins/

Building from source

Prerequisites

1️⃣ Install Rust

• Visit https://rustup.rs and download the Windows installer.
• Run it and accept the defaults (this installs cargo, rustc, and rustup).
• Close and reopen any terminal/PowerShell windows after installation.

---

2️⃣ Install Windows Build Tools The GUI uses the Windows API, so you need the C++ build toolchain:

Option A (Recommended)

• Install Visual Studio Build Tools.
• During installation, select "Desktop development with C++".

Option B

• Add the MSVC target via:

rustup target add x86_64-pc-windows-msvc

Build instructions

1. Download or clone the repository:

git clone https://github.com/Outerbeast/SC-Plugin-Manager
cd SC-Plugin-Manager

2. Run the build script:

• Double-click build.cmd or run it manually:

build.cmd

The executable will be generated in the current directory.

Feedback & Issues

If you have feedback or encounter issues, please open an issue on GitHub Issues.

Credits

Outerbeast - Author

Special Thanks

Thanks to the Native Windows GUI project for providing a Rust library to build native Windows applications.