luxuia/crystal-map-parsing-reference
proj/.cursor/skills/crystal-map-parsing-reference/SKILL.md
Use when debugging Mir2 map parsing, .map format precision, FishingCell, or terrain coordinate issues in Legendary Terrain. Consult Crystal source as authoritative reference.
development
Updated Apr 7, 2026
$ install --global
skillsauthnpx skillsauth add luxuia/testgame1 crystal-map-parsing-referenceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 10:44 AM3.7s1 file scanned
SKILL.md
- name:
- crystal-map-parsing-reference
- description:
- Use when debugging Mir2 map parsing, .map format precision, FishingCell, or terrain coordinate issues in Legendary Terrain. Consult Crystal source as authoritative reference.
Crystal 地图解析参考
概述
解析传奇 2 .map 或地形坐标出现问题时，以 Crystal 官方源码 为权威参考，对照 Mir2MapParser 实现。
何时使用
.map解析结果与预期不符- 水域（FishingCell）识别不全或错误
- 地形块属性（HighWall、LowWall、Door）判断异常
- 坐标映射、分块、怪物刷新位置有偏差
- 需要确认某版本 .map 的字节布局
核心参考路径
| 用途 | Crystal 文件路径 |
|------|-----------------|
| 地图解析（权威） | Server/MirEnvir/Map.cs |
| 格式检测与布局 | LoadMapCellsv0 ~ LoadMapCellsV100 |
| 可视化/简化版 | Server.MirForms/VisualMapInfo/Class/ReadMap.cs |
| RespawnInfo 结构 | Server/MirDatabase + MirDBParser |
排查流程
- 定位格式：用
FindType确定当前 .map 的版本（v0–v7、v100） - 对照实现：打开
Server/MirEnvir/Map.cs，找到对应LoadMapCellsvN - 逐字段比对：offset、字节顺序、属性判断（如
0x8000、0x20000000） - FishingCell：Crystal 使用
light >= 100 && light <= 119，非仅 100–101
快速对照表
| 字段/属性 | Crystal 逻辑 | 常见差异 |
|-----------|-------------|----------|
| FishingCell | light >= 100 && light <= 119 | 若只判 100–101 会漏掉部分水域 |
| HighWall | backImg & 0x8000 或 frontImg & 0x8000 | 与实现一致 |
| LowWall | middleImg & 0x8000 | 与实现一致 |
| Door | fileBytes[offSet] > 0 | 与实现一致 |
常见错误
- FishingCell 范围过窄：只判 100–101，应改为 100–119
- offset 错位：某版本每格字节数不同，漏读或多读会导致后续格错位
- 字节序：
BitConverter默认小端，与 Crystal 一致
参考链接
- Crystal 仓库：https://github.com/Suprcode/Crystal
- Map.cs 直接链接：https://github.com/Suprcode/Crystal/blob/master/Server/MirEnvir/Map.cs
Related Skills
luxuia/type-get-json-schema
data-ai
VerifiedTrustedCommunity
Generates a JSON Schema for a given C# type name using reflection. Supports primitives, enums, arrays, generic collections, dictionaries, and complex objects. The type must be present in any loaded assembly. Use the full type name (e.g. 'UnityEngine.Vector3') for best results.
SKILL.mdUpdated Apr 7, 2026
luxuia/tests-run
development
VerifiedTrustedCommunity
Execute Unity tests and return detailed results. Supports filtering by test mode, assembly, namespace, class, and method. Recommended to use 'EditMode' for faster iteration during development.
SKILL.mdUpdated Apr 7, 2026
luxuia/script-update-or-create
tools
VerifiedTrustedCommunity
Updates or creates script file with the provided C# code. Does AssetDatabase.Refresh() at the end. Provides compilation error details if the code has syntax errors. Use 'script-read' tool to read existing script files first.
SKILL.mdUpdated Apr 7, 2026
luxuia/script-read
tools
VerifiedTrustedCommunity
Reads the content of a script file and returns it as a string. Use 'script-update-or-create' tool to update or create script files.
SKILL.mdUpdated Apr 7, 2026