# item-handlers

> I've generated the complete skill files for the **item-handlers** skill. Here's a summary of what was created:

- Author: valeriybaranyshyn-pixel
- Repository: valeriybaranyshyn-pixel/Tales-of-Aden
- Version: 20260202145225
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/valeriybaranyshyn-pixel/Tales-of-Aden
- Web: https://mule.run/skillshub/@@valeriybaranyshyn-pixel/Tales-of-Aden~item-handlers:20260202145225

---

I've generated the complete skill files for the **item-handlers** skill. Here's a summary of what was created:

## Generated Files

### 1. `SKILL.md` (Main skill file)
- Quick overview of the item handler system
- Minimal handler example with the 3-step pattern
- Registration and XML configuration
- Key concepts table
- Common patterns (reward box, skill-casting)
- Links to reference files

### 2. `references/patterns.md` (Handler implementation patterns)
- Handler categories (26 standard, 20 custom)
- Validation patterns (player type, state restrictions, event integration, flood protection)
- Item consumption patterns (basic, config-based infinite, non-consumable list)
- Visual effect patterns
- Anti-patterns with detailed explanations:
  - Hardcoded item IDs
  - Missing event checks
  - Silent failures on config-gated handlers
  - Hash collision risk
- Handler inheritance pattern (Elixir example)
- Registry pattern explanation

### 3. `references/workflows.md` (Creation and testing workflows)
- Step-by-step handler creation checklist
- Complete code examples for each step
- Config-gated handler pattern
- Testing procedures with GM commands
- Debugging guide with common issues table
- Handler categories checklists (Reward, Premium, Skill, Summon)
- Build verification workflow

The skill documents the L2J item handler architecture based on the actual codebase patterns found in `gameserver/handler/itemhandlers/` with examples from `ItemSkills`, `BoxRewards`, `SoulShots`, `RollingDice`, `VipItemClick`, and others.