growtopia.wasm

A universal Growtopia ENet library compiled to WebAssembly (WASM) for Node.js, Bun.js. Designed as a cross-platform replacement for growtopia.js.

Why replacement of growtopia.js?

growtopia.js relied on native Rust bindings compiled via napi-rs, requiring platform-specific binary builds and causing compatibility issues across different platforms. growtopia-wasm solves this by compiling the Rust core ENet library directly into WebAssembly, guaranteeing seamless execution across Node.js, Bun.js environments.

Differences between growtopia.js and growtopia.wasm

Installation

npm install growtopia.wasm
Copy

or with Bun:

bun add growtopia.wasm
Copy

ENet Server Example

import { NodeENetServer, init, Packet, PacketKind } from "growtopia.wasm";

async function main() {
  // Initialize WebAssembly core
  await init();

  // Initialize ENet server host (IP, Port, Max Peers, Channels)
  const server = new NodeENetServer("127.0.0.1", 17091, 1024, 2);
  await server.start();

  // Start event polling loop
  server.startPolling(15);

  server.emitter.on("connect", peer => {
    console.log(`Client connected: ID ${peer.id} from ${peer.ip}:${peer.port}`);

    // Send Hello packet (Type 1)
    const helloPayload = new Uint8Array([1, 0, 0, 0, 0]);
    const helloPacket = new Packet(helloPayload, PacketKind.Reliable);
    peer.send(helloPacket);
  });

  server.emitter.on("disconnect", (peer, data) => {
    console.log(`Client disconnected: ID ${peer.id}, code: ${data}`);
  });

  server.emitter.on("receive", (peer, packet, channelId) => {
    const data = packet.data();
    console.log(`Received ${data.length} bytes on channel ${channelId} from peer ${peer.id}`);
  });
}

main();
Copy

ENet Client Example

import { NodeENetClient, init } from "growtopia.wasm";

async function main() {
  await init();

  const client = new NodeENetClient("0.0.0.0", 0, 1, 2);
  await client.start();

  const peer = client.connect("127.0.0.1", 17091, 2, 0);
  client.startPolling(15);

  client.emitter.on("connect", p => {
    console.log(`Connected to server! Peer ID: ${p.id}`);
  });

  client.emitter.on("disconnect", (p, data) => {
    console.log(`Disconnected from server. Code: ${data}`);
  });

  client.emitter.on("receive", (p, packet, channelId) => {
    const data = packet.data();
    console.log(`Received packet on channel ${channelId}: ${data.length} bytes`);
  });
}

main();
Copy

Packet Serialization Example

import { TextPacket, TankPacket, Variant } from "growtopia.wasm";

// Text Packet (Action / Login)
const textPacket = TextPacket.from(3, "action|refresh_item_data", "");
const textBuf = textPacket.parse();

// Tank Packet (State / Motion)
const tankPacket = TankPacket.from({
  type: 0x3,
  netID: 10,
  xPos: 100.5,
  yPos: 200.25
});
const tankBuf = tankPacket.parse();

// Variant List Packet
const variant = Variant.from({ netID: 1, delay: 0 }, "OnConsoleMessage", "Hello Growtopia!");
const variantTankPacket = variant.parse();
Copy

Links

• Documentation
• Discord Community