Standard Library

RedScript includes a standard library with common utilities.

Usage

import "stdlib/effects.mcrs"
import "stdlib/world.mcrs"

fn game_start() {
    set_day();
    weather_clear();
    buff_all(@a, 600);
}

Modules

math.mcrs

Basic math operations.

import "stdlib/math.mcrs"

fn example() {
    let a = abs(-5);        // 5
    let b = min(3, 7);      // 3
    let c = max(3, 7);      // 7
    let d = clamp(15, 0, 10); // 10
    let s = sign(-42);      // -1
}

Function	Description
abs(x)	Absolute value
min(a, b)	Minimum of two values
max(a, b)	Maximum of two values
clamp(x, min, max)	Clamp to range
sign(x)	Sign (-1, 0, or 1)

effects.mcrs

Effect shortcuts for common potion effects.

import "stdlib/effects.mcrs"

fn power_up() {
    speed(@p, 200, 2);      // Speed II for 10 seconds
    strength(@p, 200, 1);   // Strength I for 10 seconds
    regen(@p, 100, 0);      // Regen I for 5 seconds
}

Function	Description
speed(target, duration, level)	Speed effect
jump(target, duration, level)	Jump boost
regen(target, duration, level)	Regeneration
resistance(target, duration, level)	Resistance
strength(target, duration, level)	Strength
invisible(target, duration)	Invisibility
night_vision(target, duration)	Night vision
slow_fall(target, duration)	Slow falling
glow(target, duration)	Glowing
clear_effects(target)	Remove all effects
buff_all(target, duration)	Speed + strength + regen + resistance

world.mcrs

World and game rule utilities.

import "stdlib/world.mcrs"

@load
fn setup() {
    set_day();
    weather_clear();
    enable_keep_inventory();
    disable_mob_griefing();
}

Time:

• set_day(), set_night(), set_noon(), set_midnight()

Weather:

• weather_clear(), weather_rain(), weather_thunder()

Gamerules:

• enable_keep_inventory(), disable_keep_inventory()
• disable_mob_griefing(), disable_fire_spread()

Difficulty:

• set_peaceful(), set_easy(), set_normal(), set_hard()

Building:

• barrier_wall(x1, y1, z1, x2, y2, z2) — Create barrier wall
• clear_area(x1, y1, z1, x2, y2, z2) — Fill with air
• glass_box(x1, y1, z1, x2, y2, z2) — Hollow glass box

inventory.mcrs

Inventory management.

import "stdlib/inventory.mcrs"

fn respawn_player(player: selector) {
    clear_inventory(player);
    give_kit_warrior(player);
}

Function	Description
clear_inventory(target)	Clear all items
give_kit_warrior(target)	Iron armor + sword + shield
give_kit_archer(target)	Bow + arrows + leather armor
give_kit_mage(target)	Potions + ender pearls
remove_item(target, item)	Remove specific item

cooldown.mcrs

Cooldown system using scoreboards.

import "stdlib/cooldown.mcrs"

fn use_ability() {
    if (is_on_cooldown(@s) == 0) {
        // Do ability
        say("Ability used!");
        cooldown_start(@s, 100);  // 5 second cooldown
    }
}

@tick
fn tick_cooldowns() {
    cooldown_tick();
}

timer.mcrs

Timer utilities.

import "stdlib/timer.mcrs"

fn start_game() {
    timer_start("game", 6000);  // 5 minute timer
}

@tick
fn check_timer() {
    timer_tick();
    if (timer_done("game") == 1) {
        announce("Game Over!");
    }
}

player.mcrs

Player state helpers.

import "stdlib/player.mcrs"

fn heal_player() {
    heal(10);  // Add 10 health
}

fn check_admin() {
    if (is_op() == 1) {
        say("You are admin");
    }
}

combat.mcrs

Combat utilities.

import "stdlib/combat.mcrs"

fn on_hit(target: selector) {
    apply_damage(target, 5);
    knockback(target, 2);
}

mobs.mcrs

Mob spawning helpers.

import "stdlib/mobs.mcrs"

fn spawn_wave() {
    spawn_zombie(0, 64, 0);
    spawn_skeleton(5, 64, 0);
    spawn_creeper(-5, 64, 0);
}