How do you use scripts in Bloxd.io?

You can use scripts by placing a 'Code Block' in your world and writing JavaScript inside it. The code runs when a player interacts with the block, using the global 'api' object to modify the game world, such as teleporting players or giving items.

What are some basic scripting commands in Bloxd.io?

Some of the most common scripting commands are `api.teleport(myId, x, y, z)` to move a player, `api.giveItem(myId, 'diamond', 1)` to grant items, and `api.setVelocity(myId, 0, 15, 0)` to launch a player into the air.

Scripting Basics with Code Blocks API

Learn how to use the Code Blocks API to make interactive worlds.

1. Introduction to Code Blocks

Code Blocks in Bloxd.io allow you to run JavaScript code when a player interacts with them. This enables you to create minigames, teleporters, shops, and complex mechanisms.

2. The BloxdForge Editor

Writing code directly in the small in-game window is difficult. BloxdForge provides a professional development environment (IDE) for scripts.

AI Assistant

Stuck on a script? Open the AI panel and ask: "Write a script that gives the player speed when they click this block." The AI understands the specific Bloxd API functions.

Real-time Linter

The editor automatically checks for errors. If you use a function that doesn't exist (e.g., api.kill() instead of api.killLifeform()), it will underline it in yellow and suggest the fix.

3. Essential API Commands

Here are the most common functions you will use in your scripts.

movement.js

/* Launch player into the air */
const velocity = { x: 0, y: 25, z: 0 };
api.setVelocity(myId, velocity.x, velocity.y, velocity.z);

/* Teleport player */
api.setPosition(myId, 100, 50, 100);

items.js

/* Give items (ID, ItemName, Amount) */
api.giveItem(myId, "diamond", 5);

/* Check if player has item */
if (api.hasItem(myId, "gold_ingot")) {
    api.sendMessage(myId, "Rich!");
}

4. Debugging Tips

Console Logs: Use api.log("Message"); to print to the browser console (F12).
Chat Output: Use api.sendMessage(myId, "Debug info"); to print variable values directly to your chat.
Remember that single-line comments (//) are often broken in Bloxd. Use /* ... */ blocks instead.

Loading Guide...