kotlin
fun tell(player: ServerPlayer, message: String)向玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
player | 目标 ServerPlayer。 |
message | 普通字符串消息。 |
通用
KattonMiscApi
向玩家发送系统消息。
tell
tell
kotlin
fun tell(player: ServerPlayer, message: Component)向玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
player | 目标 ServerPlayer。 |
message | 消息组件。 |
tell
kotlin
fun tell(player: ServerPlayer, message: Any)向玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
player | 目标 ServerPlayer。 |
message | 消息对象，会转换为字符串。 |
tell
kotlin
fun tell(players: Collection<ServerPlayer>, message: String)向多个玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
players | 目标 ServerPlayer 集合。 |
message | 普通字符串消息。 |
tell
kotlin
fun tell(players: Collection<ServerPlayer>, message: Component)向多个玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
players | 目标 ServerPlayer 集合。 |
message | 消息组件。 |
tell
kotlin
fun tell(players: Collection<ServerPlayer>, message: Any)向多个玩家发送系统消息。
参数
| 参数 | 说明 |
|---|---|
players | 目标 ServerPlayer 集合。 |
message | 消息对象，会转换为字符串。 |
tell
particle
kotlin
fun particle(level: ServerLevel, players: Collection<ServerPlayer>, particle: ParticleOptions, pos: Vec3, delta: Vec3 = Vec3.ZERO, speed: Double = 1.0, count: Int = 0, forced: Boolean = false)向一组玩家发送粒子。
参数
| 参数 | 说明 |
|---|---|
level | 服务端关卡。 |
players | 要发送给的玩家。 |
particle | 粒子选项。 |
pos | 中心位置。 |
delta | 扩散向量（默认零）。 |
speed | 粒子速度。 |
count | 粒子数量。 |
forced | 是否强制发送，忽略客户端设置。 |
teleportToEntity
kotlin
fun teleportToEntity(collection: MutableCollection<out Entity>, entity: Entity)将一组实体传送到另一个实体的位置。
参数
| 参数 | 说明 |
|---|---|
collection | 要传送的实体。 |
entity | 作为目标位置来源的实体。 |
teleportToPos
kotlin
fun teleportToPos(collection: MutableCollection<out Entity>, serverLevel: ServerLevel, pos: Vec3, rot: Vec2? = null)将一组实体传送到指定位置，并可选设置旋转。
参数
| 参数 | 说明 |
|---|---|
collection | 要传送的实体。 |
level | 目标关卡。 |
pos | 目标位置。 |
rot | 可选旋转向量；为 null 时保持实体当前旋转。 |
teleportToPos
kotlin
fun teleportToPos(collection: MutableCollection<out Entity>, serverLevel: ServerLevel, pos: Vec3, lookAt: Entity, anchor: EntityAnchorArgument.Anchor = EntityAnchorArgument.Anchor.FEET, lookAtAnchor: EntityAnchorArgument.Anchor = EntityAnchorArgument.Anchor.FEET)将一组实体传送到某个位置，并让它们朝向另一个实体。
参数
| 参数 | 说明 |
|---|---|
collection | 要传送的实体。 |
level | 目标关卡。 |
pos | 目标位置。 |
lookAt | 传送后要朝向的实体。 |
anchor | 用于目标朝向的锚点。 |
lookAtAnchor | 用于被看向目标的锚点。 |
teleportToPos
kotlin
fun teleportToPos(collection: MutableCollection<out Entity>, serverLevel: ServerLevel, pos: Vec3, lookAt: Vec3, anchor: EntityAnchorArgument.Anchor = EntityAnchorArgument.Anchor.FEET)将一组实体传送到某个位置，并让它们朝向另一个位置。
参数
| 参数 | 说明 |
|---|---|
collection | 要传送的实体。 |
level | 目标关卡。 |
pos | 目标位置。 |
lookAt | 要看向的位置。 |
anchor | 用于目标朝向的锚点。 |
setWaypointStyle
kotlin
fun setWaypointStyle(serverLevel: ServerLevel, waypointTransmitter: WaypointTransmitter, resourceKey: ResourceKey<WaypointStyleAsset>)为路标发射器设置路标样式。
参数
| 参数 | 说明 |
|---|---|
serverLevel | 服务端关卡。 |
waypointTransmitter | 要修改的路标发射器。 |
resourceKey | 路标样式资源键。 |
setWaypointColor
kotlin
fun setWaypointColor(serverLevel: ServerLevel, waypointTransmitter: WaypointTransmitter, chatFormatting: ChatFormatting)使用 ChatFormatting 设置路标颜色。
参数
| 参数 | 说明 |
|---|---|
serverLevel | 服务端关卡。 |
waypointTransmitter | 路标发射器。 |
chatFormatting | 要转换为颜色的格式化值。 |
setWaypointColor
kotlin
fun setWaypointColor(serverLevel: ServerLevel, waypointTransmitter: WaypointTransmitter, integer: Int)使用整数颜色值设置路标颜色。
参数
| 参数 | 说明 |
|---|---|
serverLevel | 服务端关卡。 |
waypointTransmitter | 路标发射器。 |
integer | 整数颜色值。 |
resetWaypointColor
kotlin
fun resetWaypointColor(serverLevel: ServerLevel, waypointTransmitter: WaypointTransmitter)将路标颜色重置为默认值（未设置）。
参数
| 参数 | 说明 |
|---|---|
serverLevel | 服务端关卡。 |
waypointTransmitter | 路标发射器。 |
teamMsg
kotlin
fun teamMsg(entity: Entity, playerTeam: PlayerTeam, list: MutableList<ServerPlayer>, playerChatMessage: PlayerChatMessage, commandSourceStack: CommandSourceStack = requireServer().createCommandSourceStack())向一组玩家发送带过滤和格式化的团队聊天消息。
参数
| 参数 | 说明 |
|---|---|
entity | 来源实体（发送者）。 |
playerTeam | 接收消息的团队。 |
list | 接收者列表。 |
playerChatMessage | 消息内容。 |
commandSourceStack | 用于格式化和过滤的命令源。 |