Command Paste Module for Blish HUD

A Blish HUD module that allows Guild Wars 2 players to quickly paste multiple chat commands into the game.

🤖 AI-Assisted Development

⚠️ NOTICE: This code was written with the assistance of Anthropic Claude AI, with oversight and review by a human developer.

---

📝 Description

Command Paste provides a simple interface for entering multiple GW2 chat commands and automatically pasting them into the game chat one at a time. This is useful for:

• Running multiple commands in sequence
• Sharing build templates
• Executing chat macros
• Automating repetitive command sequences

✨ Features

• Simple multiline text input for entering commands
• Automatic validation (only commands starting with / are pasted)
• Configurable delay between commands
• Real-time status updates during paste operation
• Cancel operation at any time

📦 Installation

Downloading the Module

1. Visit the releases page: Go to https://github.com/Dragonatorul/BHUD-command-paste/releases/latest

2. Download the .bhm file: Under the "Assets" section, click on BHUD-command-paste.bhm to download it

Installing the Module

3. Locate your Blish HUD modules folder:

   • Default location: %USERPROFILE%\Documents\Guild Wars 2\addons\blishhud\modules
   • You can also find this in Blish HUD settings if you've customized the path
   • Quick tip: Press Win+R, paste the path above, and hit Enter to open it directly

4. Copy the .bhm file: Place the downloaded BHUD-command-paste.bhm file into your Blish HUD modules folder

5. Enable the module:

   • Option A: Restart Blish HUD (the module will be available automatically)
   • Option B: In Blish HUD, go to Module Repo → Installed and enable "Command Paste Module"

🎮 Usage

1. Click the Command Paste icon in Blish HUD to open the module window
2. Enter your commands in the text box (one per line)
   • Each command must start with /
   • Empty lines are automatically skipped
3. Click "Paste!" to begin
4. Stay in Guild Wars 2 and don't type during the paste operation
5. Click "Cancel" to stop the paste operation at any time

💡 Example

/say Hello everyone!
/wave
/dance
/sit

⚙️ Settings

• Input Buffer: Adjust the delay between pasting each command (100-500ms)
  • Lower values = faster pasting
  • Higher values = more reliable (recommended for slower systems)

🔨 Building from Source

📋 Prerequisites

• Visual Studio 2017+ or MSBuild
• NuGet CLI (for command-line builds)
• PowerShell (for packaging)

🛠️ Build Steps

🖥️ Option 1: Visual Studio

1. Open BHUD-command-paste.sln in Visual Studio
2. Select Release | x64 configuration
3. Build → Build Solution (or press F6)

⌨️ Option 2: Command Line

# Restore NuGet packages
nuget restore BHUD-command-paste.sln

# Build Release configuration
msbuild BHUD-command-paste.sln /p:Configuration=Release /p:Platform=x64

Output: bin/x64/Release/BHUD-command-paste.dll

📦 Creating the .bhm Package

Blish HUD modules are distributed as .bhm files (ZIP archives with a custom extension).

🔧 Option 1: Using the build script

# Package Release build
.\build-bhm.ps1 -Configuration Release

# Package Debug build
.\build-bhm.ps1 -Configuration Debug

# Specify custom Blish HUD modules path
.\build-bhm.ps1 -Configuration Release -BlishHudModulesPath "D:\Games\BlishHUD\modules"

Output: bin/bhm/BHUD-command-paste.bhm

🔧 Option 2: Manual packaging

1. Create a temporary folder with:
   • manifest.json (from project root)
   • BHUD-command-paste.dll (from bin/x64/Release/)
   • BHUD-command-paste.pdb (optional, for debug symbols)
   • ref/ folder (if it contains assets)
2. ZIP the contents of the folder (not the folder itself)
3. Rename the .zip file to .bhm

💾 Installing Locally

1. Locate your Blish HUD modules directory:
   • Default: %USERPROFILE%\Documents\Guild Wars 2\addons\blishhud\modules
   • Or check Blish HUD settings for custom path
2. Copy the .bhm file to the modules directory
3. Restart Blish HUD, or go to Module Repo → Installed and enable the module

🚀 Creating a Release

The project uses GitHub Actions to automatically build and publish releases when a version tag is pushed.

📝 Steps to Create a Release

1. Update version (optional - can be done automatically):

   # Manually edit manifest.json to update version, or let the workflow do it

2. Create and push a version tag:

   git tag v0.1.0
   git push origin v0.1.0

3. GitHub Actions will automatically:

   • Build the project in Release configuration
   • Update the manifest.json version to match the tag
   • Package the module as a .bhm file
   • Create a GitHub release with the .bhm file attached

4. The release will be available at: https://github.com/dragonator/BHUD_command_paste/releases

🏷️ Version Tag Format

• Use semantic versioning: v<major>.<minor>.<patch>
• Examples: v0.1.0, v1.2.3, v2.0.0
• The v prefix is required

📋 Requirements

• Blish HUD v0.5.2 or later
• Guild Wars 2

📄 License

MIT License - See LICENSE.txt for details

👥 Credits

• Author: dragonator
• Built with Blish HUD