All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Kube Utils
Projects / Mods

Kube Utils

by ErrorMikey • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

Kube Utils

Kube Utils is a simple addon to KubeJS which adds new functionality to existing features and branches off to create new systems that allow for more performant, simplified, and concise code.

BisectHosting

How it works

Kube Utils (Ku from now on) has been designed with the concept of a clear, concise, and consistent API like design. Everything added by this mod is held within the global Ku object meaning if you want to access level apis, you will access it via Ku.Level, if you want to do something with fluids you will use Ku.Fluids etc.

Features

Currently, we only have a few helpers to some of the lesser supported areas of KubeJS but we plan to expand this greatly over the life cycle of the systems development. If you have any suggestions, please make a feature request!

  • Level additions like being able to get structures at a block pos, ability to spawn structures, find entities and clear spaces, get a random location with a bounding box, etc.
  • Fluids, allow you to get a list of fluids based on their namespace(s), and being able to check if a fluid is empty or not.
  • List additions like getting random entries based on a weighted table
  • The addition of general utilities like nullOrEmpty which gives you a very simply way to always know if an object is nullOrEmpty whether it's a item, block, itemstack, string, fluid or itemEntity! (more support to come as required)
  • Completely documented code
  • Production validated
  • Clear and simple API

Our goals

  • We aim to never make breaking changes unless absolutely forced to by Minecraft, Forge or Fabric. At the point we feel we need to branch off and make breaking changes, it will be done in an optional way that will not affect existing code.
  • Never to make the additions overly complex
  • Always document the additions in plain English

Documentation

https://nanite.github.io/KubeUtils/

Disclaimer

Disclaimer, whist in beta, expect possible code breaking changes. Once we hit stable release, this message will be removed and from that point onwards, the code will not contain breaking changes!

Issues

Please report any issues to our issue tracker along with example code so we can validate the issues.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.1
Neoforge
last yr. 1
1.21.1
Neoforge
last yr. 1
1.20.1
Forge
last yr. 1
1.21.1
Neoforge
last yr. 1
1.20.1
Forge
last yr. 1
1.21.1
Neoforge
last yr. 1
1.20.4
Neoforge
last yr. 1
1.18.2
Forge
last yr. 1
1.19.2
Forge
last yr. 1
1.18.2
Forge
last yr. 1
1.19.2
Forge
last yr. 1
1.19.2
Forge
last yr. 1
1.19.2
Forge
last yr. 1
🖼️

No gallery images uploaded.

# Kube Utils Changelog

## [21.1.3]

### Fixed

  • ListKu.getRandomWeightedEntry no longer breaks when given valid data

## [21.1.2]

### Fixed

  • Issues with KubeJS 7.2+

## [21.1.1]

### Added

  • findFirstBlockTagWithinRadius to find a block within a radius that has a specific block tag.
  • findAnyEntitiesWithinRadius to find any entities within a radius based on an entity type.
  • findLivingEntitiesWithinRadius to find living entities within a radius based on an entity type.

### Deprecated

  • findEntitiesWithinRadius in favour of findLivingEntitiesWithinRadius

## [21.1.0]

### Changed


# Kube Utils Changelog

## [21.1.2]

### Fixed

  • Issues with KubeJS 7.2+

## [21.1.1]

### Added

  • findFirstBlockTagWithinRadius to find a block within a radius that has a specific block tag.
  • findAnyEntitiesWithinRadius to find any entities within a radius based on an entity type.
  • findLivingEntitiesWithinRadius to find living entities within a radius based on an entity type.

### Deprecated

  • findEntitiesWithinRadius in favour of findLivingEntitiesWithinRadius

## [21.1.0]

### Changed


# Kube Utils Changelog

## [20.1.1]

### Fixed

  • Backport release built not working correctly...

# Kube Utils Changelog

## [21.1.1]

### Added

  • findFirstBlockTagWithinRadius to find a block within a radius that has a specific block tag.
  • findAnyEntitiesWithinRadius to find any entities within a radius based on an entity type.
  • findLivingEntitiesWithinRadius to find living entities within a radius based on an entity type.

### Deprecated

  • findEntitiesWithinRadius in favour of findLivingEntitiesWithinRadius

## [21.1.0]

### Changed


# Kube Utils Changelog

## [20.1.0]

### Changed

  • Backported to 1.20.1

# Kube Utils Changelog

## [21.1.0]

### Changed


# Kube Utils Changelog

## [20.4.0]

### Changed

  • Updated to 1.20.4

Kube Utils Changelog
====================

\[0.1.3\]

### Added

  • Released for 1.18.2
Kube Utils Changelog
====================

\[1.0.0\]

### Added

  • Ported 1.19.2
Kube Utils Changelog
====================

\[0.1.4\]

### Added

  • A new ku.player.starter-items event that, once used and successfully gave items, will stop running

  • You can define an item and equipment slot (For things like armor) too \\\javascript onEvent("ku.player.starter-items", event => { // Item.of is optional here event.addItems("5x minecraft:gold_ingot", Item.of("2x minecraft:grass_block"))

// Valid options are part of the EquipmentSlot Enum event.addEquipmentItem("chest", "minecraft:golden\_chestplate") event.addEquipmentItem("offhand", "minecraft:stone") }) \\\

  • A new Ku.Player class that brings some helpful methods
  • showActionBar(text: string, color?: Color = Color.WHITE, bold = false, italic = false)
  • Uses the built-in client action bar to display a message. This is already supported through the player class but this method allows for less boilerplate and stable code ports
  • showActionBarComponent(component: Component)
  • Mostly the same as the above but gives you access to use a JS Object as your component which might look a something like this javascript const player = Ku.Player(event.player); player.showActionBarComponent({ text: "Hello", bold: true })
  • clearStarterItemsFlag
  • This method simply reset the flag for the ku.player.starter-items meaning on the next login, the player will be given the items once again
  • isClientSide
  • Lets you know if the client being wrapped is client side. This was mostly a helper for my code but it could be helpful

### Changed

  • Renamed the internal binding classes to be suffixed with Ku so they're visually different from vanilla and KubeJS
Kube Utils Changelog
====================

\[1.0.1\]

> This is features ported up for 0.1.4 (1.18.2 update)

### Added

  • A new KuEvents.playerStarterItems event that, once used and successfully gave items, will stop running

  • You can define an item and equipment slot (For things like armor) too \\\javascript KuEvents.playerStarterItems(event => { // Item.of is optional here event.addItems("5x minecraft:gold_ingot", Item.of("2x minecraft:grass_block"))

// Valid options are part of the EquipmentSlot Enum event.addEquipmentItem("chest", "minecraft:golden\_chestplate") event.addEquipmentItem("offhand", "minecraft:stone") }) \\\

  • A new Ku.Player class that brings some helpful methods
  • showActionBar(text: string, color?: Color = Color.WHITE, bold = false, italic = false)
  • Uses the built-in client action bar to display a message. This is already supported through the player class but this method allows for less boilerplate and stable code ports
  • showActionBarComponent(component: Component)
  • Mostly the same as the above but gives you access to use a JS Object as your component which might look a something like this javascript const player = Ku.Player(event.player); player.showActionBarComponent({ text: "Hello", bold: true })
  • clearStarterItemsFlag
  • This method simply reset the flag for the ku.player.starter-items meaning on the next login, the player will be given the items once again
  • isClientSide
  • Lets you know if the client being wrapped is client side. This was mostly a helper for my code but it could be helpful

### Changed

  • Renamed the internal binding classes to be suffixed with Ku so they're visually different from vanilla and KubeJS
Kube Utils Changelog
====================

\[1.0.2\]

### Added

  • Added a new Level method to allow for finding a single block within an area findSingleBlockWithinRadius
  • Added a triggeredBy field to the KuEvents.playerStarterItems event as we now trigger the event for a player joining as well as a player changing dimension. If the event does not place and item in the inventory. We assume it failed and will retry on either a join or a dimension change
Kube Utils Changelog
====================

\[1.0.3\]

### Changed

  • Updated support to KubeJS 6.1! This will cause issues when attempted to use with 6.0. You have been warned!

🌟 Related Projects

Similar modifications and resources you might like

View all →
Geckolib
G

Geckolib

by Gecko

A 3D animation library for entities, blocks, items, armor, and more!

620
mod
Building Wands
B

Building Wands

by nicguzzo

Building wands with different modes

179
mod
Coordinates Display
C

Coordinates Display

by Boxadactle

A basic mod that displays your Coordinates on the In-game HUD.

118
mod
Create: Steam 'n' Rails
C

Create: Steam 'n' Rails

by IThundxr

Adding depth to Create's rail network & steam system

99
mod
Kube Utils Icon
Download Kube Utils
Select game version
Select platform