Skip to main content

🔍 ITEM HUNT 🔍

Quick Description​

The Item Hunt event challenges players to find and deliver specific items to an NPC that spawns at a set location. The first to deliver the item receives the reward.

How it works​

  • Event can be started automatically (scheduled) or manually by GM (/itemhuntstart)
  • NPC spawns at the configured location and announces the required item
  • Players must bring the requested item and click the NPC
  • The item is NOT consumed
  • Rewards are given instantly
  • Anti-spam protection: 20 seconds between attempts

Main command​

  • /itemhuntstart — Start event manually (GM)

Quick config (ItemHuntConfig.lua)​

Switch = true, -- Enable/disable event
ServerCode = {21}, -- Enabled servers
EventDuration = 600, -- Event duration (seconds)
AnnounceTime = 60, -- Warning time before start (seconds)
NpcIndex = 247, -- NPC code
RewardMode = 1, -- 1 = Random, 2 = Fixed
NpcMap = 0, NpcPosX = 135, NpcPosY = 127, -- NPC position
SpamItemDelay = 20, -- Anti-spam delay (seconds)
CommandStart = "/itemhuntstart", -- Manual command
CommandGMLevel = 16, -- GM level required
ItemList = { ... }, -- Required items
Rewards = { ... } -- Rewards for the event

See ItemHuntConfig.lua for all parameters and detailed examples.