传奇服务端脚本命令：核心命令大全及应用实例 新手入门指南

传奇服务端脚本命令是控制游戏规则、NPC行为、任务流程的核心工具，掌握常用命令能高效搭建游戏玩法。以下按功能分类，讲解命令用法与实际场景。

一、基础配置命令：搭建游戏核心规则

基础命令用于设定角色初始状态、地图属性等基础规则，是服务端运行的前提。

1. 角色初始配置：SET_INIT

功能：定义角色创建时的等级、职业、初始物品等信息，语法为“SET_INIT 配置类型 参数1 参数2”。

[@ServerInit]
#act
; 所有角色初始等级设为1级
SET_INIT LEVEL 1
; 战士职业初始物品：木剑（ID2001）、布衣（ID3001）
SET_INIT ITEM 1 2001 1 3001 1
; 法师职业初始魔法值设为50
SET_INIT MP 2 50
; 道士职业初始召唤兽为骷髅（ID4001）
SET_INIT PET 3 4001

说明：参数中“1”代表战士、“2”代表法师、“3”代表道士，需与服务端职业编码对应。

2. 地图属性设置：MAP_ATTR

功能：配置地图的PK模式、经验倍率、怪物刷新频率等，语法为“MAP_ATTR 地图ID 属性类型 参数”。

[@MapConfig]
#act
; 新手村（地图ID101）设为安全区，禁止PK
MAP_ATTR 101 PKMOD 0
; 蜈蚣洞（地图ID102）经验倍率提升至1.5倍
MAP_ATTR 102 EXP_RATE 1.5
; 沃玛寺庙（地图ID103）怪物刷新间隔设为60秒
MAP_ATTR 103 REFRESH_TIME 60
; 沙巴克（地图ID104）允许任意PK，无惩罚
MAP_ATTR 104 PKMOD 3

二、NPC交互命令：实现NPC功能逻辑

NPC是游戏交互核心，相关命令涵盖对话、菜单、交易等功能，支撑玩家日常操作。

1. 对话与菜单命令：NPC_TALK、MENU

NPC_TALK用于显示对话内容，MENU用于创建交互菜单，两者常搭配使用。

[@NpcMain]
#act
; 显示初始对话
NPC_TALK 1 我是新手引导员，有什么可以帮你？
; 创建功能菜单
MENU 1 领取新手福利 @GetWelfare
MENU 2 传送至新手村 @MoveNewbie
MENU 3 咨询职业信息 @JobIntro

[@GetWelfare]
#act
REWARD_ITEM 2001 1 3001 1
NPC_TALK 2 新手福利已发放，请注意查收！

[@MoveNewbie]
#act
MAP_MOVE 101 320 280
NPC_TALK 3 已为你传送至新手村安全区。

2. 交易功能命令：TRADE_SET

功能：设置NPC可交易的物品及价格，语法为“TRADE_SET 物品ID 数量 售价 收购/出售”。

[@MerchantNpc]
#act
; 出售金疮药（ID5001），1个售价100金币
TRADE_SET 5001 1 100 SELL
; 收购黑铁矿石（ID6001），1个收购价500金币
TRADE_SET 6001 1 500 BUY
; 交易时显示提示
NPC_TALK 4 我这里有药水出售，也收矿石哦！

三、任务控制命令：构建完整任务流程

任务命令实现接取、进度判定、完成奖励等环节，核心是“条件触发+动作执行”。

1. 任务接取与进度：QUEST_ACCEPT、QUEST_PROGRESS

[@QuestGiver]
#act
; 判定玩家等级≥5级可接取任务
#if
LEVEL >=5
#act
QUEST_ACCEPT 1001 收集5个鹿肉
NPC_TALK 5 去城外杀死鹿，收集5个鹿肉回来找我。
#else
NPC_TALK 6 你的等级不足5级，无法接取此任务。

[@QuestSubmit]
#act
; 判定任务进度是否完成
QUEST_PROGRESS 1001 5
#act
REWARD_GOLD 10000
REWARD_EXP 5000
QUEST_FINISH 1001
NPC_TALK 7 任务完成，这是你的奖励！
#else
NPC_TALK 8 你还没收集够5个鹿肉，继续努力吧。

2. 任务道具控制：QUEST_ITEM

功能：绑定任务与特定道具，实现道具触发任务或任务消耗道具。

[@UseQuestItem]
#act
; 使用“神秘卷轴”（ID7001）触发隐藏任务
QUEST_ITEM 7001 1 2001
NPC_TALK 9 你发现了神秘卷轴，触发隐藏任务“寻找宝藏”！
QUEST_ACCEPT 2001 寻找宝藏位置

四、战斗相关命令：调控战斗规则与奖励

涵盖怪物刷新、击杀奖励、PK规则等，直接影响玩家战斗体验。

1. 怪物刷新命令：MONSTER_SPAWN

语法为“MONSTER_SPAWN 地图ID 怪物ID 数量 坐标X 坐标Y 刷新间隔”。

[@MonsterSpawn]
#act
; 新手村（101）刷新10只鹿（ID8001），间隔30秒
MONSTER_SPAWN 101 8001 10 300 260 30
; 沃玛寺庙（103）刷新1只沃玛教主（ID8002），间隔3600秒
MONSTER_SPAWN 103 8002 1 400 350 3600

2. 击杀奖励命令：KILL_REWARD

功能：设置杀死指定怪物或玩家后的奖励，无需单独判定，直接绑定击杀事件。

[@KillRewardConfig]
#act
; 杀死沃玛教主（8002）奖励沃玛号角（6002）和10万金币
KILL_REWARD 8002 ITEM 6002 1 GOLD 100000
; 杀死敌对玩家奖励5000经验
KILL_REWARD PLAYER 2 EXP 5000

五、服务端脚本命令使用技巧

1. 命令查询：通过服务端“命令手册”文件查询完整命令列表，确认版本兼容性，不同版本命令可能存在差异。

2. 变量搭配：使用全局变量（G0-G499）存储全服数据，如活动进度；私人变量（P0-P9）存储角色个人信息，如任务进度。

3. 测试验证：脚本编写后在测试服运行，重点检查命令逻辑是否冲突、奖励是否正常发放，避免正式服出现漏洞。