LLM Primer

render.rect(x, y, w, h, 0xFF4CAF50);                  // ✓ 直接传
render.rect(x, y, w, h, new Color(255, 100, 0).getRGB()); // ✓ int → long widen 自动

int c = 0xFF4CAF50;               // ✗ 溢出，BSH 抛 "cannot assign 4283215696 to int"
int c = (int) 0xFF4CAF50;          // ✗ BSH 的 (int) 超界不做截断，直接抛

int b = (int) event.get("button");        // ✗ 可能 ClassCastException
Number n = (Number) event.get("x");       // ✗ 同上

int b = event.getInt("button");            // ✓
double x = event.getNumber("x");            // ✓ (返回 double，也能拿 Integer 字段)

if (cond) {
    x = 1;           // 块内新变量，外面看不到
} else {
    x = 2;
}
me.log(x);           // ✗ Undefined argument: x

x = 0;
if (cond) { x = 1; } else { x = 2; }
me.log(x);           // ✓

vm.registerButton("k", "Run", "onClick");         // "onClick" 是脚本里的方法名
void onClick() { me.log("clicked"); }

property.onChange("onValueChange");
me.async("doInBackground");
bridge.addPublicMethod("ns", "exposedFunc");
packet.sendSequenced("buildPacket");

String cached = "";        // 主线程读
boolean ready = false;

void fetch() {
    r = HttpClient.get("...");
    cached = r.body;         // 后台写
    ready = true;
}

@EventTarget(events="tick")
void tick(e) {
    if (ready) {             // 主线程消费
        me.log(cached);
        ready = false;
    }
}

@EventTarget(events="chat")
void onChat(e) {
    if (e.getString("message").startsWith(".")) return;  // cheart 命令透过
    e.put("message", "[cheart] " + e.getString("message")); // 改消息
    // e.cancel();  // 或者完全吞掉
}

@EventTarget(events="send_packet")
void onSend(e) {
    if ("ServerboundSwingPacket".equals(e.getString("type"))) {
        e.cancel();  // 不发
    }
}

@Module(name="Example", category="PLAYER", defaultEnabled=false)
void meta(vm) {
    vm.registerSliderDouble("speed", "Speed", 0.0, 5.0, 2.0, 0.1);
    vm.registerBoolean("notify_toggle", "Notify on Toggle", true);
}

@OnEnable  void onEnable()  {
    if (me.getBool("notify_toggle")) notify.info("Example", "on");
}
@OnDisable void onDisable() {
    if (me.getBool("notify_toggle")) notify.alert("Example", "off");
}

@EventTarget(events="tick")
void tick(event) {
    p = me.getPlayer();
    if (p == null) return;
    speed = me.getNumber("speed");
    // ...
}

@Module(name="Box ESP", category="VISUAL")
void meta(vm) { vm.registerColor("color", "Color", 0xFF00FF00); }

@EventTarget(events="render_2d")
void onRender(e) {
    self = me.getPlayer();
    if (self == null) return;
    long c = moduleManager.self().getProperty("color").getRGB();
    for (ent : me.getWorld().getPlayerEntities()) {
        if (ent.getId() == self.getId()) continue;
        r = render.worldBoxToScreenEntity(ent);
        if (r == null) continue;
        render.outline(r[0], r[1], r[2]-r[0], r[3]-r[1], 1.0, c);
    }
}

@EventTarget(events="render_3d")
void onRender3D(e) {
    if (!render3d.isPost()) return;      // 只在 post 画
    render3d.clearDepth();               // 文字前清深度
    for (ent : me.getWorld().getItemEntities()) {
        p = render3d.interpolatedPos(ent);
        render3d.text("Item", p.x, p.y + 0.8, p.z, 1.5, true);
    }
}

@EventTarget(events="player_update")
void onPU(e) {
    p = me.getPlayer();
    if (p == null) return;
    // find (x, y, z, face)...
    float[] rot = me.getRotation(centerX, centerY, centerZ);
    me.setRotation(rot[0], rot[1], 180f, true);    // moveFix = true
    me.placeBlock(x, y, z, face, "MAIN_HAND");
}

// 文件名：_math_libs.bsh（下划线前缀，先加载）
@OnLoad void reg() {
    bridge.addPublicMethod("math", "distance");
    bridge.addPublicMethod("math", "lerp");
}
double distance(x1, y1, x2, y2) {
    return Math.sqrt((x2-x1)*(x2-x1) + (y2-y1)*(y2-y1));
}
double lerp(a, b, t) { return a + (b - a) * t; }

// 其他脚本：
d = bridge.invokePublicMethod("math", "distance", 0.0, 0.0, 3.0, 4.0);

volatile String pending = null;

@Command(name="weather")
void exec(args) { me.async("fetch"); }

void fetch() {
    r = HttpClient.get("https://wttr.in/?format=3");
    if (r.isOk()) pending = r.body.trim();   // 后台写
}

@EventTarget(events="tick")
void tick(e) {
    if (pending != null) {                    // 主线程消费
        me.chat(pending);
        pending = null;
    }
}

@Command(name="myui")
void exec(args) { me.openScreen("my_ui"); }

@OnLoad void onLoad() { me.registerScreen("my_ui"); }

@EventTarget(events="render_screen")
void onR(e) {
    render.rect(100, 100, 200, 100, 0xE0101418);
    render.textCentered("Hello", 200, 140, 0xFFFFFFFF);
}

@EventTarget(events="mouse_clicked")
void onClick(e) {
    double mx = e.getNumber("mouse_x"), my = e.getNumber("mouse_y");
    if (mx > 100 && mx < 300 && my > 100 && my < 200) {
        me.log("clicked");
    }
}

@EventTarget(events="close")
void onClose(e) { me.log("closed"); }