CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
高级技巧语法算法996引擎

Lua坐标换算:世界坐标与屏幕坐标的三次变换

2026-09-28 01:15 作者:996 技术组 996引擎Lua教程传奇脚本高级技巧语法算法996引擎

【语法算法】
一、一个不报错的偏移

点击地图走路,人物落点总是往右下偏半格;技能点地释放,特效又偏左上小半格。控制台干干净净,一个报错都没有——因为这不是错误,是三套坐标系没换算干净。格子坐标、世界坐标、屏幕坐标各自为政的地方,偏移不会抛异常,只会让玩家觉得"手感怪"。坐标换算是游戏前端的地基工程,地基的裂缝从来不会响。

二、底层原理:三次变换一条链

客户端手里始终有三套数:地图格子坐标(第几格,整数语义)、世界坐标(格子乘以格宽格高得到的像素值)、屏幕坐标(世界坐标经过相机缩放与相机偏移后的最终绘制值)。正向链路是格子到世界到屏幕,逆向链路是屏幕到世界到格子。所有点击命中、拖拽放置、特效定位,都必须走一遍逆变换再回到正向,任何一环漏乘缩放或漏减相机偏移,就是那种"半格偏移"的经典事故。

mermaid
flowchart LR
    A["格子坐标 gx, gy"] -- "gx*格宽 gy*格高" --> B["世界坐标 wx, wy"]
    B -- "wx*缩放 - 相机X" --> C["屏幕坐标 sx, sy"]
    C -- "绘制节点 setPosition" --> D["屏幕上的像素"]
    D -- "点击命中" --> E["屏幕坐标 click"]
    E -- "+相机偏移 ÷缩放" --> F["世界坐标"]
    F -- "÷格宽格高 取整" --> G["格子坐标"]
    G -.-> A

三、正确写法(可直接落地)

lua
-- 世界坐标 → 屏幕坐标
function World2Screen(srcPos)
    local camera = global.Director:getRunningScene():getCamera()
    local zoom   = CalcCameraZoom(camera)          -- 当前相机缩放
    local visible = global.Director:getVisibleSize()
    local camX = camera:getPositionX() - visible.width  * 0.5 * zoom
    local camY = camera:getPositionY() - visible.height * 0.5 * zoom
    local pt = cc.p(srcPos.x * zoom - camX, srcPos.y * zoom - camY)
    return pt
end

-- 屏幕坐标 → 世界坐标(逆运算)
function Screen2World(srcPos)
    local camera = global.Director:getRunningScene():getCamera()
    local zoom   = CalcCameraZoom(camera)
    local visible = global.Director:getVisibleSize()
    local camX = camera:getPositionX() - visible.width  * 0.5 * zoom
    local camY = camera:getPositionY() - visible.height * 0.5 * zoom
    return cc.p((srcPos.x + camX) / zoom, (srcPos.y + camY) / zoom)
end

-- 格子 ⇄ 世界
function MapPos2WorldPos(gx, gy)
    return cc.p(gx * global.MMO.MAP_CELL_W, gy * global.MMO.MAP_CELL_H)
end

四、四个必须钉死的细节

  1. 缩放系数处处都要乘。相机拉近拉远 zoom 在变,点击命中与绘制定位必须读同一时刻的 zoom,缓存旧值就是偏移复现的温床。2. 相机锚点语义要统一:相机位置指视野中心还是左下角,两套约定差半个可见区,换算里减 visible 乘 zoom 那步就是在对齐约定。3. 逆变换回格子必须取整,浮点误差让 79.9999 落到 79 格,玩家看见的就是差一格。4. 换算函数成对出现、只此一对,业务里禁止内联手写换算——散落的私版本是坐标事故第一来源。

五、心法:一对函数管全部落点

判断坐标系统是否健康,看 World2Screen 和 Screen2World 的调用密度:飘字、血条、小地图、点击走路、拖拽摆放全经过这一对函数就是健康的;各写各的补丁就是欠债。三套坐标、一对换算、零内联——记住这十二个字,半格偏移这类不报错的错就从根上没了。

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

← 返回文章地图返回研学路径

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

进阶实战游戏功能

Lua+string.len:字符串长度的字节本质

【语法算法】 闭包工厂的本质就这一行: 外层函数接收配置,返回一个闭包——闭包捕获配置,后续调用使用捕获的配置——闭包工厂的…

2026-09-29 16:47 996 技术组
进阶实战游戏功能

Lua+闭包工厂:函数返回函数的工厂本质

【语法算法】 闭包工厂的本质就这一行: 外层函数接收配置,返回一个闭包——闭包捕获配置,后续调用使用捕获的配置——闭包工厂的…

2026-09-29 16:47 996 技术组
进阶实战游戏功能

Lua+泛型for的四种形态:从简单到完整的进化本质

【语法算法】 泛型 for 的四种形态就这两行: 泛型 for 的四种形态覆盖了 Lua 所有的遍历需求——从无序遍历到有序…

2026-09-29 16:46 996 技术组
进阶实战游戏功能

Lua+string.find的起始偏移:模式搜索的范围本质

【语法算法】 string.find 的起始偏移就这一行: 第三个参数 init 是搜索的起始偏移——从字符串的第 init…

2026-09-29 16:46 996 技术组
进阶实战游戏功能

Lua+CPU时间与墙钟时间:两种计时的分界本质

【语法算法】 CPU 时间和墙钟时间的分界就这两行: os.clock 返回 CPU 时间——程序实际占用处理器的秒数——o…

2026-09-29 16:46 996 技术组
进阶实战游戏功能

Lua+元方法__unm:一元负号的自定义本质

【语法算法】 元方法 __unm 的触发就这一行: 对带 __unm 的表做一元负号操作 -t 时,Lua 调用 __unm…

2026-09-29 16:46 996 技术组