scarpet-additions

A Carpet mod extension for some additional scarpet functions

Reqires Carpet mod

Functions

convert_color(color,model,output)

Converts a color from one model to another.

color -> List: Depending on specified model

model -> String: Input color model, can be RGB, RGBA or HSB

• RGB: List of a red, green and blue value
• RGBA: List of a red, green, blue and alpha value
• HSB: List of a hue, saturation and brightnes value

output -> String: Output color model, can be RGB, RGBA, HEX or NUM

• RGB: List of a red, green and blue value
• RGBA: List of a red, green, blue and alpha value
• HEX: String of hex characters (without leading '#') Can be used for format()
• NUM: Number representing the color as 4 bytes: 0xRRGGBBAA. Can be used for 'color' parameter in draw_shape()

Examples:

convert_color([255,128,0],'rgb','hex'); -> 'FF8000'

convert_color([255,128,0],'rgb','num'); -> 0xff7f00ff

convert_color([0,255,255],'hsb','hex'); -> 'FF0000'

convert_color([120,255,255],'hsb','hex'); -> '00FF00'

Example:

__on_tick() -> (
    if((tick_time() % 2) == 0,
        headerHue = tick_time()%360;
        headerGlossIndex = (floor(tick_time()/3)%40)-10;
        header = [];
        title = 'MinecraftServer';
        for(range(length(title)),
            if(abs(_-headerGlossIndex) < 3,
                c = convert_color([headerHue,abs(_-headerGlossIndex)/3*255,255],'hsb','hex');
            ,
                if(_ < 7,
                    c = convert_color([headerHue,255,190],'hsb','hex');
                ,
                    c = convert_color([headerHue,255,255],'hsb','hex');
                );
            );
            put(header,null,str('b#%s %s',c,slice(title,_,_+1)));
        );
        header = format(header);
        footer = format('r to the server!');
        set_tab_text(header,footer);
  )
);

http_request(options)

Performs a http request specified by the given options.

This call is blocking, so you should use it in a task()!

The options parameter is a map value with the following keys:

• uri (String): The URI to request from
• method (String, optional): The http request method. For example GET, POST, DELETE,... Defaults to GET
• headers (Map, optional): Each map entry is a string key pointing to a string, or list of strings
• body (String): The body for POST or other requests

The function returns a map with the following entries:

• status_code (number): The status code of the request
• body (String): The body returned from the request
• headers (Map: string -> [strings]): The received response headers
• uri (String): The originally requested URI

When the request fails, a http_request_error exception is thrown, which can be caught with try(). This is only for actual failures to make the request (such as a network error). Successful requests with a 400 or 500 status code will not throw an exception.

Note that the response body is not parsed as json or html escaped. Use the escape_html and unescape_html functions, as well as the scarpet-builtins encode_json and decode_json.

Example usage:

// simple get request and parsing

response = http_request({
    'uri'->'https://opentdb.com/api.php?amount=1'
});

print('Response: ' + response);

if(response:'status_code' != 200,
    print('Request failed: ' + response:'status_code');
,
    body = decode_json(response:'body');
    print('\n\nBody: ' + body);

    question_data = body:'results':0;
    question = unescape_html(question_data:'question');
    answer = unescape_html(question_data:'correct_answer');

    print('\n\n\n' + question + '\n' + answer);
);

escape_html(html)

Returns the escaped html string (e.g. " -> ")

unescape_html(html)

Returns the unescaped html string (e.g. " -> ")

list_text(header, footer, player?)

Sets header and footer in tab menu of all players, or changes it for one player if player? is given.

set_motd(motd)

Sets the message of the day of the server.