CC: Tweaked (Minecraft).

Scripts on a ComputerCraft computer in a Minecraft: Java Edition world, through the CC: Tweaked mod. Not an official Minecraft product; not approved by or associated with Mojang or Microsoft.

This page is generated from the SDK's platform registry (sdk/environments.json) and the adapter's SETUP.md. The CC: Tweaked (Minecraft) page on the site is the short version.

How it runs

A program on one ComputerCraft computer, which the CC: Tweaked mod adds to a Fabric server. It runs the core in the computer's Lua 5.2 VM, ticked by a CC timer every server tick; the server and client sides both run on that computer.

The adapter's code and README: sdk/adapters/cctweaked.

Set up

Needs a Minecraft: Java Edition server you own or run, with Fabric and the CC: Tweaked mod (measured with Minecraft 1.20.1, Fabric loader 0.20.1, Fabric API 0.92.12 and CC: Tweaked 1.121.0). Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft. Not affiliated with the CC: Tweaked developers.

The platform's own rules. The Minecraft EULA lets you do what you want with mods you create "as long as you don't sell them for money / try to make money from them". SCRIPT//GO does not enforce a platform's rules: you answer to the platform's rights holder for what you run on your server.

No licence check. This adapter has none. It was built without one after the Minecraft Usage Guidelines, which allow a mod only if it "cannot be used to directly or indirectly verify whether a player owns or has access to out-of-game content, products, or services that affect in-game features and functions". A package runs here without a licence check.

1. Build the computer's files, with your resources:

   shCopy

   node sdk/adapters/cctweaked/build.mjs --with path/to/my_resource --startup

   This writes dist/cctweaked/computer/: the SCRIPT//GO core, the adapter, the sg program and your resources. Optional: scriptgo/config.json there sets permissions, config and convars:

   jsonCopy

   { "permissions": { "1": ["*"] }, "resources": { "my_resource": { "greeting": "hi" } } }

2. Place a computer in the world, note its id (id in its shell), stop the server and copy the folder's contents into <world>/computercraft/computer/<id>/. The default disk of a computer is 1 MB (computer_space_limit in <world>/serverconfig/computercraft-server.toml).

3. Start the server and use the computer: with --startup it runs SCRIPT//GO at boot; otherwise type scriptgo/sg. At the sg> prompt, resource commands run as the person at the terminal (player 1); status, log, restart <name> and exit drive the host.

Running a Minecraft server, including the headless one scriptgo verify --env cctweaked starts, means accepting the Minecraft EULA: the operator must accept it themselves (eula=true in the server's eula.txt, or --accept-minecraft-eula on a verify run). SCRIPT//GO never accepts it for anyone.

HTTP, when a resource uses it, goes through CC: Tweaked's http API, so the server's computercraft-server.toml decides whether it is on and which hosts answer ([[http.rules]]; local and private addresses are denied by default).

Capabilities

What the adapter provides. See SDK and capabilities for what each one is.

Protection

No licence check in this adapter, so a package runs there without one. Releases are still signed.

See Protect your work for what protection does and does not do.

Assets

Maps, models, textures, sounds and other files players download. See Selling assets.

No game client downloads anything: assets are files of the resource.

Asset escrow: The host can read containers itself, but its operator holds the key: at-rest encryption only.

The platform's own rules

The Minecraft EULA lets you do what you want with your mods "as long as you don't sell them for money" (minecraft.net/en-us/eula).

This is the platform's rule, shown as information: whoever runs a script there answers for following it. It does not change what can be sold on SCRIPT//GO. See the rules.

Limits

• Experimental: one real server run so far, the conformance probe (35 of 35 checks). The official kits fail there only because they do not declare cctweaked yet. Each run needs the operator's own acceptance of the Minecraft EULA.
• No licence check in this adapter (see the licensing note). What the Minecraft EULA says about paid mods is the platform's own rule, shown as the platform note.
• Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft. Not affiliated with the CC: Tweaked developers.
• Lua 5.2 (Cobalt VM): no // or bitwise operators (use bit32), no collectgarbage.
• Everything runs on one computer: code that runs for about 7 seconds without yielding is stopped by CC: Tweaked ("Too long without yielding").
• Pinned for runs: Minecraft 1.20.1, Fabric loader 0.20.1, CC: Tweaked 1.121.0. Other versions are not measured.
• Fast tests use the cc-core harness (CC: Tweaked's own core and Lua VM without Minecraft); those runs are an emulator and do not count as verification.

Real runs

Each row is a scriptgo verify run on CC: Tweaked (Minecraft) itself, not on a mock or an emulator: the package started there and its own tests reported back. Rows marked probe are SCRIPT//GO's conformance probes, which exercise the runtime and are never published as packages. See how a status is earned.