Skip to main content
OyasaiUtilities provides shared utility functions and helper methods used by other Oyasai plugins.

​
Overview

  • Version: 0.1.0
  • API Version: 1.21
  • Authors: Srain3, takucan
  • Dependencies: Purpur API, Vault API

​
Features

Color formatting

Convert color codes and strip formatting

ItemStack utilities

Add display names, lore, and hide flags

Teleport history

Track player teleport locations

Timer bars

Display countdown timers to players

​
API Reference

​
Color formatting

import icu.oyasai.utilities.OyasaiUtilities.color
import icu.oyasai.utilities.OyasaiUtilities.unColor

// Convert & to § color codes
val colored = "&aHello &bWorld".color()

// Strip color codes
val plain = "§aColored text§r".unColor()

​
ItemStack utilities

import icu.oyasai.utilities.OyasaiUtilities.addText
import icu.oyasai.utilities.OyasaiUtilities.allHide

val item = ItemStack(Material.DIAMOND_SWORD)
  .addText(
    "&6Legendary Sword",
    mutableListOf("&7A powerful weapon", "&8Forged in fire")
  )
  .allHide()

​
Commands

Teleport back to your previous location.Aliases: /bk
Teleport forward in your TP history.Aliases: /fow, /fw
Display and copy a player’s UUID to clipboard.
Create and manage countdown timer bars.Permission: oyasaiutilities.timerbar
Administrative blueprint management.Aliases: /abp
Manage automatic ore smelting.Aliases: /os

​
Permissions

​
oyasaiutilities.timerbar
permission
Allows use of the /timerbar command.
​
oyasaiutilities.tpdata
permission
default:"op"
View all players’ teleport history.
​
cm.bypass
permission
default:"op"
Bypass CreativeManagement restrictions.
​
cm.bypass.spawn_egg
permission
default:"op"
Bypass spawn egg restrictions in CreativeManagement.

​
Source code

The plugin source is located at plugins/OyasaiUtilities/ in the repository. Key files:
  • src/main/kotlin/icu/oyasai/utilities/OyasaiUtilities.kt - Core utilities
  • src/main/kotlin/icu/oyasai/utilities/Main.kt - Plugin entry point
  • src/main/resources/plugin.yml - Plugin configuration

Build docs developers (and LLMs) love

Get started for freeTalk to us