A comprehensive Visual Studio Code extension for Running with Rifles (RWR) game modification development. This extension provides advanced language support, intelligent code completion, and specialized tools for RWR mod creators.
✨ Key Features
🎯 Automatic Project Detection
The extension automatically recognizes RWR mod projects by detecting these key files:
**/calls/all_calls.xml**/factions/all_factions.xml**/items/all_carry_items.xml**/weapons/all_weapons.xml
🔧 Development Commands
Access powerful tools via the Command Palette (Ctrl+Shift+P):
- RWR Mod Tool: Create Armor - Generate armor configuration templates
- RWR Mod Tool: Create Weapon - Generate weapon definition templates
- RWR Mod Tool: Format Active File - Format the currently open file
- RWR Mod Tool: Format Workspace - Format all files in the workspace
- RWR Mod Tool: Show File Format Output - View formatting operation logs
🛡️ File Validation & Linting
- XML File Reference Validation - Automatically validates file references in XML attributes:
file - Direct file path referencesfile_name - File name referencesfilename - Alternative filename attributefileref - File reference attribute
- Real-time error highlighting for missing or invalid file paths
- Performance-optimized scanning to prevent IDE lag
📝 Intelligent Code Snippets
Comprehensive snippet library for rapid development:
- Prefix: All snippets start with
rwr- for easy discovery
- Categories:
- Weapon definitions (
rwr-weapon)
- Item configurations (
rwr-item)
- Faction setups (
rwr-faction)
- Map configurations (
rwr-map)
- Vehicle definitions (
rwr-vehicle)
- Language files (
rwr-language)
- Model definitions (
rwr-model)
- Call configurations (
rwr-call)
- And many more specialized snippets
🚀 Advanced Language Support
AngelScript Language Server
Full-featured language server for AngelScript (.as) files:
🎯 Go to Definition
- Include File Navigation - Click on
#include "filename.as" to jump directly to included files
- Symbol Resolution - Navigate to function and class definitions across files
- Cross-Reference Support - Find all references to symbols throughout your project
💡 IntelliSense Features
- Syntax highlighting with RWR-specific patterns
- Auto-completion for built-in functions and types
- Error detection and diagnostic reporting
- Symbol outline and navigation
File Resolver Language Server
Specialized server for XML file reference management:
🔗 Smart File Navigation
- XML Attribute Navigation - Click on any file reference attribute to jump to the target file:
<item file="path/to/item.xml" /><weapon filename="weapon_ak47.weapon" /><model file_name="soldier.xml" /><sound fileref="sounds/gunshot.wav" />
✅ Real-time Validation
- Instant feedback on file reference validity
- Automatic path resolution
- Missing file detection and reporting
🎮 Getting Started
Install the Extension
Open Your RWR Mod Project
- Open any folder containing RWR mod files
- The extension will automatically activate when it detects mod structure
Start Using Features
- Type
rwr- to access code snippets
- Use
Ctrl+Click on file references to navigate
- Access commands via
Ctrl+Shift+P
🔧 Configuration
The extension works out-of-the-box with sensible defaults. Advanced users can customize behavior through VSCode settings.
📸 Screenshots
Access all RWR mod tools through the Command Palette
Automatic file reference validation and navigation
Comprehensive code snippet library with rwr- prefix
🤝 Contributing
We welcome contributions! Please see our contribution guidelines for more information.
🐛 Issue Reporting
Found a bug or have a feature request? Please open an issue on GitHub.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📋 Release Notes
What's New in v0.6.0
- 🔗 File Resolver Language Server - Enhanced XML file reference navigation
- 🎯 Improved Go-to-Definition - Click on XML file attributes to jump to referenced files
- ⚡ Performance Optimizations - Faster file scanning and validation
Previous Releases
- v0.5.0 - AngelScript Language Server with include file navigation
- v0.4.0 - Enhanced formatting tools and error output
- v0.3.0 - Performance improvements for file formatting
- v0.2.0 - Added file scanning progress indicators
- v0.1.0 - Initial release with code snippets and basic tools
For detailed release notes, see CHANGELOG.md
