【免费下载链接】neuro-sdkNeuro SDK API for allowing Neuro to play games项目地址https://gitcode.com/gh_mirrors/ne/neuro-sdk点击查看免费下载Neuro SDK 是官方开源的 AI 游戏接入开发工具包它通过 WebSocket 协议让 AI 角色Neuro-sama实时操作你的游戏——从 Inscryption 的卡牌博弈到赛博朋克2077 的开放世界探索共 6 款风格迥异的游戏都已成功接入。本文将带你搞懂它的通信原理、官方 SDK 用法和 0 成本本地联调技巧帮你快速让自己的游戏也听得懂 AI。 30 秒看懂Neuro SDK 是什么先说结论Neuro SDK 一套消息协议 两个官方引擎 SDK 配套测试工具。API 规范定义游戏与 AI 之间通过 WebSocket 收发的 JSON 消息详见 SPECIFICATION.md官方 SDKUnity SDKC#与 Godot SDKGDScript两者接口思路完全一致开源示例6 款不同玩法的游戏接入案例见下文清单测试工具Randy 机器人本地模拟 AI 行为不用真 AI 也能联调 官方 SDK 最初为回合制游戏Inscryption、Liars Bar、Buckshot Roulette优化。高 APM 的操作类游戏需要 AI 只负责高层决策再由游戏内系统执行底层操作才能玩得好。⚡ 核心原理游戏如何与 AI 对话所有魔法都发生在这 5 类消息里完整定义见 SPECIFICATION.md方向命令通俗解释游戏 → AIstartup开局第一句游戏启动啦同时清空旧动作游戏 → AIactions/register给你注册几个我能做的事出牌、移动、使用物品…游戏 → AIactions/force轮到你了必须立刻从这几个动作里选一个AI → 游戏actionAI 做出选择发回动作名和 JSON 参数游戏 → AIaction/result收到执行成功/失败——必须尽快回否则 AI 会一直干等辅助命令还有context同步游戏内发生的事情给 AI 看、actions/unregister下架动作。 关键设计ActionWindow动作窗口回合制游戏最核心的抽象。SDK 把临时动作 强制 AI 行动 自动清理打包成一个窗口生命周期只有 4 种状态Building→Registered→Forced→Ended。你的回合开始创建窗口、加入动作如play_card、强制 AI 立即决策AI 选完SDK 自动验证Validate、回结果action/result、执行Execute并注销动作两个 SDK 的完整时序图mermaid可对照阅读Godot USAGE.md、Unity USAGE.md⚠️新手第一坑AI 可能在你没强制之前就抢跑发出动作。所以动作处理器必须随时待命不能只在actions/force之后才监听。官方最佳实践见 API/README.md 的 Actions 指南其中 ActionWindow.cs 是公认的教科书级实现。 实战案例6 款风格迥异的游戏如何接入README.md 中列出了 6 个官方开源集成项目覆盖了完全不同的游戏类型——这正是6 种风格迥异的出处游戏类型接入方式为什么适合 AIInscryption卡牌 / 叙事恐怖官方 SDK 深度定制典型回合制动作天然离散化Slay the Spire 2Roguelike 卡牌社区开源集成每张手牌就是一个可注册动作Buckshot Roulette心理博弈小游戏参考源码reference动作极少抽/开/换弹教科书级案例Hollow Knight2D 动作银河城Mod 注入AI 负责高层目标系统处理底层操作Cyberpunk 2077开放世界 RPGMod 注入高自由度高 APM考验分层设计Pokémon Platinum主机模拟器模拟层适配回合制战斗天然契合共同规律能被文本描述状态 文本接收动作的游戏最适配。官方点名表现好的还有 Uno、Monopoly、《Keep Talking and Nobody Explodes》以及大多数视觉小说清单见 README.md。️ 两套官方 SDK选型与快速上手Unity SDKC#适用Unity 原生开发2022.3 测试、WebGL 构建、以及Mono / IL2CPP 改造游戏的 Mod 注入通过 NuGet 包VedalAI.NeuroSdk.Unity分发见 Unity/NuGet/接入方式拖NeuroSdk预制体到首场景填游戏名推荐或调用NeuroSdkSetup.InitializeMod 环境唯一方式见 NeuroSdkSetup.csWebGL 专属压缩格式设为 Gzip并用 Web Game Runner/server.py 在/$env/NEURO_SDK_WS_URL路径下发 WebSocket 地址Godot SDKGDScript适用Godot 4.x 原生项目可直接从 Godot 资源库安装三步配置启用插件Project Project Settings Plugins勾选Neuro SDK在 neuro_sdk_config.gd 中设置game变量为你的游戏名设置环境变量NEURO_SDK_WS_URL指向 WebSocket 地址 内置教学示例井字棋两个 SDK 各带一个完整的 Tic Tac Toe 示例是新手的最佳起点Unity 版TicTacToe.cs、Tic Tac Toe.prefabGodot 版tic_tac_toe.gd、play_o_action.gd核心套路只有几行回合开始时ActionWindow.SetForce(0, It is your turn...)强制 AI 出招.AddAction(...)挂上play_o动作.Register()注册生效——完整代码对照 Godot USAGE.md 与 Unity USAGE.md。 0 成本联调用 Randy 机器人自测没有 AI 也能测Randy 是一个随机选动作的 WebSocket 服务器本地模拟 AI在Randy目录执行npm install再npm start将游戏/SDK 的 WebSocket 地址指向ws://localhost:8000用 HTTP POST 到localhost:1337手动注入消息如模拟 AI 执行join_friend_lobby验证你的游戏能否正确处理⚠️ Randy 不会模拟乱发脏数据不强制就抢跑等 AI 的真实毛刺所以 API/README.md 中列出的竞态条件防护依然要做。✅ 新手接入清单通读 API/SPECIFICATION.md理解 5 类核心消息跑通官方井字棋示例Unity / Godot 任选用 Randy 把startup → register → force → action → result全链路走通给 AI 写清楚每个动作的description和 JSON schema——这些文字会被 AI 直接读到描述质量决定 AI 发挥一次性动作如出牌执行后立即unregister防止 AI 重复调用关注 CHANGELOG.md新增的priority参数low/medium/high/critical可控制 AI 说话被打断的紧急程度做语音直播联动时很有用写在最后Neuro SDK 的精髓在于把游戏状态翻译成文本、把玩家操作翻译成动作。只要你的游戏状态可以文字描述、动作可以离散化AI 就能上手玩——这正是它横跨卡牌、Roguelike、动作、开放世界、模拟器这 6 种风格游戏的底层原因。从井字棋示例出发你的下一步可能是让 AI 玩自己正在开发的那个游戏 赞分享【免费下载链接】neuro-sdkNeuro SDK API for allowing Neuro to play games项目地址https://gitcode.com/gh_mirrors/ne/neuro-sdk点击查看免费下载相关推荐如何彻底掌控你的赛博朋克2077游戏体验还在为夜之城的挑战感到束手无策想要重新规划角色发展路径却不想从头开始专业级的存档编辑器正是你需要的解决方案。这款强大的工具让你完全掌控游戏进度轻松解决各种桌面应用逆向工程Whisky游戏数据库实战80款3A游戏兼容配置一键应用Mac畅玩赛博朋克2077Whisky游戏数据库实战80款3A游戏兼容配置一键应用Mac畅玩赛博朋克2077 Whisky 是一款为 macOS 打造的现代 Wine 封装工具活移动端畅玩《赛博朋克2077》Winlator模拟器终极优化指南移动端畅玩《赛博朋克2077》Winlator模拟器终极优化指南 你是否曾梦想在手机上体验夜之城的霓虹光影作为CDPR的开放世界杰作《赛博朋克2077》对虚拟化移动开发上一篇终极Home Manager安全自查清单保护你的Nix用户环境下一篇彻底解决spotDL Docker镜像yt-dlp版本冲突从根源修复到无缝升级创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
