简介《原始传奇》UO专属的 TUS 全站脚本是一套免费提供的 C/C 自动化扩展集合面向追求高效操作的玩家与希望深入游戏脚本机制的开发者。它围绕移动、战斗、交易、任务等核心玩法提供自动化支持并通过 ini 配置文件开放参数调节用户可根据服务器版本 12.6.0.4 的实际环境灵活适配。压缩包内共 113 个文件其中 scp 脚本构成主要逻辑框架txt 说明文件辅助理解配置htm 网页用于展示角色状态log 日志记录运行过程chm/help 文档提供参考帮助整体体积仅 1.12MB便于下载部署。除了常用的菜单、地图、物品、技能定义外还附带了状态显示和聊天快捷功能玩家能据此快速构建个人专属的操作界面。目前已有 5092 人学习/下载对有 C/C 基础或希望自定义 UO 玩法的用户这套脚本提供了扎实的参考资料和可直接运行的基础框架。1. 为什么我会把这份TUS脚本从硬盘角落翻出来某天凌晨两点游戏角色在矿洞里挂着挖矿我迷迷糊糊看了一眼屏幕发现角色站在原地发呆聊天框刷出一排同一条报错。那一瞬间我意识到TUS脚本崩了。这套当年用C/C写的TUS脚本是给某款老牌网络游戏做自动化操作用的UO脚本集合从角色移动、战斗、拾取到状态监控全靠一个exe加一堆scp文本文件撑着。折腾到天亮我才修好但也因此决定把整套资源的文件构成、启动方式、常见坑和二次开发思路完整整理一遍。如果你手上有这份TUS脚本但不知道从哪个文件开始看或者跑起来之后总出幺蛾子这篇笔记就是给你写的。2. 看懂文件组成TUS到底由哪几个部分协作2.1 文件角色速查哪一个是引擎、哪一个是配置第一次拿到解压包的人最容易懵里面既有exe又有chm、hlp、htm还有一堆没有扩展名或者看起来像杂物的文件。但拆开看这套TUS的职责分层非常清晰。我把输入里列出的文件逐个标了一下角色方便你拿到手就能对号入座文件角色实际作用tusSvr.exe引擎主体读取配置、加载脚本、与游戏客户端交互的入口程序tus.ini总配置入口控制引擎启动参数、脚本加载路径、日志级别、热键绑定TUShelp.chm编译版帮助文档离线手册查函数和脚本语法用HOG.HLP辅助帮助文件老式WinHelp格式部分老玩家习惯看这个webpage1.htm状态页模板状态页的HTML结构模板webpage2.htm状态页辅助页状态页里的样式或附加信息页tusstatusbase.htm状态页成品壳引擎把角色实时数据填充进去后展示用tusitem.scp物品交互脚本处理拾取、使用、丢弃、识别物品ID等逻辑tus1140426.log运行日志日期命名的日志文件记录脚本执行轨迹与报错这里有个容易忽略的点日志文件名tus1140426.log和tus1140427.log看名字就知道是带日期的滚动日志。也就是说这份资源在归档之前是被人实际跑过的而且至少跨了两天运行。日志不是单纯凑数的文件后面排错时它就是第一手线索。至于tus.ini、tusitem.scp这类文件名的同类兄弟比如菜单、地图、定义表之类的scp可能因为打包时取舍没有全列在清单里但只要有tusSvr.exe和tus.ini在整套脚本的骨架就还在。2.2 三层协作模型exe读ini、ini调scp、scp写日志TUS这套脚本你能改的部分跟需要编译的部分是分开的这是它最让人舒服的设计。我一般会把它理解成一个三层结构第一层是tusSvr.exe一个可执行引擎它负责跟游戏客户端通信比如读取游戏窗口的内存数据、模拟键盘鼠标操作、拦截游戏发来的网络消息。这一层你改不了也不需要你看懂C源码只要知道它是个黑匣子输入是配置和脚本输出是游戏内的行为和日志文件。第二层是tus.ini它是唯一让引擎知道“该干什么”的入口。ini里面写明了要加载哪些scp文件、延迟多少毫秒、日志写到什么级别、热键绑在哪个键上。引擎启动时先读ini然后按ini里的指示去找对应的scp文件。第三层是那些scp文本脚本它们才是你真正能自由发挥的部分。scp里写的是类似宏命令的指令序列引擎负责按行解析并执行。之所以把逻辑放在scp而不是编译进exe就是让你改行为时不用重新编译——这个设计在当年脚本圈里是通用做法好处是迭代快坏处是语法错误得靠日志自己排查。日志则是整个模型的闭环出口。引擎每执行一条关键指令就往日志里写一行。挂机挂了几个小时出了问题你打开最新那个日期的日志文件拉到报错点附近基本就能定位到是哪个scp哪一行出的事。2.3 tus.ini参数速览与修改原则tus.ini是整套脚本的钥匙。我不建议你上来就改一堆参数先打开看一眼结构确认几个关键项即可。典型的tus.ini内容大致长这样; TUS 主配置示例 [Client] PathC:\Game\Client.exe Version12.6.0.4 [Script] Menutusmenu.scp Defstusdefs2.scp Itemtusitem2.scp Maptusmap.scp [Status] Port8080 Pagetusstatusbase.htm [Log] Level2 Filetus1140426.log上面这个示例综合了常见做法的配置项结构具体文件名和字段请以你解压出的实际tus.ini为准。重点看几个地方Path对应游戏客户端exe的完整路径Version是适配的客户端版本号Script段下面列出的每个scp文件会被引擎逐一加载Status段里的Port是状态页服务的监听端口Page指定填充数据用的HTML模板Log段的Level控制日志详细程度从0到3数字越大越啰嗦。改这个文件的原则就一条一次只改一个参数改完单独启动验证一次。千万别同时改路径、端口、日志级别出了问题你根本不知道是哪一项导致的。另外路径里尽量不要带中文和空格虽然现代系统能容忍但老脚本引擎经常在这上面翻车后面避坑章节我会再强调。3. 部署与首次启动把文件放对位置再开引擎3.1 目录结构与版本对应关系拿到资源包之后第一步不是双击tusSvr.exe而是先检查目录完整性。常见做法是在某个干净的目录下解压比如D:\TUS然后把压缩包里的文件按原结构释放出来。接着确认几个关键文件都在同一个根目录下tusSvr.exe、tus.ini、webpage1.htm、webpage2.htm、tusstatusbase.htm、至少一个scp文件。如果缺了tus.ini引擎会用内置默认值启动大概率行为不可控缺了htm文件状态页功能就白搭。版本对应关系是这个环节最容易踩的坑。资源描述里提到的游戏版本号是脚本适配和测试过的目标版本如果你本地的游戏客户端版本跟它对不上引擎可能能启动但读内存地址和识别消息包时会错位表现出来就是角色乱跑、捡不起来东西、菜单弹不出。所以部署前先确认自己客户端的版本号再决定是用这份脚本还是找匹配版本的资源。我一般还会做一件事把原始目录完整复制一份改名加后缀_bak比如D:\TUS_bak。这不是多此一举后面你改scp改坏了或者ini改得启动不了直接拿备份覆盖回去就是后悔药。有人说反正能重新解压但实操中你会发现原压缩包可能已经被你放到看不到的角落了而且解压出来再手动改一遍配置更浪费时间。3.2 修改tus.ini的五个关键位置确认版本匹配之后打开tus.ini从一堆参数里挑这五个地方来改其余的先不动。这是我在多次部署中总结出来的最小必改清单覆盖了从路径到页面的闭环。第一[Client]段的Path改成你本机游戏客户端的实际路径。这个最关键路径错了引擎连客户端都找不到。第二Version字段确认跟你客户端版本一致不确定就暂时不改启动后看日志有没有版本不匹配的警告。第三[Log]段的Level第一次调试建议设成2或3虽然日志写得勤但你能看到脚本每一步在干什么跑稳定了再调回0或1减少磁盘写入。第四[Status]段的Port默认8080如果你本机这个端口被其他程序占了就改成8081或9080记住改完的端口号等下要访问状态页。第五检查[Script]段里列出的scp文件是否都在根目录下路径只写文件名即可引擎会从exe所在目录找如果scp放在子目录这里要写相对路径。这五处改完保存注意编码格式。老脚本引擎对ini的编码很敏感最好保存成ANSI或GBK别用带BOM的UTF-8否则第一行注释可能直接把引擎带崩。这一点百分之九十的新手都不知道等你在启动阶段遇到莫名其妙的“闪退”时优先怀疑编码问题。3.3 先开游戏还是先开引擎启动顺序这块TUS跟很多现代辅助工具不一样它不是那种把脚本注入已运行进程的类型而是引擎主动去连接游戏客户端。我实际操作下来最稳妥的顺序是先手动启动游戏客户端进到登录界面或者人物选择界面然后再启动tusSvr.exe。如果先启动引擎再开游戏引擎可能在等待连接时超时日志里会留下一条连接失败记录虽然有时它能自动重连但我见过不少版本没有重连逻辑挂久了就直接退出。验证引擎是否跟客户端建立了联系看两方面。第一看tusSvr.exe的窗口标题或者控制台输出正常时会显示类似“已连接”或“初始化完成”的状态第二看最新日期的日志文件尾部应该有加载scp清单的记录。用命令行确认引擎在跑也很方便tasklist | findstr tusSvr这条命令会列出所有名字里带tusSvr的进程如果有输出说明引擎还活着没有输出说明它启动后立刻退出了。此时优先检查ini编码和路径配置。状态页是另一个验证入口。浏览器打开http://127.0.0.1:8080端口按你ini里填的实际值如果能看到网页1或者网页2的内容说明引擎的HTTP服务和状态页模板都正常。这里是玩家血条的实时回显正常时角色站立不动状态数值也会定期刷新如果页面打开但数字一直不变说明脚本逻辑没跑起来问题多半在scp加载环节。4. 核心SCP脚本解析菜单、定义、物品与地图如何联动4.1 tusmenu.scp操作入口与界面挂接菜单脚本是整套脚本里你最先接触到的东西。当你按下某个热键弹出TUS的操作菜单那些条目背后就是tusmenu.scp在响应。它做的事可以用一个伪代码逻辑概括热键触发 - 引擎读tusmenu.scp - 查表找到对应功能 - 执行功能名下挂的动作序列。假设tusmenu.scp里有这样一段用类似宏的语法描述MENU_BTN 挂机挖矿 ACTION move x1200,y800 ACTION mine count50 ACTION move back END_MENU这段示意代码表示菜单里有个“挂机挖矿”按钮点击后先移动到某个坐标执行挖矿动作50次再返回。修改时你要注意菜单名跟动作条件之间是严格配对的你改了显示名就要检查对应的动作块还在不然菜单能弹出来但点下去没反应。这类脚本没有可视化调试器确认菜单是否生效的唯一办法就是进游戏按热键弹出来点了看日志。4.2 tusdefs2.scp与tusitem2.scpID到行为的映射定义文件和物品脚本是TUS里最绕也最实用的一对。grep一下旧脚本的写法你会发现defs文件本质是张ID映射表把游戏里的物品ID、技能ID、NPC类型ID翻译成脚本能识别的名字。而tusitem2.scp才是真正的逻辑处理者它根据defs里的定义决定遇到某个ID的物品时是捡、是跳过还是使用。常见做法是在defs2里给某类物品起一个可读名字然后在item2脚本里用条件分支处理。比如逻辑上会是这样CHECK_ITEM gold IF quantity 100 ACTION pickup ELSE ACTION skip ENDIF END_CHECK这段示意代码表达的是检测到名为gold的物品时数量大于100就捡起来否则跳过。这里有个隐藏注意点不同游戏服务端的物品ID可能不一样这份脚本基于某个特定版本定义换服之后ID对不上脚本会识别不了物品。这时候你打开日志里面会刷“unknown item id”之类的提示你需要把目标服务器的实际ID替换进defs文件。查ID的方法通常是查看游戏客户端内的物品信息或者抓一次正常拾取时的日志输出里面有引擎识别到的原始ID。4.3 tusmap.scp坐标、区域与寻路地图脚本负责的是移动逻辑包括从A点到B点的路径点序列、挂机区域的范围划定、以及卡住后的绕过策略。如果tusmap.scp写得稀烂表现就是角色走到墙角就不动了或者在两个点之间反复横跳。典型的地图脚本片段思路是维护一个路径点列表引擎按顺序执行移动指令ROUTE_START 矿区入口 WAYPOINT x1000, y700 WAYPOINT x1050, y720 WAYPOINT x1100, y750 ROUTE_END这个示例里WAYPOINT就是路径关键点的坐标。修改时要注意坐标的基准TUS用的坐标是游戏内的世界坐标还是区块内偏移直接决定你写的数字对不对。最简单的验证方式是人为走到目标位置打开状态页或者用日志输出当前坐标跟脚本里的点对比差太多就说明基准选错了。另外路径点之间要有合理的间距间隔太密脚本走起来一顿一顿的太疏则容易撞墙或者被地形卡住要加中间过渡点。4.4 日志与状态页验证脚本是否按预期走你手头的tus1140426.log、tus1140427.log是现成的滚动日志范本说明这套脚本的日志机制是每天一个文件。调试时我习惯先查看今天日期的日志文件确认脚本加载列表和初始化状态。如果发现某个scp文件名出现在日志的“加载失败”附近那原因无非两个文件不存在或者文件内有语法错误。状态页的作用则是把日志没法直观表达的信息可视化。tusstatusbase.htm是数据填充用的模板引擎会把角色生命、法力、坐标、当前动作等动态数据填进去刷新浏览器就能看到最新状态。我看状态页的习惯是每隔十几秒刷新一次观察数值是否随时间变化如果数值一直冻结说明脚本主循环已经停了这时候回日志找最后的有效执行记录十有八九是卡在某个等待条件上。5. 常见问题与避坑TUS跑不起来的五个细节5.1 启动tusSvr.exe后窗口一闪而过现象双击引擎exe窗口还没看清就消失了进程列表里也没有它。原因不是exe坏了就是ini配置有问题读不下去最常见的三个因素分别是ini保存成了UTF-8带BOM格式、[Client]路径写错导致引擎初始化失败、缺少关键依赖文件。解决先把tus.ini用记事本另存为ANSI编码检查Path指向的文件确实存在确保TUShelp.chm和HOG.HLP还在目录里某些老版本引擎启动时会加载帮助文件作为资源库缺了就主动退。改完这三处再启动问题基本消失。5.2 状态页打不开或者只出空白页面现象浏览器访问http://127.0.0.1:端口要么连接被拒绝要么页面空白。原因端口被其他程序占了或者html模板跟引擎的填充规则对不上。解决先换端口把ini里的Port改成8081再重启引擎空白页则注意访问的是不是webpage2.htm对应的地址有些版本状态服务有两个页面入口一个给你看状态一个给你看配置。直接在浏览器里把webpage1.htm改成实际文件名访问能打开就说明服务本身活着问题在模板路径配置。5.3 挂机挂到一半角色突然定住不动现象日志停在某条命令之后角色就再没有新动作了。原因最常见是地图脚本里当前路径点无法到达比如被其他玩家放的障碍物挡住或者目标点在墙体内其次是脚本在等待一个条件比如“等血量回满”但周围没有安全回血点。解决先看日志最后几行确认停在哪条action上。如果是移动卡住给map脚本该路线加一个绕行中间点如果是等待条件卡住把等待超时参数从无限改成30秒超时后执行备用动作或直接回城。这类问题没有一劳永逸的办法只能定期扫日志。5.4 改完ini或者scp后启动还是老行为现象你明明改了脚本重启引擎后行为跟改之前一模一样。原因引擎进程没退干净旧实例还占着配置和脚本文件新启动的进程可能因为端口冲突启动失败你看到的还是旧实例在跑。解决改完配置后打开任务管理器确认所有tusSvr相关进程都结束了再重新启动。从那次翻车之后我养成了一个习惯每次改配置前先杀进程改完再启动宁可多花十秒不赌它自己干净退出。5.5 日志文件增长快得吓人磁盘空间被吃光现象logs目录下几天就积累了好几百MB日志C盘空间告急。原因日志级别设成了最高而且脚本循环频率很高每个动作都写一行自然爆炸。解决把ini里Log段的Level降下来稳定运行时设成1只记录错误和关键节点同时定期归档或删除超过七天的旧日志。日志不是越多越好它只是工具出问题时能定位就行平时让硬盘清净点比什么都强。6. 进阶用最小改动原则做自己的TUS功能扩展想给TUS加一个自己的功能最怕的就是大改。我摸索出来的稳妥路径是“最小改动、单点验证、随时回滚”。第一步改之前先把要动的scp复制一份命名带上当天日期比如tusmap.scp.bak_0428。这不是走形式有一天我改map脚本时手滑删了一个逗号整个路径表解析中断角色在矿区入口原地发呆。当时没有备份只能靠印象把删掉的那行补回来前后折腾了半小时才恢复。从那以后我每次改scp都先复制一份带日期的备份成本十秒钟省下的是半小时的返工。第二步一次只改一个功能块。比如想改“挖矿结束后回城补给”的逻辑就只动tusmenu.scp里对应的动作块其他菜单项一概不碰。改完保存启动游戏和引擎按热键触发一次看日志确认这一步执行到位。然后再改下一个点。第三步维护一份自己的回归验证清单。每次改动之后我按固定顺序过一遍引擎能不能启动状态页能不能打开且数值刷新主菜单能不能弹出某个核心动作能不能执行日志接不接受新事件。这张表不用很复杂五到六个检查点足够。它最大的价值不是功能测试而是让你在改坏之后第一时间知道坏在哪一环不用从零查起。最后分享一个实用小技巧在scp里加临时日志行。调试时我会在关键的判断分支处插入一条类似“当前执行到XX分支”的日志语句跑一轮看输出顺序确认逻辑走向符合预期验证完再把这些临时日志删掉。这种方法比盯状态页直观得多尤其适合处理那种“看起来没反应但也不知道卡在哪”的情况。希望这篇拆解能帮你把手上的TUS脚本真正跑起来。本文还有配套的精品资源点击获取