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.