Skip to content
On this page
通用

KattonScoreboardApi

top.katton.api.dpcallercommon/src/main/kotlin/top/katton/api/dpcaller/KattonScoreboardApi.kt
Get a score value for a target in an objective.

get

get通用函数
kotlin
operator fun Scoreboard.get(target: ScoreHolder, objective: Objective): Int?

Get a score value for a target in an objective.

set

set通用函数
kotlin
operator fun Scoreboard.set(target: ScoreHolder, objective: Objective, value: Int)

Set a score value for a target in an objective.

fake

fake通用函数
kotlin
fun fake(name: String): ScoreHolder

Create a fake score holder with a name.

参数

参数说明
nameThe name for the fake score holder

返回值

A ScoreHolder that only exists for scoreboard purposes

KattonScoreHolderScoreCollection

KattonScoreHolderScoreCollection通用
kotlin
class KattonScoreHolderScoreCollection( val scoreboard: Scoreboard, val scoreHolder: ScoreHolder )

Map-like access to a score holder's scores across objectives.

属性

属性说明
scoreboardThe Scoreboard instance
scoreHolderThe ScoreHolder whose scores are being accessed

KattonScoreHolderScoreCollection.get

KattonScoreHolderScoreCollection.get通用函数
kotlin
operator fun get(objective: Objective): Int?

Get the score value for an objective.

KattonScoreHolderScoreCollection.set

KattonScoreHolderScoreCollection.set通用函数
kotlin
operator fun set(objective: Objective, value: Int)

Set the score value for an objective.

scores

scores通用属性
kotlin
val ScoreHolder.scores: KattonScoreHolderScoreCollection

Extension property to access a score holder's scores.

getObjective

getObjective通用函数
kotlin
fun getObjective(name: String): Objective?

Get an objective by name.

参数

参数说明
nameobjective name

返回值

Objective or null if not found

getOrCreateObjective

getOrCreateObjective通用函数
kotlin
fun getOrCreateObjective(name: String, displayName: Component = Component.literal(name), criteria: ObjectiveCriteria = ObjectiveCriteria.DUMMY, renderType: ObjectiveCriteria.RenderType = ObjectiveCriteria.RenderType.INTEGER, displayAutoUpdate: Boolean = false, numberFormat: NumberFormat? = null): Objective

Get or create a scoreboard Objective.

参数

参数说明
nameobjective name
displayNamedisplay name component for the objective
criteriaobjective criteria
renderTyperender type for the objective
displayAutoUpdatewhether the display auto-updates
numberFormatoptional number format

返回值

existing or newly created Objective

setScore

setScore通用函数
kotlin
fun setScore(target: String, objective: Objective, value: Int)

Set a score for a target identified by name.

参数

参数说明
targettarget name
objectiveobjective to set
valuescore value to set

setScore

setScore通用函数
kotlin
fun setScore(target: Entity, objective: Objective, value: Int)

Set a score for an Entity.

参数

参数说明
targettarget Entity
objectiveobjective to set
valuescore value

setScore

setScore通用函数
kotlin
fun setScore(target: ScoreHolder, objective: Objective, value: Int)

Set a score for a ScoreHolder.

参数

参数说明
targettarget ScoreHolder
objectiveobjective to set
valuescore value

addScore

addScore通用函数
kotlin
fun addScore(target: String, objective: Objective, delta: Int)

Add delta to a target's score by name.

参数

参数说明
targettarget name
objectiveobjective to modify
deltaamount to add

addScore

addScore通用函数
kotlin
fun addScore(target: Entity, objective: Objective, delta: Int)

Add delta to a target Entity's score.

参数

参数说明
targettarget Entity
objectiveobjective to modify
deltaamount to add

addScore

addScore通用函数
kotlin
fun addScore(target: ScoreHolder, objective: Objective, delta: Int)

Add delta to a ScoreHolder's score.

参数

参数说明
targettarget ScoreHolder
objectiveobjective to modify
deltaamount to add

getScore

getScore通用函数
kotlin
fun getScore(target: String, objective: Objective): Int?

Get a score by target name.

参数

参数说明
targettarget name
objectiveobjective to query

返回值

score value or null if not present

getScore

getScore通用函数
kotlin
fun getScore(target: Entity, objective: Objective): Int?

Get a score by Entity.

参数

参数说明
targettarget Entity
objectiveobjective to query

返回值

score value or null if not present

getScore

getScore通用函数
kotlin
fun getScore(target: ScoreHolder, objective: Objective): Int?

Get a score for a ScoreHolder.

参数

参数说明
targettarget ScoreHolder
objectiveobjective to query

返回值

score value or null if not present

resetScore

resetScore通用函数
kotlin
fun resetScore(target: String, objective: Objective)

Reset a target's score by name.

参数

参数说明
targettarget name
objectiveobjective to reset

resetScore

resetScore通用函数
kotlin
fun resetScore(target: Entity, objective: Objective)

Reset a target's score by Entity.

参数

参数说明
targettarget Entity
objectiveobjective to reset

resetScore

resetScore通用函数
kotlin
fun resetScore(target: ScoreHolder, objective: Objective)

Reset a ScoreHolder's score.

参数

参数说明
targettarget ScoreHolder
objectiveobjective to reset

leaveTeam

leaveTeam通用函数
kotlin
fun leaveTeam(members: Collection<ScoreHolder>)

Remove a collection of players from any teams.

参数

参数说明
memberscollection of ScoreHolder members to remove from teams

joinTeam

joinTeam通用函数
kotlin
fun joinTeam(team: PlayerTeam, members: Collection<ScoreHolder>)

Add members to a PlayerTeam.

参数

参数说明
teamPlayerTeam to join
memberscollection of ScoreHolder to add

emptyTeam

emptyTeam通用函数
kotlin
fun emptyTeam(team: PlayerTeam)

Empty a player team of all members.

参数

参数说明
teamPlayerTeam to empty

deleteTeam

deleteTeam通用函数
kotlin
fun deleteTeam(team: PlayerTeam)

Delete a player team from the scoreboard.

参数

参数说明
teamteam to delete

createTeam

createTeam通用函数
kotlin
fun createTeam(name: String, displayName: Component = Component.literal(name))

Create a team if it does not exist.

参数

参数说明
nameteam name
displayNamedisplay name component for the team

getTeam

getTeam通用函数
kotlin
fun getTeam(name: String): PlayerTeam?

Get a team by name.

参数

参数说明
nameteam name

返回值

PlayerTeam or null if not found

addTriggerValue

addTriggerValue通用函数
kotlin
fun addTriggerValue(serverPlayer: ServerPlayer, objective: Objective, i: Int)

Add a trigger score value for a player on a trigger objective.

参数

参数说明
serverPlayerplayer to modify
objectivetrigger objective
iamount to add

setTriggerValue

setTriggerValue通用函数
kotlin
fun setTriggerValue(serverPlayer: ServerPlayer, objective: Objective, i: Int)

Set a trigger score value for a player on a trigger objective.

参数

参数说明
serverPlayerplayer to modify
objectivetrigger objective
ivalue to set

simpleTrigger

simpleTrigger通用函数
kotlin
fun simpleTrigger(serverPlayer: ServerPlayer, objective: Objective)

Simple trigger: increment a trigger objective for a player by 1.

参数

参数说明
serverPlayerplayer to trigger
objectivetrigger objective