API

Sanggunian ng CraftScript

Bawat keyword, operator, function at member na magagamit.

Mga keyword

Susing salita Gamit
let / var / const Magdeklara ng variable (hindi puwedeng i-reassign ang const).
fun Mga function na may pangalan at lambda fun(x) { }.
class, extends, this, super Mga class at inheritance.
enum Mga enumeration.
import, from, as Mga module.
if, else, while, for … in, break, continue, return Control flow.
and, or, not (o &&, ||, !) Logic.
true, false, null Mga literal.
mod, item, block, recipe Mga deklarasyon ng content.
ore, tree, patch, structure, biome, dimension, terrain, biome_map, carver Mga deklarasyon ng world generation. Tingnan ang World generation at Paglikha gamit ang code.
on … priority Event handler.
command … requires … alias … describe Mga command.
every, after + ticks/seconds/minutes Mga timer.

Mga comment: // line, # line, /* block */. Pinaghihiwalay ng line break (o ng ;) ang mga statement.

Mga operator

Operator Kahulugan
+ - * / % Arithmetic. Nagko-concatenate ang + kung string ang isang panig; pinagdudugtong din nito ang mga list.
== != < <= > >= Paghahambing. Magkapantay ang id at string kung iisang id ang kinakatawan nila.
= += -= *= /= Assignment.
?? Default value kung null ang kaliwang panig.
?. Ligtas na access: nagre-return ng null sa halip na pumalya.
a..b Inclusive na range ng mga numero.
x[i] Index ng list (nagbibilang mula sa dulo ang negatibo), key ng map, character ng string.

Mga falsy value: null, false, 0, "", walang lamang list o map.

Mga built-in function

Punsiyon Paglalarawan
print(...) Sumusulat sa log ng server.
log(...) Gaya ng print, kasama ang pangalan ng mod.
str(x) Kino-convert sa string.
num(x) Kino-convert sa numero (o null).
int(x) Integer na bahagi.
round, floor, ceil, abs, sqrt Math.
min(...), max(...) Pinakamaliit/pinakamalaki sa mga numero.
sin, cos, atan2, pi() Trigonometry, sa radian.
len(x) Haba ng string, list o map.
type(x) Pangalan ng type.
is(x, Class) Tinitingnan ang class o enum.
random(), random(n), random(a, b) Decimal 0–1, integer 0–n, integer a–b.
chance(p) true na may probability na p (0–1).
pick(list) Random na elemento.
now() Kasalukuyang millisecond.
id("ns:path") Gumagawa ng identifier.
item(id, count?, name?) Gumagawa ng ItemStack.
color(text) Kino-convert ang & sa mga color code.
broadcast(msg) Mensahe sa lahat ng player.
run(command) Nagpapatakbo ng command ng laro bilang console. Emergency na labasan: sa laro ang format ng command at puwede itong magbago.
player(name) Online na player o null.
players() Listahan ng mga player.
world(id?) Mundo (ang overworld bilang default).
mod_loaded(id) Naka-load ba ang ibang mod?
config(name, values?, synced?) Nagdedeklara o nagbabasa ng settings file ng mod.
listen(channel, fun(data, player)) Tumatanggap ng data sa isang channel ng mod.
send(player, channel, data) Nagpapadala ng data mula sa server papunta sa isang player.
send_to_server(channel, data) Nagpapadala ng data mula sa client papunta sa server.
server Ang server.
tick Kasalukuyang tick.
game_version, namespace Bersyon ng Minecraft at ang namespace ng mod.

Mga member ng string

length, upper(), lower(), trim(), contains(s), starts_with(s), ends_with(s), split(sep), replace(a, b), repeat(n), substring(from, to?), is_empty.

Mga member ng list

size, is_empty, first, last, add(x)/push(x), remove(x), remove_at(i), contains(x), index_of(x), join(sep), reverse(), sort(), clear(), map(f), filter(f), each(f), any(f), all(f), sum().

Mga member ng map

keys(), values(), has(k), get(k, default?), remove(k), size; at direktang access gamit ang map.key o map["key"].

Mga object ng laro

Gumagamit ng snake_case ang mga pangalan (max_health) at pareho silang member gaya ng sa Kotlin (maxHealth). Ginagamit bilang string ang mga enum (player.game_mode = "creative"). Nasa Ang mundo at ang mga manlalaro ang detalye ng bawat isa.

Uri Mga property Mga method
Player name, uuid, health, max_health, food_level, game_mode, inventory, held_item, is_op, is_sleeping, has_crafting_client, location, world, custom_name, is_alive, data send, action_bar, title, give, set_held_item, play_sound, teleport, heal, damage, has_permission, kick, set_rotation, add_tag, has_tag, set_cooldown, has_cooldown
World id, players, time, is_raining, data block_at, set_block (may opsyonal na state), spawn, drop_item, explode, strike_lightning, spawn_particle, play_sound, light_at, container_at, set_sign_text, set_chunk_loaded, entities, living_near, shoot, summon
Block type, x, y, z, world, location, is_solid, data set_type, relative
Entity uuid, type, world, location, custom_name, is_alive, data, direction, vehicle teleport, remove, set_rotation, add_tag, has_tag
LivingEntity lahat ng nasa Entity, health, max_health damage, heal, set_ai, add_effect, remove_effect, has_effect, effects, add_modifier, remove_modifier, attribute, set_attribute, equipment, set_equipment
Inventory size get, set, add, count, clear
Location world, x, y, z, yaw, pitch, block_x, block_y, block_z add, distance_to
data (store) keys; nagbabasa at nagsusulat ang data["key"] get, set, get_int, get_number, get_string, get_boolean, remove, clear
ItemStack item, count, name, lore, data, enchantments with_count
Server players, worlds, motd, tps, is_dedicated player, world, broadcast, stop, run_command

Mga object ng world generation

Ang natatanggap ng mga function ng deklarasyon ng world generation habang ginagawa ang mga chunk. Ipinaliwanag sa pahinang Paglikha gamit ang code.

Object Mga property Mga method
world (pagbuo ng istruktura) x, y, z, seed, min_y, max_y block, state, is_air, is_in, can_stay, set (may opsyonal na mga state), inside, surface, top, flow, structures, place_file
plan (plano ng istruktura) chunk_x, chunk_z, seed, min_y height, biome, column, file_size
site (pagbuo ng istruktura) x, y, z, radius, min_y, max_y, data, seed
world (terrain) seed, min_y, height biome
world (biome_map) seed tagged
ctx (carver) seed, start_x, start_z, chunk_x, chunk_z, min_y, max_y carve
at (lupa ng biome) x, y, z, depth_above, depth_below, surface_depth, steep noise

Mga type ng argument ng command

player, int, number, bool, string (isang salita), text (ang natitira sa linya), id. Magdagdag ng ? para gawin itong opsyonal.

Mga limitasyon

  • 2,000,000 hakbang bawat invocation (event, command o timer).
  • 200 nested na tawag (recursion).
  • Mga range na hanggang 1,000,000 elemento.