传奇封官晋爵官职晋升爵位属性称号全套脚本配置与权限控制完整搭建教程

封官晋爵功能核心逻辑是设置多阶爵位，玩家满足对应条件即可申请晋升，晋升成功后赋予称号、基础属性、专属权限，使用人物私有变量记录当前爵位等级，爵位等级随晋升变更，降级或者罢免时收回全部爵位加成，整套功能依靠NPC对话脚本、属性附加脚本、变量判定、称号系统组合实现，编写前备份QFunction-0.txt、NPC脚本文件与称号配置，防止脚本语法错误引发服务端报错。

爵位等级规划，先定义整套爵位阶梯，从低阶到高阶依次排序，例如平民、义士、校尉、都尉、将军、镇国侯、王爵，每一级爵位分配独立编号，M0作为人物爵位变量，M0=0代表平民无爵位，M0=1对应义士，M0=2对应校尉，逐级递增。每一级单独设置晋升条件，条件可包含等级、资源、功勋值、任务完成标记、行会身份，高阶爵位可增加名额限制，同爵位最多允许固定人数，达到上限后不再接受新的晋升申请。

NPC主对话入口搭建，新建封官晋爵NPC，NPC脚本放置在QNPC文件，NPC对话界面展示当前爵位、功勋、下一阶晋升需求，提供晋升、查询爵位、罢免爵位三个选项。基础对话框架示例。
[@main]
#ACT
MOV S0 你当前爵位：
#IF
EQUAL M0 0
#ACT
MOV S1 平民
BREAK
#IF
EQUAL M0 1
#ACT
MOV S1 义士
BREAK
#IF
EQUAL M0 2
#ACT
MOV S1 校尉
BREAK
SENDMSG 7 <$\(STR(S0)><\)$STR(S1)>
SENDMSG 7 爵位越高，获得属性加成与专属权限越多
SENDMSG 7 <1>晋升爵位<@UpRank> <2>查询爵位权益<@CheckRight> <3>罢免爵位<@RemoveRank>
BREAK

[@UpRank]
#IF
EQUAL M0 0
CHECKLEVELEX > 45
CHECKGOLDPOINT > 999
#ACT
GOLDPOINT - 1000
CALC M0 = 1
SENDMSG 6 恭喜，晋升义士成功，获得爵位属性与称号
GIVE 爵位证明 1
BREAK
#ELSEACT
SENDMSG 6 等级或者资源不足，无法晋升义士
BREAK
#IF
EQUAL M0 1
CHECKLEVELEX > 55
CHECKGOLDPOINT > 4999
#ACT
GOLDPOINT - 5000
CALC M0 = 2
SENDMSG 6 恭喜，晋升校尉成功
BREAK
#ELSEACT
SENDMSG 6 不满足校尉晋升条件
BREAK
后续高阶爵位继续追加IF判断分支，每一级独立校验条件，扣除资源后更新爵位变量M0。

爵位属性附加实现，爵位属性使用脚本动态附加，推荐在[@OnTimer]定时器内持续检测爵位变量，实时赋予属性，取下装备、小退重登不会丢失属性。定时器每秒读取M0数值，匹配爵位等级执行属性加成。
QManage登录事件开启定时器。
[@OnLogin]
#ACT
SETTIMER 5 1000
BREAK
QFunction-0定时器检测段。
[@OnTimer5]
#ACT
;先清除旧爵位全部属性
CLEARADDBUFF
#IF
EQUAL M0 1
#ACT
ADDBUFF 攻击 5 5
ADDBUFF 防御 3 3
BREAK
#IF
EQUAL M0 2
#ACT
ADDBUFF 攻击 12 12
ADDBUFF 防御 8 8
ADDBUFF 魔御 5 5
BREAK
#IF
EQUAL M0 3
#ACT
ADDBUFF 攻击 25 25
ADDBUFF 防御 15 15
ADDBUFF 魔御 10 10
BREAK
#ELSEACT
BREAK
CLEARADDBUFF用于每次刷新前清空原有爵位buff，避免多次晋升造成属性叠加溢出。ADDBUFF命令参数依次为属性类型、下限、上限，不同引擎buff命令存在差异，GOM、GEE、HERO需要替换对应附加属性指令。

爵位称号绑定，晋升成功调用称号指令，授予对应爵位头顶称号，罢免爵位时移除称号。晋升成功分支内增加称号脚本。
#ACT
SETTITLE 义士
SENDMSG 6 获得称号【义士】
罢免爵位分支使用CLEARTITLE清除头顶称号。
[@RemoveRank]
#IF
LARGE M0 0
#ACT
CLEARADDBUFF
CLEARTITLE
CALC M0 = 0
SENDMSG 6 爵位已罢免，所有爵位属性、称号全部收回
BREAK
#ELSEACT
SENDMSG 6 你本身没有任何爵位
BREAK

功勋值配套机制，新增人物变量M1记录功勋，击杀指定怪物、完成专属任务、提交道具可以增加功勋，高阶爵位晋升强制消耗功勋。在[@OnKillMon]增加功勋获取逻辑，击杀指定BOSS增加功勋。
[@OnKillMon]
#IF
ISMONNAME 边关守将
#ACT
CALC M1 + 100
SENDMSG 7 击杀BOSS获得功勋100，当前功勋：<$M1>
BREAK
晋升条件增加CHECKM1，例如校尉晋升需要M1>=500功勋，晋升成功扣除对应功勋CALC M1 - 500。

爵位名额限制功能，使用全局变量记录每阶爵位已册封人数，玩家申请晋升时先判断全局名额，名额已满禁止晋升。G1为义士当前人数上限20，G0为当前已册封义士数量。
#IF
EQUAL M0 0
LARGE G0 19
#ACT
SENDMSG 6 义士名额已满，请等待其他玩家罢免爵位
BREAK
晋升成功后CALC G0 +1，玩家罢免爵位时CALC G0 -1，全局变量在机器人脚本初始化，服务器重启重置名额计数。

爵位专属权限开发，不同爵位开放专属功能，低阶爵位开放地图传送、随身仓库，高阶爵位开放专属地图、额外泡点倍率、专属NPC商店。在对应功能脚本内增加爵位变量判定，例如传送NPC脚本增加判断。
#IF
EQUAL M0 2
#ACT
MAPMOVE 专属地图 100 100
BREAK
#ELSEACT
SENDMSG 6 校尉及以上爵位才可进入该区域
BREAK

爵位降级逻辑，可设置定期扣除功勋，功勋低于阈值自动降级。机器人全局定时器定时检测在线玩家功勋，M1低于设定数值，自动降低爵位等级，同步清除原有属性称号，重新赋予降级之后爵位的加成。也可设置违规处罚，GM执行命令直接扣除爵位。

状态同步处理，玩家下线处理，在[@OnLogout]事件无需直接删除爵位变量，爵位属于永久身份标记，除非主动罢免或者触发降级。登录时定时器自动重新加载爵位buff，保证重登之后属性正常生效。玩家死亡不会自动罢免爵位，除非单独编写死亡触发降级脚本。

文本界面优化，NPC对话增加爵位权益预览，展示下一阶爵位的攻击、防御加成、专属功能。爵位查询面板读取M0、M1变量，展示当前爵位、功勋、已享属性、下一阶晋升条件。文字使用颜色标记，区分已达成条件和未达成条件，未满足的条件使用红色文字提示。

常见问题排查，爵位变量M0被其他脚本覆盖，晋升之后爵位重置，爵位变量尽量单独分配，不和其他功能共用。属性buff没有CLEARADDBUFF清理，多次晋升属性叠加，数值异常。称号命令拼写错误，晋升成功头顶不显示爵位称号。名额全局变量增减逻辑写反，晋升不增加人数，罢免不减少人数。脚本修改后没有重载QFunction，爵位buff不生效。定时器间隔设置过短，高频刷新buff加重脚本负载，推荐1000毫秒周期。

调试步骤，新建测试角色，从平民开始逐步晋升，核对每一级晋升资源扣除、功勋消耗、称号显示、属性增加。测试名额满额状态，确认无法继续晋升。执行罢免爵位，验证属性、称号全部清除。测试角色小退重登，确认爵位状态保留，buff自动加载。多账号同时测试爵位名额，确认全局计数正常增减，不会出现名额统计错乱。

扩展功能，增加爵位专属聊天前缀，发言前方自动带上爵位标识。增加爵位排行榜，读取全服玩家爵位变量，在NPC查看爵位排名。增加爵位俸禄，机器人定时给拥有爵位的玩家发放俸禄资源。增加爵位徽章道具，晋升自动发放对应徽章，徽章仅作为外观标记，删除徽章不影响爵位状态。全部功能编写完成，长时间在线运行，校验爵位不会莫名丢失、属性不会叠加错乱、名额统计稳定。