地图区域

**正文：**
[免费][发布] MapZones——可自定义颜色和效果的地图区域/领土，支持悬停和玩家事件
您可以在GTA V的小地图和暂停地图上绘制彩色多边形区域/领土，这些区域可以自定义形状和颜色；当鼠标悬停在某个区域上或玩家实际进入该区域时，系统会触发相应事件。无需使用预先制作好的图片，所有形状都是在运行时根据世界坐标生成的。

**预览：**
– **功能简介：**
MapZones允许您在地图上绘制具有名称、描述和颜色的区域（类似帮派地盘）。它提供了一个简单的API，让您可以自定义功能：例如在暂停地图上悬停鼠标时弹出NUI面板、玩家进入区域时启动占领计时器、从服务器同步区域所有权等。
– **主要特性：**
– 可以根据游戏内的世界坐标自由定义多边形区域。
– 每个区域均可设置颜色、填充不透明度及边框样式。
– 区域会在小地图和暂停地图上同时显示。
– 当鼠标悬停在区域上或玩家进入/离开区域时，系统会触发相应事件。
– 提供简单的API，用于在运行时添加、删除和查询区域。
– 代码简洁、易于理解（无注释），且完全可配置。

**工作原理：**
`DrawPoly`和`DrawLine`函数不会直接在暂停地图上渲染，MapZones会将每个区域绘制到一个离屏的浏览器界面（DUI）中，然后将其转换为运行时纹理，并通过`SCALEFORM_OVERLAY`（`MINIMAP_LOADER.gfx`文件）显示在地图上。
– 悬停检测通过`GetPauseMapPointerWorldPosition`函数结合“点在多边形内”的判断来实现。玩家位置检测则根据可配置的间隔定期检查玩家角色的位置。

**使用方法：**
– **添加区域：**
`exports[‘MapZones’]:addZone(data)`（创建区域并返回唯一ID）
– **删除区域：**
`exports[‘MapZones’]:removeZone(id)`
– **清除所有区域：**
`exports[‘MapZones’]:clearZones()`
– **获取当前悬停区域：**
`local zone = exports[‘MapZones’]:getHoveredZone()`
– **获取玩家所在区域：**
`local zone = exports[‘MapZones’]:playerZone()`

**事件处理：**
– `mapzones:onMapEnter`：鼠标进入区域
– `mapzones:onMapExit`：鼠标离开区域
– `mapzones:onPlayerEnter`：玩家角色进入区域
– `mapzones:onPlayerExit`：玩家角色离开区域

**示例配置：**
“`lua
local id = exports[‘MapZones’]:addZone({
name = ‘Elysian Island’,
description = ‘该区域不受任何帮派控制。’,
color = { 70, 130, 220 }, // 颜色
alpha = 150, // 不透明度（可选）
points = {
{ x = -126.0, y = -1543.9 },
{ x = -131.5, y = -1538.5 },
// …
}
})
“`

**系统要求：**
– 使用较新的FiveM版本（必须支持`GetPauseMapPointerWorldPosition`函数）。
– 资源文件夹中需包含`MINIMAP_LOADER.gfx`文件。

**安装步骤：**
1. 将`MapZones`文件夹放入资源文件夹中。
2. 确保`MINIMAP_LOADER.gfx`文件与`fxmanifest.lua`文件位于同一目录下。
3. 在`server.cfg`文件中添加`MapZones`模块的引用。

**文件结构：**
“`
MapZones/
├─ fxmanifest.lua
├─ config.lua — 配置文件
“`