meta data for this page
  •  

📚 差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版
前一修订版
scripting:world:billboard [2024/03/21 00:43] bibiboxsscripting:world:billboard [2025/08/09 06:12] (当前版本) bibiboxs
行 49: 行 49:
  
 ```javascript ```javascript
-Billboard.Type: int+billboard.Type: int
 ``` ```
  
行 67: 行 67:
  
 ```javascript ```javascript
-billboard.Color = Color(255, 255, 255); //Color+billboard.Color = Color(255, 255, 255, 255); //Color
 ``` ```
  
行 74: 行 74:
 ### billboard.Alpha ### billboard.Alpha
  
-> 设置展示牌实例透明度,默认为`255`。+> 设置展示牌实例整体透明度,默认为`255`。
  
 ```javascript ```javascript
行 94: 行 94:
 ### billboard.Baffle ### billboard.Baffle
  
-> 设置展示牌是否存在遮挡逻辑,默认为`false`,如果设置`true`将作为一个物体,可以被其他物体遮挡。+> 设置展示牌是否存在遮挡逻辑,默认为`true`,如果设置`false`将不会被其他物体遮挡(超过一定渲染距离后仍然不可见)
  
 ```javascript ```javascript
-billboard.Baffle = false; //bool+billboard.Baffle = true; //bool
 ``` ```
  
行 187: 行 187:
 ```javascript ```javascript
 billboard.MaxProgress = 0.0; //float billboard.MaxProgress = 0.0; //float
 +```
 +
 +
 +
 +### billboard.Target
 +
 +> 设置展示牌**跟随目标对象**(优先级最高)。
 +
 +```javascript
 +billboard.Target: Entity
 +```
 +
 +
 +
 +### billboard.TargetPos
 +
 +> 设置展示牌**跟随目标坐标**,默认为`Vector(0, 0, 0)`。
 +
 +```javascript
 +billboard.TargetPos: Vector
 +```
 +
 +
 +### billboard.Match
 +
 +> 设置展示牌**白名单匹配**表达式。
 +
 +> 如果表达式字符串不为`null`,则只有表达式内包含的`PlayerID`可见,反之则不可见。这可能用于【玩家头顶名称】对玩家自身不可见等情况。
 +
 +```javascript
 +billboard.Match = ""; //string
 +```
 +
 +```javascript
 +billboard.Match = ""; //All visible
 +billboard.Match = "2"; //Only visible: player id == 2
 +billboard.Match = "2|3|5|7|8"; //visible: player id == 2\3\5\7\8
 ``` ```
  
行 196: 行 233:
  
 > 生成一个新的展示牌实例,`Type`类型样式参考`Billboard.Type`属性介绍。 > 生成一个新的展示牌实例,`Type`类型样式参考`Billboard.Type`属性介绍。
 +
 +> 注意:`Billboard`的可见范围是256,如果需要更远的可视距离(通常不需要),请考虑使用`Client/Guider`。
  
 ```javascript ```javascript
-function Billboard.Create( type: int, pos: Vector = Vector(0, 0, 0) ): Billboard+function Billboard.Create( type: int, targetEntity | Vector ): Billboard
 ``` ```
  
 ```javascript ```javascript
-//在0点坐标处,建立一个类型为0展示牌实例 
 let newBB = Billboard.Create(0, Vector(0, 0, 0)); let newBB = Billboard.Create(0, Vector(0, 0, 0));
-//建立完成后,还需要根据其Type类型为其添加其他属性 
 newBB.Sprite = 0; //因为是Type0(图片)类型,所以设置Sprite属性为0号图片 newBB.Sprite = 0; //因为是Type0(图片)类型,所以设置Sprite属性为0号图片
 ``` ```
行 212: 行 249:
 ### Billboard.CreateTips() ### Billboard.CreateTips()
  
-> 生成一个**小文本气泡**实例(类似**【血量-10】**的气泡样式),这是一个本地静态实例,因此没有返回值。+> 生成一个**小文本气泡**实例(类似**【血量-10】**的气泡样式),这是一个**本地静态**实例,因此没有返回值。
  
 ```javascript ```javascript
行 218: 行 255:
 ``` ```
  
-- **text:**文本内容 +- **`text`:**文本内容 
-- **pos:**世界坐标 +- **`pos`:**世界坐标 
-- **time:**显示时间(自动销毁) +- **`time`:**显示时间(自动销毁) 
-- **scale:**尺寸缩放(相对于屏幕尺寸,而非距离远近) +- **`scale`:**尺寸缩放(相对于屏幕尺寸,而非距离远近) 
-- **hasBG:**是否显示黑色背景(默认开启) +- **`hasBG`:**是否显示黑色背景(默认开启) 
-- **hasRotate:**是否随机角度(默认开启)+- **`hasRotate`:**是否随机角度(默认开启)
  
  
行 235: 行 272:
 ``` ```
  
-- **text:**文本内容 +- **`text`:**文本内容 
-- **pos:**世界坐标 +- **`pos`:**世界坐标 
-- **time:**显示时间(自动销毁) +- **`time`:**显示时间(自动销毁) 
-- **scale:**尺寸缩放(相对于屏幕尺寸,而非距离远近) +- **`scale`:**尺寸缩放(相对于屏幕尺寸,而非距离远近) 
-- **hasBG:**是否显示黑色背景(默认开启) +- **`hasBG`:**是否显示黑色背景(默认开启) 
-- **hasRotate:**是否随机角度(默认开启)+- **`hasRotate`:**是否随机角度(默认开启)
  
  
行 293: 行 330:
 function billboard.Remove() function billboard.Remove()
 ``` ```
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +