{"record":{"id":"022863578fab09f7","repo":"babalae/better-genshin-impact","slug":"error-022863","errorCode":null,"errorMessage":"地图缩放未到传送点显示级别","messagePattern":"地图缩放未到传送点显示级别","errorType":"exception","errorClass":"TpPointNotActivate","httpStatus":null,"severity":"warning","filePath":"BetterGenshinImpact/GameTask/AutoTrackPath/TpTask.cs","lineNumber":574,"sourceCode":"            lastEvaluation = evaluation;\n            if (evaluation.View != null)\n            {\n                var targetFinalZoomLevel = ClampTeleportFinalZoomLevel(finalZoomLevel, mapName);\n                if (!ShouldAdjustTeleportFinalZoom(evaluation.View, targetFinalZoomLevel))\n                {\n                    return evaluation.View;\n                }\n\n                if (finalZoomAttempts >= MaxMapZoomWheelAttempts)\n                {\n                    if (!IsTeleportPointDisplayZoomLevelReached(evaluation.View.ZoomLevel, mapName))\n                    {\n                        var displayTpPointZoomLevel = GetDisplayTpPointZoomLevel(mapName);\n                        Logger.LogWarning(\n                            \"地图缩放未到传送点显示级别，已跳过点击：zoom={ZoomLevel:0.00} required<={RequiredZoomLevel:0.00}\",\n                            evaluation.View.ZoomLevel,\n                            displayTpPointZoomLevel);\n                        throw new TpPointNotActivate(\"地图缩放未到传送点显示级别\");\n                    }\n\n                    return evaluation.View;\n                }\n\n                if (!IsTeleportClickViewSafeAfterZoom(evaluation.View, targetFinalZoomLevel))\n                {\n                    await MoveTeleportTargetTowardZoomCenter(evaluation.View);\n                    await Delay(TeleportClickableAreaRetryDelayMs, ct);\n                    continue;\n                }\n\n                await AdjustTeleportZoomLevelTo(targetFinalZoomLevel);\n                finalZoomAttempts++;\n                continue;\n            }\n\n            if (retryCount >= TeleportClickableAreaRetryCount)","sourceCodeStart":556,"sourceCodeEnd":592,"githubUrl":"https://github.com/babalae/better-genshin-impact/blob/a7cb36712dcb409be610257d877fcea3597e9d6b/BetterGenshinImpact/GameTask/AutoTrackPath/TpTask.cs#L556-L592","documentation":"TpPointNotActivate (a custom exception) thrown when, after MaxMapZoomWheelAttempts zoom-wheel attempts, the big-map zoom level still has not reached the threshold required to render teleport-point icons (IsTeleportPointDisplayZoomLevelReached returns false). The map view is too zoomed-out for TP icons to appear, so clicking is skipped and the teleport is treated as 'not activated'.","triggerScenarios":"Map zoom adjustment via mouse wheel not registering on the game (input blocked, wrong focus); GetDisplayTpPointZoomLevel for the mapName returning a value the wheel cannot reach; game's map zoom clamped by UI; TpTask instantiated with a mapName whose required zoom differs from Teyvat.","commonSituations":"Mouse wheel input not reaching the game (overlay focus, admin elevation); map already at min/max zoom; user's mouse driver intercepting the wheel; anti-cheat dampening rapid wheel events.","solutions":["Ensure the tool can send mouse-wheel input to Genshin (foreground focus, correct privileges).","Run at 1920x1080 so zoom-level detection (GetCurrentBigMapZoomLevel via OCR/template) reads correctly.","Retry the teleport — transient zoom misdetection recovers on the next TpWithRetries attempt.","If persistent for a specific mapName, verify GetDisplayTpPointZoomLevel is configured for that map.","Increase MaxMapZoomWheelAttempts for slow-zoom environments."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try { await TpOnce(...); }\ncatch (TpPointNotActivate e) when (e.Message.Contains(\"缩放未到传送点显示级别\"))\n{ /* TpWithRetries already retries; ensure wheel input reaches game */ }","preventionTips":["Confirm mouse-wheel input reaches Genshin before relying on zoom.","Run at 1920x1080 so zoom-level detection is accurate.","Tune MaxMapZoomWheelAttempts and GetDisplayTpPointZoomLevel for slow-zoom setups."],"tags":["teleport","map-zoom","big-map","input-injection","tp-not-activate"],"backgroundTag":null,"analyzedSha":"a7cb36712dcb409be610257d877fcea3597e9d6b","analyzedAt":"2026-08-13T16:44:57.548Z","schemaVersion":2},"datasetVersion":"2026-08-13T19:17:28.613Z"}