@mcbe-mods/utils

Utility functions for Minecraft Bedrock Edition mod development.

Usage

Install:

npm install @mcbe-mods/utils

import { calcGameTicks, color, Experience, getRadiusRange, getRandomProbability, getRandomRangeValue, splitGroups } from '@mcbe-mods/utils'

// splitGroups - split items into stacks
splitGroups(65) // => [64, 1]
splitGroups(140) // => [64, 64, 12]

// color - Minecraft formatting codes
color.green.italic.bold('Dedicated Ser') + color.reset('ver') + color.red.obfuscated('!!!')
// => '§a§o§lDedicated Ser§rver§c§k!!!'

// Experience - player XP calculation
const exp = new Experience()
exp.addXP(100)
exp.getLevel() // => 7

// calcGameTicks - time to ticks
calcGameTicks(1000) // => 20

// getRadiusRange - block position range
getRadiusRange({ x: 0, y: 0, z: 0 }, 1) // => 27 positions

API

| Function | Description | | --- | --- | | splitGroups(sum, groupSize?) | Split a number into groups of a given size | | color | Minecraft color/formatting code stylizer | | Experience | Player experience calculator (leveling up) | | calcGameTicks(ms?, ticksPerSec?, msPerSec?) | Convert real time to game ticks | | getRadiusRange(location, radius?) | Get block positions within a radius | | getRandomProbability(probability) | Random chance with percentage | | getRandomRangeValue(min, max) | Random integer within a range |

License

MIT License © Lete114