POE Filter Editor
A Visual Studio Code extension for editing Path of Exile (POE1 & POE2) item filters with intelligent features.
Compatibility
✅ Works with both Path of Exile 1 and Path of Exile 2
The filter syntax is identical across both games. This extension supports all standard filter keywords, conditions, and display properties used in both POE1 and POE2 filters.
BaseType Database
The extension includes 292 BaseTypes organized by game version:
- POE1: 214 unique items
- POE2: 78 unique items
Default behavior: Both POE1 and POE2 BaseTypes are loaded for autocomplete.
Customization: You can choose to load only POE1, only POE2, or both via extension settings. See Extension Settings below.
Features
✨ Syntax Highlighting
- Keywords:
Show, Hide, Continue, Import
- Conditions:
BaseType, Class, Rarity, ItemLevel, Quality, Sockets, etc.
- Display Properties:
SetTextColor, SetBorderColor, SetBackgroundColor, SetFontSize
- Audio/Visual Effects:
PlayAlertSound, PlayEffect, MinimapIcon
- Rarity Colors: Normal (white), Magic (blue), Rare (yellow), Unique (orange)
- FilterBlade.xyz Metadata: Recognizes
$type->, $tier->, !tag, and %XN patterns
🎨 Color Features
- Inline Color Visualization: See color swatches (■) directly next to effect colors in
PlayEffect and MinimapIcon
- Color Picker: Click on RGB/RGBA values in
SetTextColor, SetBorderColor, SetBackgroundColor to open a visual color picker
- RGBA Support: Full support for 3 or 4-component color values (Red Green Blue [Alpha])
- Effect Color Recognition: Highlights all 12 effect colors (Red, Green, Blue, Brown, White, Yellow, Cyan, Grey, Orange, Pink, Purple, Temp)
🔗 BaseType Links
- Clickable Item Names: Ctrl+Click (Cmd+Click on Mac) any quoted BaseType item to open its page on poe2db.tw
- Smart URL Conversion: Automatically converts item names to proper URL format
- Multiple Items Support: Each item in a list is individually clickable
- Color Changes: Click on effect color names (Orange, Red, Blue, etc.) to see a menu with all 12 available colors
- Shape Changes: Click on minimap icon shapes (Circle, Diamond, Star, etc.) to see a menu with all 12 available shapes
- One-Click Swap: Instantly change colors or shapes without typing
✅ Syntax Validation
- Real-time error detection for:
- Invalid color values (must be 0-255)
- Incorrect number of color components (must be 3 or 4)
- Unknown filter keywords
- Malformed syntax
🚀 Smart Autocompletion
- BaseType Names: Complete list extracted from reference filters
- Effect Colors: Dropdown list of all 12 colors for
PlayEffect and MinimapIcon
- Icon Shapes: Dropdown list of all 12 shapes for
MinimapIcon
- Rarity Values: Normal, Magic, Rare, Unique with descriptions
- Keywords & Operators: All filter conditions with smart operator suggestions
- Display Properties: Snippets with placeholder values
📖 Comprehensive Hover Documentation
- 60+ Definitions: Hover over any keyword, color, shape, or modifier for detailed explanations
- Official POE Docs: Information sourced from pathofexile.com/item-filter
- FilterBlade Metadata Warnings: Clear explanations that metadata tags are FilterBlade.xyz-specific
- Usage Examples: See syntax examples for every keyword
- MinimapIcon Size Info: Hover over size numbers (0, 1, 2) to see what each size means
Usage
- Install the extension from the VS Code marketplace or from a
.vsix file
- Open any
.filter file - the extension activates automatically
- Start editing with full syntax highlighting and validation
- Click on colors to open the color picker
- Ctrl+Click BaseTypes to view items on poe2db.tw
- Use lightbulb menu (Ctrl+.) on colors/shapes to quickly change them
- Trigger autocomplete with
Ctrl+Space or by typing
- Hover over keywords for documentation and examples
Requirements
- Visual Studio Code 1.108.0 or higher
- Path of Exile filter files (
.filter extension)
- Compatible with POE1 and POE2 filters
Known Limitations
- FilterBlade.xyz metadata (
$type->, $tier->, !tag, %XN) is recognized but not validated
- BaseType autocompletion requires reference filters in the workspace
- poe2db.tw links may not work for all item names (URL format may vary)
- Note: While the filter syntax is identical, some item BaseTypes are game-specific (POE1 vs POE2)
Extension Settings
This extension provides the following settings:
poefilter.gameVersion: Choose which game's BaseTypes to include in autocomplete.
- Type: String (enum)
- Options:
"POE1", "POE2", "Both"
- Default:
"Both"
- Description: Controls which BaseType database to load (POE1: 214 items, POE2: 78 items, Both: 292 items)
poefilter.customBaseTypes: Add custom BaseType items to autocomplete suggestions. These will be merged with the built-in BaseType list.
- Type: Array of strings
- Default:
[]
- Example:
["Custom Item Name", "Another Item"]
poefilter.excludedBaseTypes: Remove specific BaseType items from autocomplete suggestions.
- Type: Array of strings
- Default:
[]
- Example:
["Unwanted Item", "Another Item"]
- Open Settings (
Ctrl+, or Cmd+,)
- Search for "POE Filter"
- Choose your game version (POE1, POE2, or Both)
- Add or remove BaseTypes as needed
The extension comes with 214 POE1 BaseTypes and 78 POE2 BaseTypes (292 total). By default, both are loaded for maximum compatibility.
Release Notes
0.2.0 (Latest)
New BaseType Management System:
- 🎮 Separated POE1 & POE2 Databases: 214 POE1 items + 78 POE2 items = 292 total
- ⚙️ Game Version Setting: Choose POE1, POE2, or Both (Settings → "Poefilter: Game Version")
- 📝 Custom BaseTypes: Add your own items (Settings → "Poefilter: Custom Base Types")
- 🚫 Exclude BaseTypes: Remove unwanted items (Settings → "Poefilter: Excluded Base Types")
- 🔄 Live Configuration: All settings update instantly without reloading
How to Configure:
- Press
Ctrl+, (or Cmd+, on Mac) to open Settings
- Search for "POE Filter"
- Set "Game Version" to POE1, POE2, or Both
- Add custom items to "Custom Base Types" array
- Add unwanted items to "Excluded Base Types" array
0.1.0 (Initial Release)
Core Features:
- Syntax highlighting with rarity-colored values
- Color visualization with inline swatches
- Color picker for RGB/RGBA values
- Syntax validation with error reporting
Advanced Features:
- BaseType linking to poe2db.tw database
- Quick action lightbulb menus for colors and shapes
- Smart autocompletion with context-aware suggestions
- 60+ hover definitions from official documentation
- FilterBlade.xyz metadata recognition and warnings
- Effect color decorator showing colored squares
- MinimapIcon size definitions (0=small, 1=medium, 2=large)
Credits
Contributing
Found a bug or have a feature request? Please open an issue on GitHub!
License
MIT License - See LICENSE file for details
Enjoy editing your POE2 filters with ease! 🎮✨
| |
