For the complete documentation index, see llms.txt. This page is also available as Markdown.

📑CustomNpcQuest

Configures a chain of sequential quests delivered by a specific NPC, at an exact point on the map (the version of CustomQuest.txt tied to an actual NPC instead of a loose command). The file has 8 blocks, all linked by the Quest/Index column, which identifies the position in the chain.

Block 0 — NPC and quest limit

Column

Accepted values

What it is

Quest

Number

Position in the chain.

Npc

Number of the NPC class

Which NPC delivers this quest.

NpcMap

Number

Map where this NPC must be located.

NpcX / NpcY

Number

Exact position of the NPC on the map.

MaxQuest

Number, or 0

Maximum amount of quests from this chain that the NPC delivers. 0 = no limit.

OpenNpc

0 or 1

1 = the NPC continues to open its normal shop/dialogue in addition to the quest. 0 = the NPC only deals with the quest.

Block 1 — character requirements

Column

Accepted values

What it is

Quest

Number

The quest in the chain to which this requirement belongs.

Level / MLevel

Number, or *

Minimum Level/Master Level. * = no requirement.

Reset / MReset

Number, or *

Minimum Reset/Master Reset. * = no requirement.

Zen

Number

Required Zen (deducted upon completion).

WC / WP / GP

Number

Required WCoinC/WCoinP/Goblin Point (deducted upon completion).

AL

Number, or *

Required Free/VIP1/VIP2/VIP3 account level. * = any.

RankUser

Number, or *

Required ranking position. * = no requirement.

Kills

Number, or *

Minimum amount of kills (PK). * = no requirement.

Block 2 — required item (removed from inventory)

Column

Accepted values

What it is

Quest

Number

Which quest it belongs to.

Section / Type

Number / Number

Together they form the required item.

Level

Number, or *

Required level (+how much) of the item. * = any.

Luck / Skill

0 (without), 1 (with) or * (ignores)

Requires (or not) the option on the item.

Amount

Number

Required amount.

Block 3 — monster to kill

Column

Accepted values

What it is

Quest

Number

Which quest it belongs to (only 1 type of monster per quest).

Monster

Number of an Index from Monster.txt

Monster that needs to be killed.

Amount

Number

Required amount of kills.

Block 4 — currency reward

Column

Accepted values

What it is

Quest

Number

Which quest it belongs to.

WC / WP / GP

Number

WCoinC/WCoinP/Goblin Point given as a prize.

Money

Number

Zen given as a prize.

Block 5 — item reward

Same columns as block 4 of CustomQuest.txt (Section/Type/Level/Durab/Skill/Luck/Option/ExcOp/SetOp/JoH/OEx/Socket1Socket5/Time/Class).

Block 6 — buff reward

Same columns as block 5 of CustomQuest.txt (Effect/Power1/Power2/Time).

Block 7 — experience reward

Same columns as block 6 of CustomQuest.txt (Experience/LevelUpPoint).

Notes

  • Unlike CustomQuest.txt (loose chain, without an NPC), here progress is counted per NPC — each NPC registered in block 0 has its own chain and its own progress counter per player.

  • MaxQuest limits how many quests from that NPC a player can complete in total (0 = no limit); after reaching the limit, the NPC stops offering new quests from that chain.

  • With OpenNpc = 0, the NPC becomes "quest exclusive" — it stops opening its normal shop/dialogue while delivering this chain.

Last updated