一、脚本核心功能定位
本脚本核心用于检测角色当前所在地图，限制特定地图内使用背包加星功能。当角色处于预设禁止地图时，若使用铁匠秘锤与幸运之石进行背包砸星操作，脚本立即触发惩戒机制，执行自动掉线或强制传送出该地图指令，杜绝违规加星行为。脚本适配主流传奇引擎，支持多地图精准管控，兼顾指令执行流畅性与服内规则落地。
二、脚本核心配置参数
1. 禁止地图列表配置
支持手动添加/删除禁止地图，按地图ID或地图名称精准绑定，适配不同版本地图设定。默认推荐禁止地图：赤月峡谷、猪洞七层、幻境十层、攻城战场、专属BOSS地图。可通过参数开关单独启用/禁用某张地图的限制规则，例如仅开启攻城战场限制，其余地图保留背包加星权限。预留地图批量导入接口，管理员可一次性配置多组禁止地图，提升操作效率。
2. 触发物品与操作检测
精准绑定核心触发物品：铁匠秘锤、幸运之石，同时检测两者组合使用行为，排除单一物品携带、丢弃等非加星操作的误触发。支持拓展检测同类加星道具，可手动添加道具名称或物品ID，适配服内自定义加星材料。检测范围覆盖背包内所有格子，包括快捷键使用、背包直接点击组合等多种加星操作方式，无检测盲区。
3. 惩戒机制选择设置
提供两种惩戒模式供管理员选择，支持按地图单独配置：一是强制传送模式，触发后立即将角色传送至指定安全区域（默认土城安全区，可自定义坐标），传送后保留角色背包、装备及状态不变；二是自动掉线模式，触发后立即断开角色游戏连接，再次登录时默认复活于最近安全区。两种模式可一键切换，也可针对高优先级地图（如攻城战场）设置双重惩戒。
4. 提示信息与权限管控
触发限制时弹出明确提示文本，默认内容：“当前地图禁止背包加星，即将执行惩戒操作！”，支持自定义修改提示话术与展示时长（默认2秒）。权限分级管控：普通玩家触发后直接执行惩戒，管理员可通过专属指令豁免限制，豁免权限需绑定独立密码，防止滥用。支持关闭提示信息，适配部分服内极简规则设定。
三、脚本执行流程
1. 地图与状态检测阶段
脚本启动后实时监测角色所在地图，每0.5秒同步一次地图信息，与预设禁止地图列表比对。同时持续检测角色操作行为，当检测到铁匠秘锤与幸运之石组合使用动作时，立即暂停加星操作流程，进入地图校验环节，确保触发时机精准无延迟。
2. 规则匹配与指令触发阶段
经校验确认角色处于禁止地图后，脚本自动匹配该地图预设的惩戒模式。若为传送模式，立即调用地图传送接口，锁定目标安全区域坐标，执行传送指令，传送过程耗时≤1秒；若为掉线模式，直接发送断开连接指令，同步记录触发日志，确保操作可追溯。
3. 后续状态处理阶段
传送模式执行后，脚本自动终止本次检测流程，恢复角色正常操作权限，仅当再次触发加星操作时重新启动检测。掉线模式触发后，保留触发记录至服内日志，角色重新登录后不附加额外惩罚，仅限制其在禁止地图内的加星行为，不影响其他游戏操作。
四、脚本安装与引擎适配
1. 安装路径与文件配置
将脚本文件解压后，复制至游戏安装目录的“Script”文件夹，确保文件后缀为“.txt”，兼容GEE、GOM、HERO等主流引擎。打开引擎主控面板，在“脚本管理”中勾选“地图限制背包加星脚本”，加载对应配置文件，保存设置后重启引擎即可生效，无需修改核心游戏文件。
2. 地图ID与道具ID适配
通过引擎数据库提取对应地图ID与道具ID，替换脚本内默认ID参数，确保检测精准。若为自定义地图或道具，需在脚本配置文件中手动录入名称与ID，格式为“地图名称=地图ID”“道具名称=道具ID”，多个条目用换行分隔。适配过程中可通过测试账号验证，避免ID错误导致检测失效。
3. 多引擎兼容调整
GEE引擎：开启脚本内置的“引擎适配模式”，关闭默认物品检测冲突项，确保惩戒指令正常执行；GOM引擎：在引擎参数中勾选“脚本优先执行”，避免与服内其他脚本冲突；HERO引擎：补充对应的传送指令接口，确保强制传送功能稳定落地。低版本引擎可简化脚本动画效果，避免运行卡顿。
五、脚本常用指令与维护
1. 管理员核心指令
添加禁止地图：/加星限制+地图ID/名称；删除禁止地图：/取消限制+地图ID/名称；切换惩戒模式：/惩戒模式+传送/掉线；管理员豁免：/加星豁免+密码；查询触发日志：/加星日志+日期（格式：月/日）。所有指令需在管理员频道输入，避免普通玩家误触。
2. 日常维护要点
定期核对地图ID与道具ID，当服内更新地图或调整道具时，及时同步更新脚本配置，避免检测失效。每日查看触发日志，排查异常触发情况，若出现误触发，优先检查ID匹配度与检测范围设置。每周备份一次脚本配置文件，防止误操作导致配置丢失，同时清理过期日志，释放存储资源。
六、脚本拓展场景适配
1. 分级限制规则
支持按地图重要性设置分级限制，高优先级地图（如攻城战场）执行掉线惩戒，普通禁止地图执行传送惩戒。可添加角色等级限制，例如低于指定等级的角色在禁止地图内加星，仅弹出提示不执行惩戒，适配新手保护规则。
2. 活动地图临时适配
预留活动接口，当服务器开启临时活动时，自动添加活动地图至禁止列表，活动结束后自动移除，无需手动调整。支持定时开启/关闭限制规则，例如仅在周末攻城时段启用限制，其余时间解除管控，适配服内运营节奏。
3. 多道具组合检测
拓展检测范围，支持添加多种加星道具组合，例如同时检测铁匠秘锤+幸运之石、强化石+祝福油等不同加星材料组合，实现全品类加星操作管控。可自定义排除部分道具组合，保留特定场景下的合规加星权限。
