2017-11-15 18:20:22 +00:00
|
|
|
# ![CC: Tweaked](logo.png)
|
2017-11-14 22:40:33 +00:00
|
|
|
[![Build Status](https://travis-ci.org/SquidDev-CC/CC-Tweaked.svg?branch=master)](https://travis-ci.org/SquidDev-CC/CC-Tweaked)
|
2014-08-05 19:58:14 +00:00
|
|
|
|
2019-02-19 14:49:13 +00:00
|
|
|
CC: Tweaked is a fork of [ComputerCraft](https://github.com/dan200/ComputerCraft), adding programmable computers,
|
|
|
|
turtles and more to Minecraft.
|
2017-05-01 13:32:39 +00:00
|
|
|
|
2017-11-14 22:40:33 +00:00
|
|
|
## What?
|
2019-02-19 14:49:13 +00:00
|
|
|
ComputerCraft has always held a fond place in my heart: it's the mod which really got me into Minecraft, and it's the
|
2019-03-04 22:52:39 +00:00
|
|
|
mod which has kept me playing it for many years. However, development of the original mod has slowed, as the original
|
|
|
|
developers have had less time to work on the mod, and moved onto other projects and commitments.
|
2017-05-01 13:32:39 +00:00
|
|
|
|
2019-02-19 14:49:13 +00:00
|
|
|
CC:Tweaked (or CC:T for short) is an attempt to continue ComputerCraft's legacy. It's not intended to be a competitor
|
|
|
|
to CC, nor do I want to take it in a vastly different direction to the original mod. Instead, CC:T focuses on making the
|
|
|
|
ComputerCraft experience as _solid_ as possible, ironing out any wrinkles that may have developed over time.
|
2017-05-01 13:32:39 +00:00
|
|
|
|
2018-05-15 11:25:04 +00:00
|
|
|
## Features
|
2019-03-04 22:52:39 +00:00
|
|
|
CC: Tweaked contains all the features of the latest version of ComputerCraft, as well as numerous fixes, performance
|
2019-02-19 14:49:13 +00:00
|
|
|
improvements and several nifty additions. I'd recommend checking out [the releases page](https://github.com/SquidDev-CC/CC-Tweaked/releases)
|
|
|
|
to see the full set of changes, but here's a couple of the more interesting additions:
|
|
|
|
|
2019-03-04 22:52:39 +00:00
|
|
|
- Improvements to the `http` library, including websockets, support for other HTTP methods (`PUT`, `DELETE`, etc...)
|
2019-02-19 14:49:13 +00:00
|
|
|
and configurable limits on HTTP usage.
|
|
|
|
- Full-block wired modems, allowing one to wrap non-solid peripherals (such as turtles, or chests if Plethora is
|
2019-03-04 22:52:39 +00:00
|
|
|
installed).
|
2019-02-19 14:49:13 +00:00
|
|
|
- Pocket computers can be held like maps, allowing you to view the screen without entering a GUI.
|
|
|
|
- Printed pages and books can be placed in item frames and held like maps.
|
2019-03-04 22:52:39 +00:00
|
|
|
- Several profiling and administration tools for server owners, via the `/computercraft` command. This allows operators
|
2019-02-19 14:49:13 +00:00
|
|
|
to track which computers are hogging resources, turn on and shutdown multiple computers at once and interact with
|
2018-05-15 11:25:04 +00:00
|
|
|
computers remotely.
|
2019-02-19 14:49:13 +00:00
|
|
|
- Closer emulation of standard Lua, adding the `debug` and `io` libraries. This also enables seeking within binary
|
|
|
|
files, meaning you don't need to read large files into memory.
|
|
|
|
- Allow running multiple computers on multiple threads, reducing latency on worlds with many computers.
|
2018-05-15 11:25:04 +00:00
|
|
|
|
2017-11-14 22:40:33 +00:00
|
|
|
## Relation to CCTweaks?
|
2018-05-15 11:25:04 +00:00
|
|
|
This mod has nothing to do with CCTweaks, though there is no denying the name is a throwback to it. That being said,
|
|
|
|
several features have been included, such as full block modems, the Cobalt runtime and map-like rendering for pocket
|
|
|
|
computers.
|
2017-05-01 13:32:39 +00:00
|
|
|
|
2017-11-14 22:40:33 +00:00
|
|
|
## Contributing
|
2019-02-19 14:49:13 +00:00
|
|
|
Any contribution is welcome, be that using the mod, reporting bugs or contributing code. In order to start helping
|
|
|
|
develop CC:T, you'll need to follow these steps:
|
2017-05-01 13:32:39 +00:00
|
|
|
|
2017-11-14 22:40:33 +00:00
|
|
|
- **Clone the repository:** `git clone https://github.com/SquidDev-CC/CC-Tweaked.git && cd CC-Tweaked`
|
|
|
|
- **Setup Forge:** `./gradlew setupDecompWorkspace`
|
|
|
|
- **Test your changes:** `./gradlew runClient` (or run the `GradleStart` class from your IDE).
|
2018-05-15 11:25:04 +00:00
|
|
|
|
|
|
|
If you want to run CC:T in a normal Minecraft instance, run `./gradlew build` and copy the `.jar` from `build/libs`.
|
2019-03-04 22:52:39 +00:00
|
|
|
|
2019-05-30 07:33:55 +00:00
|
|
|
## Community
|
|
|
|
If you need help getting started with CC: Tweaked, want to show off your latest project, or just want to chat about
|
|
|
|
ComputerCraft we have a [forum](https://forums.computercraft.cc/) and [Discord guild](https://discord.gg/H2UyJXe)!
|
|
|
|
There's also a fairly populated, albeit quiet [IRC channel](http://webchat.esper.net/?channels=#computercraft), if
|
|
|
|
that's more your cup of tea.
|
|
|
|
|
|
|
|
I'd generally recommend you don't contact me directly (email, DM, etc...) unless absolutely necessary (i.e. in order to
|
|
|
|
report exploits). You'll get a far quicker response if you ask the whole community!
|
|
|
|
|
2019-03-04 22:52:39 +00:00
|
|
|
## Using
|
|
|
|
If you want to depend on CC:Tweaked, we have a maven repo. However, you should be wary that some functionality is only
|
|
|
|
exposed by CC:T's API and not vanilla ComputerCraft. If you wish to support all variations of ComputerCraft, I recommend
|
|
|
|
using [cc.crzd.me's maven](https://cc.crzd.me/maven/) instead.
|
|
|
|
|
|
|
|
```groovy
|
|
|
|
dependencies {
|
|
|
|
maven { url 'https://squiddev.cc/maven/' }
|
|
|
|
}
|
|
|
|
|
|
|
|
dependencies {
|
2019-04-02 20:37:19 +00:00
|
|
|
implementation "org.squiddev:cc-tweaked-${mc_version}:${cct_version}"
|
2019-03-04 22:52:39 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
You should also be careful to only use classes within the `dan200.computercraft.api` package. Non-API classes are
|
|
|
|
subject to change at any point. If you depend on functionality outside the API, file an issue, and we can look into
|
|
|
|
exposing more features.
|