用途:为《魔兽世界》正式服插件开发提供地图、导航与位置相关 API 的完整参考,资料标注适用于 Patch 12.0.0(Build 65655),仅限正式服。
主要能力:涵盖 C_Map(地图数据、坐标、地图 ID、区域、地图组与楼层、地图间转换、用户路径点)、C_MapExplorationInfo(探索与战争迷雾数据)、C_AreaPoiInfo(区域兴趣点及限时 POI)、C_TaxiMap 与 Taxi 系列函数(飞行点与航线)、C_VignetteInfo(稀有怪、宝藏等 Vignette)、C_SuperTrack(超级追踪)、C_Navigation(游戏内导航箭头与距离)、C_ZoneAbility(区域技能)、C_FogOfWar、小地图函数以及 C_NamePlate 姓名板管理。
使用方式:通过 Lua 调用上述命名空间函数,例如用 C_Map.GetBestMapForUnit("player") 获取当前地图,用 C_Map.GetPlayerMapPosition(mapID, "player") 取坐标(返回 0-1 归一化值,需用 GetWorldPosFromMapPos 转世界坐标),用 C_Map.SetUserWaypoint 配合 C_SuperTrack.SetSuperTrackedUserWaypoint 设置并追踪路径点。可监听 ZONE_CHANGED、USER_WAYPOINT_UPDATED、SUPER_TRACKING_CHANGED、VIGNETTES_UPDATED、NAME_PLATE_UNIT_ADDED 等事件。
限制:GetPlayerMapPosition 在受限副本或无效地图 ID 下返回 nil;uiMapID 与 areaID 是不同 ID 体系;12.0.0 中副本内敌方姓名板数据可能为 secret 值;TakeTaxiNode 需硬件事件(点击回调)触发;Vignette GUID 在切换区域或重载后失效,不可持久化;同时只能存在一个用户路径点。
适用场景:开发地图标记、导航指引、飞行路线、稀有怪提示、姓名板增强等插件。具体收费、平台与效果资料暂未提供。