LPC 开发工具完整配置手册

第一部分：LPC-Server-UPDATE MUD 工具

1. 插件概述

• 插件市场链接：LPC-Server-UPDATE MUD
• 核心功能：实现代码修改后自动执行游戏内update命令

2. 安装与初始化

配置步骤：

1. 使用VSCode打开lib目录
2. 点击插件"连接服务器"按钮
3. 填写配置弹窗：
   • 地址：本地开发填127.0.0.1，远程填服务器IP
   • 端口：游戏实际运行端口
   • 巫师账号：专门创建的具有update权限的账号
   • 密码：对应账号密码

3. 配置文件详解

路径：/.vscode/muy-lpc-update.json

{
  "host": "localhost",          // 服务器地址
  "port": 12345,               // 游戏端口
  "username": "test",          // 巫师账号
  "password": "testcc",        // 账号密码
  "rootPath": "\\liblist",     // lib根目录名
  "serverKey": "buyi-SerenezZmuy", // 客户端验证密钥
  "encoding": "UTF8",          // 编码格式(UTF8/GBK)
  "loginKey": "buyi-ZMuy",     // 登录密钥
  "emailRequired": false       // 是否需邮箱验证
}

需要有巫师权限的账号，并且保证账号已经创建好角色。 此配置完全保存在本地，没有任何上传等操作。 插件完全开源，可随时检查插件源码。

4. 功能区域完整说明

4.1 配置更改区

• 登录KEY：对应ZJMUD.h中的ZJKEY值
• 编码切换：UTF-8与GBK互相转换
• 邮箱验证：控制登录是否检查邮箱

4.2 指令执行区

• 编译当前文件：执行update 当前文件路径
• 编译目录：执行updateall 目录路径（如输入/d执行updateall /d）

4.3 自定义功能

• 添加命令：

  1. 命令名称：如"测试"
  2. 执行指令：如"testcmd"

     // testcmd.c示例
     int main(object me, string arg) {
     debug_message("在线玩家：" + sizeof(users()));
     return 1;
     }

• 添加eval：

  1. 名称：如"查询经验"
  2. 执行代码：me->query("exp")

     需确保游戏内有修改后的eval命令：

     write(sprintf(ESC+"MUY%O║\n",filename->eval(me)));

4.4 服务器控制

• 重启命令：执行shutdown立即重启
• 连接状态：显示当前登录状态

5. 客户端验证解决方案

修改logind.c文件：

// 在原验证条件前添加：
if(arg!=sha1("buyi-SerenezZmuy")&&原验证条件){
    write("客户端非法\n");
    destruct(ob);
    return;
}
// 配置文件中serverKey需与此处一致

---

第二部分：LPC语言支持插件

1. 插件概述

• 插件市场链接：LPC Language Support
• 核心功能：
  • 代码自动补全
  • 函数参数提示
  • 快速跳转定义
  • 语法错误检查

2. 配置文件设置

路径：/lpc-config.json

{
    "driver": {
        "type": "fluffos",     // 驱动类型
    },
    "libFiles": {
        "mudlidDir": "e:/lib-master/",  // 绝对路径
        "master": "/adm/single/master.c",
        "simul_efun": "/adm/single/simul_efun.c",
        "global_include": "/include/globals.h",
        "player": "/clone/user/user.c"
    },
    "libInclude": [
        "/include",           // 标准头文件目录
        "/mudcore/include"    // 框架目录（可选）
    ],
    "diagnostics": "off",     // 建议关闭严格检查
    "exclude": [             // 排除目录
        ".vs", ".vscode",
        "curl", ".git",
        "/backup", "/binaries"
    ]
}

3. 功能演示

3.1 代码补全

3.2 自定义提示

// 在头文件中添加注释可增强提示：
/*
 * @function 测试函数
 * @param a: 参数1说明
 * @param b: 参数2说明
 * @return: 返回值说明
 */
int test_func(int a, string b);

4. 高级配置技巧

• 类型定义：在头文件中使用typedef提升补全准确率
• 宏定义：通过#define注释增强提示

  /*
  * @macro MAX_LEVEL
  * @desc 最大等级限制
  */
  #define MAX_LEVEL 100

---

第三部分：联合使用建议

1. 推荐工作流

1. 使用LPC插件编写代码
2. 通过Server-UPDATE插件即时编译
3. 利用eval功能快速测试

2. 环境配置方案

方案	适用场景	注意事项
Remote-SSH	高性能服务器	需要2GB+内存
SFTP同步	低配置服务器	需设置自动上传
本地开发	单机环境	无需特殊配置

3. 常见问题排查

• 编译失败：检查巫师账号权限
• 连接超时：确认防火墙设置
• 补全失效：检查lpc-config.json路径配置

技术支持：QQ 279631638
更新日期：2025年5月21日