---
title: "游戏 Game / Mission"
description: "分辨率任务状态作弊与世界查询"
---
---
title: 游戏 Game / Mission
description: 分辨率任务状态作弊与世界查询
---
`sa` · 扩展 `CLEO+` · 需 CLEO + CLEO+
写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 分辨率 / 宽高比
游戏窗口宽高。
```text
0E0E GET_CURRENT_RESOLUTION
out: width, height
```
```lua
local w, h = getCurrentResolution()
```
```js
const { width, height } = Game.getCurrentResolution()
```
按窗口宽高比校正 x/y，适合 HUD/字缩放。
```text
0E0F GET_FIXED_XY_ASPECT_RATIO
in: x, y
out: x, y
```
```lua
local fx, fy = getFixedXyAspectRatio(x, y)
```
```js
const { x, y } = Hud.getFixedXyAspectRatio(x, y)
```
## 状态判定
玩家是否在任务中（`0180` 那套任务标志非 0）。用在 `if` 里。
```text
0E1D IS_ON_MISSION
```
```lua
if isOnMission() then
end
```
```js
if (Mission.isOn()) {
}
```
是否跑在 SA-MP。用在 `if` 里。
```text
0E20 IS_ON_SAMP
```
```lua
if isOnSamp() then
end
```
```js
if (Game.isSamp()) {
}
```
是否在过场（对应 `02E7` 一类状态）。用在 `if` 里。
```text
0E25 IS_ON_CUTSCENE
```
```lua
if isOnCutscene() then
end
```
```js
if (Cutscene.isOn()) {
}
```
## 存档 / 开局
当前读档槽位；新游戏为 0。
```text
0E2C GET_CURRENT_SAVE_SLOT
out: slot
```
```lua
local slot = getCurrentSaveSlot()
```
```js
const slot = Game.getCurrentSaveSlot()
```
是否本进程首次开局（未中途重载）。用在 `if` 里。
```text
0E2D IS_GAME_FIRST_START
```
```lua
if isGameFirstStart() then
end
```
```js
if (Game.isFirstStart()) {
}
```
## 屏幕投影 / 节流
世界坐标 → 屏幕 2D 与字号参考尺寸；可夹 near/far clip。点在裁剪外会失败，用在 `if` 里。
```text
0E3F CONVERT_3D_TO_SCREEN_2D
in: x, y, z, nearClip, farClip
out: x, y, sizeX, sizeY
```
```lua
local sx, sy, sizeX, sizeY = convert3DToScreen2D(wx, wy, wz, true, true)
if sx then
end
```
```js
const { x, y, sizeX, sizeY } = World.convert3DToScreen2D(x, y, z, nearClip, farClip)
```
每 `mod` 帧为真一次（节流用）。用在 `if` 里。
```text
0E45 FRAME_MOD
in: mod
```
```lua
if frameMod(4) then
end
```
```js
if (Game.frameMod(mod)) {
}
```
## 作弊 / 菜单
指定可切换作弊是否开启。用在 `if` 里。
```text
0E5D IS_CHEAT_ACTIVE
in: cheat
```
```lua
if isCheatActive(cheatId) then
end
```
```js
if (Game.isCheatActive(cheat)) {
}
```
菜单确认键本帧刚按。用在 `if` 里。
```text
0E6E IS_SELECT_MENU_JUST_PRESSED
```
```lua
if isSelectMenuJustPressed() then
end
```
```js
if (Game.isSelectMenuJustPressed()) {
}
```
## 模型类型
模型类型（Streaming）。
```text
0E7F GET_MODEL_TYPE
in: model
out: type
```
```lua
local t = getModelType(modelId)
```
```js
const type = Streaming.getModelType(model)
```
## 双人
关掉二号玩家；可选恢复镜头。
```text
0EA1 DISABLE_SECOND_PLAYER
in: restoreCamera
```
```lua
disableSecondPlayer(true)
```
```js
Game.disableSecondPlayer(restoreCamera)
```
启用双人分车相关修复。
```text
0EA2 FIX_TWO_PLAYERS_SEPARATED_CARS
```
```lua
fixTwoPlayersSeparatedCars()
```
```js
Game.fixTwoPlayersSeparatedCars()
```
## 过场 / 模型 ped
是否在脚本任务过场（原生宽银幕边框开着）。用在 `if` 里。
```text
0EB7 IS_ON_SCRIPTED_CUTSCENE
```
```lua
if isOnScriptedCutscene() then
end
```
```js
if (Mission.isOnScriptedCutscene()) {
}
```
角色模型对应 pedType + pedStat。用在 `if` 里。
```text
0EBA GET_MODEL_PED_TYPE_AND_STAT
in: modelId
out: pedType, pedStat
```
```lua
local pedType, pedStat = getModelPedTypeAndStat(modelId)
```
```js
const { pedType, pedStat } = native("GET_MODEL_PED_TYPE_AND_STAT", modelId)
```
## 距离 / 水面
绘制距离与生成距离倍率。
```text
0F0F GET_DISTANCE_MULTIPLIER
out: drawing, generating
```
```lua
local drawMul, genMul = getDistanceMultiplier()
```
```js
const { drawing, generating } = native("GET_DISTANCE_MULTIPLIER")
```
最近水面距离与高度 z。
```text
0F11 GET_CLOSEST_WATER_DISTANCE
out: distance, closestZ
```
```lua
local dist, wz = getClosestWaterDistance()
```
```js
const { distance, closestZ } = native("GET_CLOSEST_WATER_DISTANCE")
```
## 任务标志 / 模型名
直接设 OnMission 状态（不绑全局变量）。
```text
0F16 SET_ON_MISSION
in: status
```
```lua
setOnMission(true)
```
```js
Game.setOnMission(status)
```
任意 modelId 的名字字符串地址。
```text
0F17 GET_MODEL_NAME_POINTER
in: modelId
out: address
```
```lua
local namePtr = getModelNamePointer(modelId)
```
```js
const address = native("GET_MODEL_NAME_POINTER", modelId)
```