meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:world:radarmarker [2024/07/10 03:51] – bibiboxsscripting:world:radarmarker [2025/08/09 06:10] (当前版本) – bibiboxs
行 6: 行 6:
 ### OnRadarMarkerFocusActive( radarMarker, active ) ### OnRadarMarkerFocusActive( radarMarker, active )
  
-> 当**地图标记点**焦点`Focus`开启或结束时触发。+> 当地图标记点焦点`Focus`开启或结束时触发。
  
  
行 14: 行 14:
 ### radarMarker.UUID ### radarMarker.UUID
  
-> 获取**地图标记点**UUID，这是由一串较长的字符串组成的全局唯一**文本ID**（实例化时自动赋值，非持久化数据）。+> 获取地图标记点**UUID**，这是由一串较长的字符串组成的全局唯一**文本ID**（实例化时自动赋值，非持久化数据）。
  
 ```javascript ```javascript
行 24: 行 24:
 ### radarMarker.Pos ### radarMarker.Pos
  
-> 获取**地图标记点**实时坐标（只读）。+> 获取地图标记点**实时坐标**（只读）。
  
 ```javascript ```javascript
 radarMarker.Pos: Vector radarMarker.Pos: Vector
-``` 
- 
- 
- 
-### radarMarker.World 
- 
-> 设置**地图标记点**实例世界ID（不同世界将不可视）。 
- 
-```javascript 
-radarMarker.World = 0; //int 
 ``` ```
  
行 44: 行 34:
 ### radarMarker.Type ### radarMarker.Type
  
-> 获取**地图标记点**实例类型，不同类型有不同的作用。+> 获取地图标记点**实例类型**，不同类型有不同的作用。
  
 ```javascript ```javascript
行 59: 行 49:
 ### radarMarker.Color ### radarMarker.Color
  
-> 设置**地图标记点**覆盖颜色。+> 设置地图标记点**覆盖颜色**。
 > >
  
行 70: 行 60:
 ### radarMarker.Important ### radarMarker.Important
  
-> 设置**地图标记点**实例是否为关键点，**关键标记点即使在小地图范围外也会被显示**。+> 设置地图标记点实例是否为**关键点**，关键标记点即使在**小地图范围外**也会被显示（最多同时显示64个关键标记点）。
 > >
-> **注意：此属性仅限`Type==Icon`类型修改。**+> 注意：此属性仅限`Type==Icon`类型修改。
  
 ```javascript ```javascript
行 82: 行 72:
 ### radarMarker.Compass ### radarMarker.Compass
  
-> 设置**地图标记点**实例是否显示在标尺（屏幕顶部的方向标尺）。+> 设置地图标记点实例是否在**标尺显示**（屏幕顶部的方向标尺）。
 > >
-> **注意：此属性仅限`Type==Icon`类型修改。**+> 注意：此属性仅限`Type==Icon`类型修改。
  
 ```javascript ```javascript
行 94: 行 84:
 ### radarMarker.Icon ### radarMarker.Icon
  
-> 设置**地图标记点**图标（图片）。+> 设置地图标记点**图标**。
 > >
-> **注意：此属性仅限`Type==Icon`类型修改。**+> 注意：此属性仅限`Type==Icon`类型修改。
  
 ```javascript ```javascript
-radarMarker.Icon = true; //bool+radarMarker.Icon: int
 ``` ```
  
行 106: 行 96:
 ### radarMarker.Text ### radarMarker.Text
  
-> 设置**地图标记点**文本（字符串）。+> 设置地图标记点**文本**（支持宏文本）。
 > >
-> **注意：此属性仅限`Type==Text`类型修改。**+> 注意：此属性仅限`Type==Text`类型修改。
  
 ```javascript ```javascript
行 118: 行 108:
 ### radarMarker.Title ### radarMarker.Title
  
-> 设置**地图标记点**标题\标签。+> 设置地图标记点**标题\标签**（支持宏文本）。
 > >
-> **标签文本将在大地图界面以【图标|标题】样式展示。**+> 标签文本将在**大地图界面**以**图标|标题**样式展示。
 > >
-> **如果希望以不同玩家语言翻译，可以使用`$LanguageTag`格式进行赋值（例如：`$Native.MyRadarMarker.PointA`将在不同玩家的翻译文件寻找此路径翻译后文本）。** +> 注意：此属性仅限`Type==Icon`类型修改。
-> +
-> **注意：此属性仅限`Type==Icon`类型修改。**+
  
 ```javascript ```javascript
行 134: 行 122:
 ### radarMarker.Scale ### radarMarker.Scale
  
-> 设置**地图标记点**尺寸缩放，默认`1.0`。+> 设置地图标记点**尺寸缩放**，默认`1.0`。
  
 ```javascript ```javascript
 radarMarker.Scale = 1.0; //float radarMarker.Scale = 1.0; //float
 +```
 +
 +
 +
 +### radarMarker.Layer
 +
 +> 设置地图标记点**层级顺序**，数字越大越优先显示，默认`0`，范围`0~5`（建议<=4）。
 +> 
 +> 注意：默认层级为`0`时，如果在位置坐标重叠时，实际渲染层级是不固定的（同层标记可能会随机显示），应该为**关键标记点**设计一个**更高的层级**。
 +
 +```javascript
 +radarMarker.Layer = 0; //int
 ``` ```
  
行 144: 行 144:
 ### radarMarker.Target ### radarMarker.Target
  
-> 设置**地图标记点**跟随坐标或对象（`Entity`）。 +> 设置地图标记点**跟随目标对象**（优先级最高）。 
-> + 
-> **如果设置为`Vector`将会固定坐标，如果设置为`Entity`将始终跟随其最新位置，直到对象被销毁。** +```javascript 
-> +radarMarker.Target: Entity 
-> **注意：在读取此属性时，应该提前自行确定属性类型（`Vector ? Entity`），避免出现异常。**+``` 
 + 
 + 
 + 
 +### radarMarker.TargetPos 
 + 
 +> 设置地图标记点**跟随目标坐标**，默认为`Vector(0, 0, 0)`。 
 + 
 +```javascript 
 +radarMarker.TargetPos: Vector 
 +``` 
 + 
 + 
 + 
 +### radarMarker.Match 
 + 
 +> 设置地图标记点**白名单匹配**表达式。 
 +>  
 +> 如果表达式字符串不为`null`，则只有表达式内包含的`PlayerID`可见，反之则不可见。这可能用于对玩家自身不可见等情况。
  
 ```javascript ```javascript
-radarMarker.Target = object; //Vector || Entity+radarMarker.Match = ""; //string
 ``` ```
  
 ```javascript ```javascript
-radarMarker.Target = Vector(0, 0, 0); +radarMarker.Match = ""; //All visible 
-radarMarker.Target = Character.Find(0); //Always follow until 'null'+radarMarker.Match = "2"; //Only visible: player id == 2 
 +radarMarker.Match = "2|3|5|7|8"; //visible: player id == 2\3\5\7\8
 ``` ```
  
行 165: 行 184:
 ### RadarMarker.Create() ### RadarMarker.Create()
  
-> 生成一个新的**地图标记点**实例。+> 生成一个新的地图**标记点实例**。
  
 ```javascript ```javascript
-function RadarMarker.Create( icon: int, target: Vector || Entity, important: bool = false, compass: bool = false ): RadarMarker+function RadarMarker.Create( icon: int, target: Entity | Vector, important: bool = false, compass: bool = false ): RadarMarker
 ``` ```
  
行 177: 行 196:
  
 - **`icon`：**标记点图标 - **`icon`：**标记点图标
-- **`target`：**跟随坐标或对象（`Entity`）+- **`target`：**跟随坐标或实体对象
 - **`important`：**是否为关键点 - **`important`：**是否为关键点
 - **`compass`：**是否显示在标尺 - **`compass`：**是否显示在标尺
行 185: 行 204:
 ### RadarMarker.CreateText() ### RadarMarker.CreateText()
  
-> 生成一个新的**地图文本标记点**实例，类似地区名称效果。+> 生成一个新的地图**文本标记点**实例，类似地区名称效果。
  
 ```javascript ```javascript
行 200: 行 219:
 ### RadarMarker.Find() ### RadarMarker.Find()
  
-> 寻找一个**地图标记点**实例（通过UUID），不存在则返回`null`。+> 寻找一个地图**标记点实例**（通过UUID），不存在则返回`null`。
  
 ```javascript ```javascript
行 210: 行 229:
 ### RadarMarker.GetCount() ### RadarMarker.GetCount()
  
-> 获取当前所有存在**地图标记点**数量。+> 获取当前所有存在地图**标记点数量**。
  
 ```javascript ```javascript
行 220: 行 239:
 ### RadarMarker.Get() ### RadarMarker.Get()
  
-> 获取当前存在的指定索引**地图标记点**实例，通常搭配`GetCount()`遍历使用。+> 获取当前存在的指定索引地图**标记点实例**，通常搭配`GetCount()`遍历使用。
  
 ```javascript ```javascript
行 232: 行 251:
 ### radarMarker.Remove() ### radarMarker.Remove()
  
-> 销毁当前**地图标记点**实例。+> 销毁当前地图**标记点实例**。
  
 ```javascript ```javascript
行 242: 行 261:
 ### radarMarker.Focus() ### radarMarker.Focus()
  
-> 触发一次当前**地图标记点**实例焦点（地图高亮）。+> 触发一次当前地图标记点**实例焦点**（地图高亮）。
  
 ```javascript ```javascript
行 248: 行 267:
 ``` ```
  
-- **`time`：**焦点保持时间（秒），如果<=0则会一直存在 +- `time`焦点保持时间（秒），如果<=0则会一直存在 
-- **`color`：**焦点高亮颜色（默认值`Color(255, 255, 255)`） +- `color`焦点高亮颜色（默认值`Color(255, 255, 255)`） 
-- **`size`：**焦点高亮尺寸缩放（默认值`1.0`）+- `size`焦点高亮尺寸缩放（默认值`1.0`） 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 +