A comprehensive toolset for SA-MP and Open.MP Pawn development, featuring IntelliSense, snippets, build tools, and color utilities.
GitHub Repository | Report Issues | Request Features
🌟 Highlights
- 🎨 Advanced Color Management: Convert and preview colors in multiple formats
- 🚀 Smart IntelliSense: Context-aware code completion and documentation
- 🛠️ Integrated Build Tools: Compile directly from VS Code
- 📝 Rich Snippets: Quick access to common code patterns
- 🎯 SA-MP & Open.MP Support: Compatible with both platforms
✨ Features
🎨 Color Management
- Color Viewer: View colors in three formats:
- Embed Format:
{FFFFFF}
- Hex Format:
#FFFFFF
- Gametext Format:
~r~
- Color Conversion: Convert between different color formats
- Smart Auto-completion: Type
#
to get color suggestions
- 100+ Predefined Colors: Including basic, neon, pastel, metallic, and more
- IntelliSense Support: Get code suggestions and documentation
- Code Snippets: Quick access to common Pawn code patterns
- Build Integration: Compile your scripts directly from VS Code
- Syntax Highlighting: Enhanced code readability
📚 Documentation Support
- Hover Information: View function documentation by hovering
- Parameter Hints: Get real-time parameter information
- Quick Navigation: Jump to definitions and references
- Signature Help: View function signatures while typing
🔧 Project Management
- Project Templates: Quick start with pre-configured templates
- File Organization: Automatic structure for SA-MP/Open.MP projects
- Build Configurations: Customize compiler settings
- Include Management: Smart handling of include files
🚀 Getting Started
📥 Installation
1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Pawn Tools for Open.MP and SA-MP"
4. Click Install
🎯 Quick Start Guide
Create a New Project
Ctrl+Shift+P → "Pawn: Create Pawn File"
Use Color Tools
// Type # for color suggestions
#red → #FF0000
#blue → #0000FF
#lightgreen → #90EE90
Build Your Script
Ctrl+Shift+P → "Pawn: Build File"
🎨 Color Features
// Hex Format
#FF0000 // Red
#00FF00 // Green
#0000FF // Blue
// Embed Format
{FF0000} // Red
{00FF00} // Green
{0000FF} // Blue
// Gametext Format
~r~ // Red
~g~ // Green
~b~ // Blue
🎯 Smart Color Features
Intelligent Matching
- Fuzzy search for color names
- Supports partial matches
- Case-insensitive search
Preview & Documentation
- Real-time color previews
- Color information on hover
- Quick conversion between formats
Custom Colors
- Define your own color palettes
- Import/Export color schemes
- Share colors across projects
⚙️ Configuration
🔧 Settings Options
{
"pawnTools": {
// Color Settings
"defaultColorFormat": "hex", // hex, embed, or gametext
"showColorPreviews": true,
"enableColorCompletion": true,
// Build Settings
"compiler": {
"path": "path/to/compiler",
"options": "-d3 -O3"
},
// Editor Settings
"enableHover": true,
"enableSnippets": true,
"formatOnSave": true
}
}
🎨 Color Configuration
- Default Format: Choose your preferred color format
- Preview Style: Customize how colors are displayed
- Completion Triggers: Configure auto-completion behavior
🛠️ Build Configuration
- Compiler Path: Set custom compiler location
- Include Paths: Configure include directories
- Output Directory: Customize build output location
🔄 Recent Updates
Version 2.0.0
- Updated color management system
- Added comprehensive color management system
- Introduced color conversion tools
- Added 100+ predefined colors
- Enhanced color preview and documentation
Version 1.0.0
- Initial release
- Basic Pawn development tools
- Build system integration
- IntelliSense support
🤝 Contributing
Contributions, issues, and feature requests are welcome!
Feel free to check the issues page.
🌟 How to Contribute
- Fork the repository
- Create your feature branch
git checkout -b feature/AmazingFeature
- Commit your changes
git commit -m 'Add: Amazing Feature'
- Push to the branch
git push origin feature/AmazingFeature
- Open a Pull Request
📝 License
Copyright 2024 Southclown.
This project is MIT licensed.
👨💻 Author
Southclown
🌟 Special Thanks
- SA-MP Team for the original Pawn compiler
- Open.MP Team for their continued support
- All contributors who have helped improve this extension