1000 ticks ≈ 1 second
Item Cooldowns
Item cooldowns are controlled by theReqIg field in the Item data. The cooldown is applied when the item is used.
Cooldown Table
The cooldown group identifier for the item. Items with the same
ReqIg value share a cooldown.| ReqIg | Ticks | Seconds | Description |
|---|---|---|---|
| 0 | 0 | 0s | No cooldown |
| 1 | 15000 | ~15s | Short cooldown |
| 2 | 20000 | ~20s | Medium-short cooldown |
| 3 | 25000 | ~25s | Medium cooldown |
| 4 | 30000 | ~30s | Medium-long cooldown |
| 5 | 60000 | ~1m | 1 minute cooldown |
| 6 | 120000 | ~2m | 2 minute cooldown |
| 7 | 0 | 0s | No cooldown |
| 8 | 0 | 0s | No cooldown |
| 9 | 0 | 0s | No cooldown |
| 10 | 600000 | ~10m | 10 minute cooldown |
| 11 | 2000 | ~2s | Very short cooldown |
Lapis Combination
For Alchemy lapis combination, the client only allowsReqIg values 31 through 40.
Lapis Combination Requirements
Lapis Combination Requirements
Usage Examples
Monster Skill Cooldowns
Monster skill cooldowns are controlled by theAttackSpecial3 field in the Monster data. This determines how frequently a monster can use special attacks or skills.
Cooldown Table
The cooldown identifier for monster special attacks.
| AttackSpecial3 | Ticks | Duration | Use Case |
|---|---|---|---|
| 0 | 5000 | ~5s | Very frequent attacks |
| 1 | 30000 | ~30s | Frequent attacks |
| 2 | 60000 | ~1m | Regular attacks |
| 3 | 180000 | ~3m | Infrequent attacks |
| 4 | 300000 | ~5m | Rare attacks |
| 5 | 900000 | ~15m | Very rare attacks |
| 6 | 1800000 | ~30m | Half-hourly |
| 7 | 3600000 | ~1h | Hourly |
| 8 | 14400000 | ~4h | Every 4 hours |
| 9 | 43200000 | ~12h | Twice daily |
| 10 | 86400000 | ~24h | Daily |
| 11 | 259200000 | ~3d | Every 3 days |
| 12 | 7200000 | ~2h | Every 2 hours |
| 13 | 0 | 0s | No cooldown |
| 14 | 604800000 | ~7d | Weekly |
| 15 | 15000 | ~15s | Short cooldown |
Monster Design Guidelines
Trash Mobs
Use
AttackSpecial3 values 0-2 for regular monsters that should use skills frequently (5s-1m).Elite Mobs
Use values 3-4 for elite monsters with impactful abilities (3m-5m).
Boss Mechanics
Use values 5-7 for boss monsters with powerful phase abilities (15m-1h).
World Bosses
Use values 8-14 for unique world bosses and timed events (4h-7d).
Usage Examples
Cooldown Best Practices
Item Cooldown Sharing
Item Cooldown Sharing
Items with the same
ReqIg value share a cooldown. Use this to prevent players from stacking similar consumables.Example: All health potions should have ReqIg = 1 to prevent spam-healing.Balance Considerations
Balance Considerations
- Short cooldowns (0-2): Use for frequently used items like potions
- Medium cooldowns (3-6): Use for buffs and utility items
- Long cooldowns (10): Use for powerful items or teleport scrolls
- 0-2: Regular combat skills
- 3-5: Special abilities
- 6+: Unique boss mechanics
Testing Cooldowns
Testing Cooldowns
Convert ticks to seconds for testing:
The conversion is approximate. Server tick rate may vary slightly.
No Cooldown Values
No Cooldown Values
ReqIg values 7, 8, 9 and AttackSpecial3 value 13 have no cooldown (0 ticks).Use these for:- Quest items that shouldn’t have cooldowns
- Passive items
- Monsters that should spam abilities
Related Configuration
Lua API
Learn how to use cooldowns in monster AI scripts
Data Formats
Understanding Item and Monster SData structure