create_achievement
Create custom achievements with unlock conditions, experience, coin, skill, and item rewards. Set optional conditions like tasks, pomodoros, or coins. Achievements are locked by default.
Instructions
Create a new custom achievement with unlock conditions and rewards. Requires achievement name and category ID. Optionally specify unlock conditions (JSON array), experience/coin rewards, skill rewards, item rewards, and appearance settings. Created achievements are locked by default.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Achievement name (required, max 100 characters) | |
| category_id | Yes | Achievement category/list ID (required) | |
| desc | No | Achievement description (optional, max 500 characters) | |
| conditions_json | No | Unlock conditions as JSON array (optional). Format: [{"type":7,"target":1000000}]. Common types: 0=task completion, 3=pomodoro, 6=daily streak, 7=coins, 13=skill level, 14=life level | |
| exp | No | Experience points reward (optional). IMPORTANT: Must specify skills array to apply XP to attributes. | |
| coin | No | Coin reward (optional, 0-999999) | |
| coin_var | No | Coin reward variation/randomness (optional) | |
| skills | No | Skill/attribute IDs to receive XP rewards. Required when setting exp parameter. Without skills, XP cannot be applied. | |
| items | No | Item rewards (optional). Format: [{"item_id":1,"amount":2}] | |
| item_id | No | Single item reward ID (optional, alternative to items array) | |
| item_amount | No | Single item reward amount (optional, 1-99) | |
| secret | No | Hidden achievement (optional, default: false) | |
| color | No | Title color in hex format (optional, e.g., "#66CCFF") | |
| unlocked | No | Create as already unlocked (optional, default: false) |