Utilities

// Formatted system message with gradient prefix
ChatUtils.sendSystemMessage("Hello, <green>world!</green>")
 
// Custom message type
ChatUtils.sendSystemMessage("Debug info", MessageType.DEBUG)
 
// Raw (no prefix)
ChatUtils.sendSystemMessage("<red>Error</red>", MessageType.RAW)
 
// Send as the player (in chat)
ChatUtils.sendPlayerMessage("/hub")
 
// Execute a command silently
ChatUtils.sendCommand("hub")

<red>, <blue>, <green>, <gray>, <dark_gray>, <gold>, <aqua>, <yellow>, <light_purple>
<b>/<bold>, <i>/<italic>, <u>/<underline>, <st>/<strikethrough>, <obf>/<obfuscated>
<reset>
<gradient:#hex1:#hex2>text</gradient>
<#ff0000>hex colors</#ff0000>

val gradient = ChatUtils.buildGradientComponent(
    text = "Cobalt",
    startColor = 0x4CADD0,
    endColor = 0xB2F9FF
)

PlayerUtils.ign              // "Notch"
PlayerUtils.rotation         // current Rotation(yaw, pitch)
PlayerUtils.velocity         // Vec3
PlayerUtils.blockStandingOn  // BlockPos
PlayerUtils.onGround         // Boolean
PlayerUtils.isInventoryFull  // Boolean
PlayerUtils.isInventoryEmpty // Boolean
PlayerUtils.canFly           // Boolean
PlayerUtils.isFlying         // Boolean
PlayerUtils.isSuffocating    // Boolean
 
// Set player rotation (with normalization)
PlayerUtils.setRotation(Rotation(90f, 0f))
 
// Close open screen/container
PlayerUtils.closeScreen()

val w = WindowUtils.windowWidth   // Float
val h = WindowUtils.windowHeight  // Float
val sx = WindowUtils.scaleX       // width / 1920
val sy = WindowUtils.scaleY       // height / 1080

// Press a key once
Keyboard.press(minecraft.options.keyJump)
 
// Hold/release keys
Keyboard.setKeyState(minecraft.options.keyAttack, true)
Keyboard.setKeyState(minecraft.options.keyUse, false)
 
// Stop all movement
Keyboard.stopMovement()
 
// Hold specific keys, release all others
Keyboard.holdThese(minecraft.options.keyUp, minecraft.options.keyJump)
 
// Release all except
Keyboard.releaseAllExcept(minecraft.options.keyShift)
 
// Check if a key is down
Keyboard.isKeyDown(InputConstants.KEY_W)
 
// Pre-built arrays for convenience
Keyboard.allKeys        // attack, use, movement, jump, shift, sprint
Keyboard.movementKeys   // wasd, jump, shift

// Click buttons
Mouse.leftClick()
Mouse.rightClick()
Mouse.middleClick()
 
// Hit detection
Mouse.isHoveringOver(x, y, width, height)  // Boolean
 
// Cursor position
Mouse.mouseX  // Float
Mouse.mouseY  // Float
 
// Mouse mode
Mouse.mouseMode = MouseMode.UNGRAB_MOUSE  // free cursor
Mouse.mouseMode = MouseMode.LOCK_MOUSE    // locked in place
Mouse.mouseMode = MouseMode.DEFAULT       // normal behavior

// Click a slot
InventoryUtils.clickSlot(36, MouseButton.LEFT)
 
// Select a hotbar slot (0-8, returns false if invalid)
InventoryUtils.selectHotbarSlot(3)
 
// Hold a named item from hotbar
InventoryUtils.holdItem("Fishing Rod")
 
// Find items
InventoryUtils.findItemInHotbar("Sword")              // slot index or -1
InventoryUtils.findItemInInventory("Rotten Flesh")    // slot index or -1
InventoryUtils.findItemInInventory(Items.ROTTEN_FLESH) // by Item type
InventoryUtils.findItemInContainer("Enchanted Book")  // in open container
InventoryUtils.findItemInContainer(Items.BOOK)
 
// Find items by lore text
InventoryUtils.findItemInHotbarWithLore("§6Legendary")
InventoryUtils.findItemInInventoryWithLore("§cCommon")

val loreLines = ItemUtils.getLoreLines(itemStack)  // List<Component>

// To a position
val rot = RotationMath.getRotation(Vec3(x, y, z))
 
// Between two points
val rot = RotationMath.getRotation(fromVec, toVec)
 
// Angle difference
val diff = RotationMath.angleDifference(90f, 45f) // 45.0
 
// Check if close enough
RotationMath.approximatelyEquals(currentRot, targetRot, tolerance = 2f)

// Basic rotation
Rotation(yaw = 90f, pitch = 0f)
 
// Normalize for server (accounts for sensitivity/GCD)
val normalized = rotation.normalize(currentPlayerRotation)
 
// Delta between rotations
val delta = current.rotationDeltaTo(target)
delta.deltaYaw    // Float
delta.deltaPitch  // Float

RotationTarget(entity)           // track an Entity
RotationTarget(Vec3(x, y, z))    // track a position
RotationTarget(BlockPos(x, y, z)) // track a block
RotationTarget(Rotation(y, p))   // absolute rotation
 
// Resolve to the target rotation
val mainTarget = rotationTarget.targetRotation

// Rotate to face a specific yaw/pitch
Rotations.start(Rotation(yaw = 90f, pitch = 0f))
 
// Rotate to face a block
Rotations.start(RotationMath.getRotation(Vec3.atCenterOf(blockPos)))

// Track a moving entity
Rotations.track(RotationTarget(entity))
 
// Track a position
val target = RotationTarget(Vec3(x, y, z))
Rotations.track(target)
 
// Update the target each tick
// (the RotationTarget holds a reference, so it updates automatically
//  if you pass an Entity that moves)

Rotations.stop()

Rotations.running  // Boolean

@SubscribeEvent
fun onTick(event: TickEvent.Start) {
    if (!Rotations.running) return
 
    // If using track mode, the target updates as the entity moves
    val target = entityTarget ?: return
    Rotations.track(target)
}

Cobalt.minecraft         // Minecraft.getInstance()
Cobalt.configDir         // Path to config/cobalt/
Cobalt.MOD_ID            // "cobalt"
Cobalt.MOD_NAME          // "Cobalt"
Cobalt.MOD_VERSION       // version string
Cobalt.MINECRAFT_VERSION // current MC version
 
// Run code on the client thread (safe from any thread)
Cobalt.runOnClientThread {
    // mc calls here
}

import org.cobalt.util.color.*
 
// Extract channels from Int color
val r = colorInt.red
val g = colorInt.green
val b = colorInt.blue
val a = colorInt.alpha
 
// Change alpha on a java.awt.Color
Color(255, 0, 0).updateAlpha(128)  // semi-transparent red

TickScheduler.schedule(20L) {  // 20 ticks = 1 second
    minecraft.gui.setScreen(ConfigScreen)
}

val timer = Clock()
 
timer.schedule(1000) // wait 1000ms
// later:
if (timer.passed()) {
    // do thing
    timer.schedule(500)
}
timer.isScheduled  // Boolean
timer.reset()

Multithreading.runAsync {
    // Heavy computation here
    Thread.sleep(100)
    // Don't call Minecraft APIs here (not thread-safe)
}

ConnectionTracker.averageTps  // Double (0.0 - 20.0)
ConnectionTracker.currentPing // Int (ms)
ConnectionTracker.averagePing // Int (ms)

Scoreboard.title  // Component?
Scoreboard.lines  // List<Component>

Tablist.lines  // List<Component> (sorted, no spectators last)