1. Unity 自定义鼠标指针为什么总对不上位置在 Unity 里做画笔、瞄准镜、拖拽手柄这类交互时系统默认箭头往往不够用于是大家都会想到Cursor.SetCursor。这个 API 本身不复杂签名就三个参数一张Texture2D、一个Vector2热点、一个CursorMode。但真正上手后你会发现指针要么整体偏移要么在编辑器里正常、打包后错位要么热点怎么调都差几个像素。问题的根源在于Cursor.SetCursor的第二个参数不是「图片中心」而是「热点在图片坐标系里的位置」而 Unity 的图片坐标系原点在左上角Y 轴向下。很多人凭直觉写Vector2.zero以为是把图片左上角对准鼠标结果笔尖朝左下角的画笔就会出现「线条画在笔尖上方」的诡异现象。再叠加CursorMode.Auto与ForceSoftware的差异、Texture2D导入设置里的 Read/Write 与压缩格式坑就更多了。这篇内容聚焦三件事把Cursor.SetCursor的热点算法讲透给出CursorMode切换的验证方法以及用 TaoToken 统一 Key 把 AI 工具侧Cursor、Claude Code 这类编码助手的配置一次接好让你在编辑器与运行时都能稳定复现指针位置。适合正在做 Unity 工具链、又想让 AI 辅助写代码的开发者。2. 先把 TaoToken 的 Key 和通道准备好在写 Unity 代码之前先把 AI 工具侧的通道打通这样后面调Cursor.SetCursor时可以让编码助手直接帮你生成和排错。TaoToken 提供统一的 Key 和 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个不加 UTM。你需要先拿到一个 API Key入口在控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到之后不同工具的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 模型对话调试可以用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。注意Key 只放在本地配置文件或环境变量里不要提交到 Git 仓库也不要在截图里露出完整字符串。如果你主要用 Cursor 写 Unity 脚本走 Coding Plan 更划算入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。下面给出两份可直接复制的骨架配置。2.1 settings.json 骨架Cursor 侧{ aiProvider: { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-替换成你自己的Key, model: claude-sonnet-4-20250514 }, unity: { cursorHotspotDebug: true, defaultCursorMode: Auto } }把apiKey换成控制台里生成的那串baseUrl保持https://taotoken.net/api即可。unity这一段是我自己加的调试开关用来在编辑器里打印热点坐标后面会用到。2.2 config.toml 骨架Claude Code / 终端侧[provider] name taotoken base_url https://taotoken.net/api api_key sk-替换成你自己的Key model claude-sonnet-4-20250514 [unity] cursor_debug true hotspot_log Assets/Logs/cursor_hotspot.logClaude Code 的接入方式在文档里有专门一节地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 照着填base_url和api_key就行。配置好之后你让助手生成Cursor.SetCursor相关代码时它就能基于当前上下文给出更贴合 Unity 版本的建议。3. Cursor.SetCursor 热点算法与可复制代码Cursor.SetCursor(Texture2D texture, Vector2 hotspot, CursorMode cursorMode)三个参数里最容易错的是hotspot。它的含义是鼠标的「实际点击点」落在图片的哪个像素位置坐标以图片左上角为原点X 向右、Y 向下。拿一张 32×32、笔尖朝左下角的画笔图片举例。笔尖在图片的左下角对应坐标是(0, 32)因为 Y 从顶部往下数底部就是 32。如果你写Vector2.zero等于告诉 Unity「点击点在左上角」于是画出来的线条就会出现在笔尖上方视觉上就是错位的。using UnityEngine; public class PaintCursorController : MonoBehaviour { [SerializeField] private string cursorResourcePath Cursors/paint_brush; [SerializeField] private Vector2 hotspot new Vector2(0f, 32f); [SerializeField] private CursorMode cursorMode CursorMode.Auto; private Texture2D _cursorTexture; void Start() { _cursorTexture Resources.LoadTexture2D(cursorResourcePath); if (_cursorTexture null) { Debug.LogError($未找到鼠标贴图: {cursorResourcePath}); return; } ApplyCursor(); } public void ApplyCursor() { Cursor.SetCursor(_cursorTexture, hotspot, cursorMode); Debug.Log($Cursor 已设置 hotspot{hotspot} mode{cursorMode} size{_cursorTexture.width}x{_cursorTexture.height}); } void OnDestroy() { Cursor.SetCursor(null, Vector2.zero, CursorMode.Auto); } }热点换算有个通用公式假设图片宽w、高h你想让热点落在图片的某个相对位置(rx, ry)其中rx、ry取值 0 到 1那么Vector2 hotspot new Vector2(rx * w, (1 - ry) * h);比如热点在图片正中心rx 0.5、ry 0.532×32 的图就是(16, 16)。热点在左下角rx 0、ry 0得到(0, 32)。这个公式能帮你避免每次手动数像素。3.1 CursorMode 到底选哪个CursorMode有两个值Auto和ForceSoftware。Auto会让 Unity 尽量用硬件光标性能好但部分平台对光标尺寸有限制常见是 32×32 或 64×64超尺寸可能被缩放甚至不显示。ForceSoftware强制用软件渲染光标尺寸不受限、支持动画但会带来额外的绘制开销且在某些全屏模式下可能和硬件光标行为不一致。模式适用场景注意点CursorMode.Auto常规指针、尺寸在平台限制内超尺寸会被缩放热点随之偏移CursorMode.ForceSoftware大尺寸、动画光标有绘制开销需确认目标平台支持实测下来如果你的画笔贴图是 32×32Auto就够了一旦换成 64×64 以上建议切ForceSoftware并同步检查热点是否还准。4. Texture2D 导入设置与验证请求热点算对了如果Texture2D的导入设置不对照样会错位。关键几项Texture Type设为Cursor或Default不要用Sprite否则可能被图集打包改变尺寸。Read/Write Enabled在需要运行时读取像素时打开纯显示可以关。Compression选None压缩格式可能改变实际像素尺寸导致热点偏移。Non-Power of 2设为None避免 Unity 自动缩放贴图。验证动作可以这样写在编辑器里运行移动鼠标到画面某个已知坐标打印Input.mousePosition和热点观察线条落点是否与笔尖重合。void Update() { if (Input.GetMouseButtonDown(0)) { Vector3 world Camera.main.ScreenToWorldPoint(Input.mousePosition); Debug.Log($鼠标屏幕坐标{Input.mousePosition} 世界坐标{world} 当前热点{hotspot}); } }如果发现线条始终偏移固定像素多半是热点算错如果偏移量随分辨率变化检查Texture2D是否被缩放。用 TaoToken 的模型对话通道 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 可以把报错日志贴进去让模型帮你定位是热点问题还是导入问题。5. 本篇常见错排查热点写成图片中心最常见。记住热点是「点击点」在图片里的位置不是图片中心除非你确实想让中心作为点击点。Y 轴方向搞反Unity 图片坐标 Y 向下很多人按数学坐标习惯写(0, 0)当左下角实际左下角是(0, height)。编辑器正常、打包后错位多半是CursorMode.Auto在目标平台对尺寸做了缩放切ForceSoftware或把贴图压到平台限制内。贴图被压缩改变尺寸导入设置里Compression不是None或者Non-Power of 2选了缩放都会让实际像素和预期不符。忘记在销毁时重置光标场景切换后旧光标残留OnDestroy里调Cursor.SetCursor(null, Vector2.zero, CursorMode.Auto)复位。Resources 路径大小写不一致Resources.Load在部分平台区分大小写路径写错会返回 null加个判空日志能快速发现。6. 把 AI 工具侧和 Unity 侧一起收尾Unity 里Cursor.SetCursor的坑九成集中在热点坐标和Texture2D导入这两处。把热点公式(rx * w, (1 - ry) * h)记住导入设置里压缩选None、尺寸保持 2 的幂基本就能稳定复现。CursorMode按贴图尺寸选小图Auto、大图ForceSoftware。AI 工具侧这边Key 和通道用 TaoToken 统一接好之后让编码助手帮你生成热点换算代码、审查导入设置效率会高不少。长期写 Unity 工具链的话Coding Plan 入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite Key 在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。配置填好后先跑一次ApplyCursor看控制台打印的 hotspot 和贴图尺寸对不对再进游戏验证落点比反复猜要快得多。
