🎮 Pawn Tools for Open.MP and SA-MP

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

🛠️ Development Tools

• 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

1. Create a New Project

   Ctrl+Shift+P → "Pawn: Create Pawn File"
   

2. Use Color Tools

   // Type # for color suggestions
   #red        → #FF0000
   #blue       → #0000FF
   #lightgreen → #90EE90
   

3. Build Your Script

   Ctrl+Shift+P → "Pawn: Build File"
   

🎨 Color Features

Color Formats

// 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

1. Intelligent Matching

   • Fuzzy search for color names
   • Supports partial matches
   • Case-insensitive search

2. Preview & Documentation

   • Real-time color previews
   • Color information on hover
   • Quick conversion between formats

3. 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

1. Fork the repository
2. Create your feature branch

   git checkout -b feature/AmazingFeature
   

3. Commit your changes

   git commit -m 'Add: Amazing Feature'
   

4. Push to the branch

   git push origin feature/AmazingFeature
   

5. Open a Pull Request

📝 License

Copyright 2024 Southclown. This project is MIT licensed.

👨‍💻 Author

Southclown

• GitHub: @southclown
• Discord: @charleslienhart

🌟 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