Help
Introducing ComputerCraft!
ComputerCraft is a Minecraft mod (with full survival and creative multiplayer support) which adds in-game computers. Each computers comes with its own operating system featuring a host of builtin programs, and can be programmed to do anything you want with the easy-to-use Lua programming language. Each computer has a screen and keyboard, a comprehensive help system, a fully featured file system, two awesome games (including a text adventure based on Minecraft, and a fast paced arcade action game) and the ability to send and receive redstone signals in all six directions (including RedPower bundled cables, allowing for a full 96 bits of I/O).
New in version 1.2, you can now build Disk Drives for your computers, and carry your files around the world on Floppy Disks (or send them down Buildcraft Pipes or RedPower Tubes for the ultimate in automation). To liven up your home, Disk Drives can also act as programmable record players.
Since the release of 1.0, many prominent mod reviewers have recorded spotlight videos of ComputerCraft, and many talented players have recorded videos of their amazing creations. Instead of cluttering up this thread with videos, here's some links to the best YouTube content so far:
[Mod Spotlights, Reviews and Tutorials]
[Best of ComputerCraft]
DOWNLOAD
For Players:
1.21 Client (for Minecraft 1.1) [Adfly] [MediaFire]
1.2 Client (for Minecraft 1.0.0) [AdFly] [Mediafire]
For Server Operators:
1.21 Server (for Minecraft 1.1) [AdFly] [Mediafire]
1.2 Server (for Minecraft 1.0.0) [AdFly] [Mediafire]
INSTALLATION
For Players:
- Install [Risugami's ModLoader] 1.1.
- Install [Flan's ModLoaderMP Unofficial] Client 1.1 v2
- Download ComputerCraft Client 1.21 from one of the links above, you will get a zip file called ComputerCraft1.21.zip
- Extract the contents of the zip somewhere on your computer, if you do this properly, there will now be a folder called ComputerCraft.
- Copy this new folder (not the zip) into the "mods" folder in your minecraft directory.
- If you've done all this right, you should now be able to run the game, and start crafting and placing computers.
- If you get error message about bios.lua when attempting to the use a computer, you've done something wrong, re-read the instructions and try again.
For Server Operators:
- Install [Flan's ModLoaderMP Unofficial] Server 1.1 v2
- Download ComputerCraft Server 1.21 from one of the links above, you will get a zip file called ComputerCraftServer1.21.zip
- Follow steps 4-7 from the Player instructions above.
GETTING STARTED
First off, build a Computer:
Then, right click on the screen to interact. You're now in the command prompt. Type "help" to get started, then type "programs" to see the list of programs you can run, and try running some of them. Type "help" followed by the name of a program to find out what it does. When you're ready to start creating your own programs, type "help programming", then use "edit" to create programs or "lua" to just start entering code. All the programs and APIs you can call have their own help pages.
Want more? Build a Disk Drive next to your computer, and craft some Floppy Disks:
Put the disk in the drive, go into your computer again, type "list", and you'll see that each Floppy Disk has it's own folder. Now you can use the "copy" or "move" commands to move your programs onto disks, and carry the disk to another disk drive to transfer them between machines! You can also play records with the built in "dj" application.
If you make anything cool, remember to share your creations with the world. I've been blown away by the things people have made so far
VERSION HISTORY
For the full list programs and API changes, type "help whatsnew" in the game.
1.21
- Ported to Minecraft 1.1
- Added a new shortcut key Ctrl+S to shutdown the computer (hold down for 1 second).
- Fixed a couple of semi-serious bugs and a couple more not-so-serious ones.
- Added a help API so add-on pack developers can add extra help pages.
1.2
- Added Disk Drives (Block ID 208) and Floppy Disks (Item ID 4000). Transfer files between computers!
- Added shortcut keys to terminate the current program, and reboot the computer. Hold Ctrl+T and Ctrl+R respectively.
- Added a new system for user created APIs. Added new "bit" and "colour" apis to make bundled cable programming easier.
- Added rednet, a new API for using RedPower cables to send text between computers. Create the internet! This will be heavilly expanded in future versions.
- Added shell.setPath() and shell.setAlias(), and a new rom startup script, to allow the creation of program addon packs.
- Added os.clock(), os.time() and os.setAlarm(), to write programs that respond to the time of day.
- New built in game: Worm!
- New Programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
- New APIs: bit, colours, disk, help, rednet, parallel, textutils.
- Text entered into the shell can now be edited more easilly with the left and right arrow keys.
- Bug fixes and help system updates galore.
1.11
- Fixed a bug where Computers could not read input from RedPower cables which had a bend in the immediately adjacent square.
1.1
- Changed the default Block ID for the computer to 207.
- Added complete Multiplayer support throughout.
- Added connectivity with RedPower bundled cables if the RedPower mod is installed, allowing a full 96-bits of I/O per computer.
- Added a HTTP api, enabled via the mod config, to allow computers to access the real world internet.
- Fixed support for HD textures on the front of the computer.
- Added command history to the shell, press up and down to navigate previously entered commands.
- Added config options to change the size of the computer terminal, and the text colour.
- Programs which spin in an infinite loop without yielding will no longer freeze minecraft, and will instead terminate after 10 seconds.
- Extended the help, and fixed typos and small errors in various programs.
1.02
- Fixed the MCPatcher HD Textures incompatibility that was causing the computer texture to replace cobblestone blocks.
1.01
- Added a ModLoader configuration file, so the computers blockID can be changed.
- Made the error message that displays when the lua files aren't installed correctly much more clear, no more "Assertion failed."
1.0
- First release.
KNOWN ISSUES
- If you join an SMP server with different Block IDs in config/mod_ComputerCraft.cfg than the server, your game may crash. To rectify this, delete config/mod_ComputerCraft.cfg, or set computerBlockID and diskDriveBlockID to their default values.
LICENSE
I authorise and encourage people to create and distribute lua programs for ComputerCraft at their leisure. However, I do not permit the reddistribution or modification of the Java class files without permission. I give permission for ComputerCraft to be included in mod packs, provided I am notified, and the ComputerCraft files are included COMPLETELY UNMODIFIED, including all lua and text files.
It's a lovely language, used in loads of games, and I'd like to think i've made it as easy to use as possible in ComputerCraft. The source code to all the builtin programs is fully readable and modifyable, and there's an interactive lua prompt for experimenting in realtime.
