d5f82fa458
When creating a peripheral or custom Lua object, one must implement two
methods:
- getMethodNames(): String[] - Returns the name of the methods
- callMethod(int, ...): Object[] - Invokes the method using an index in
the above array.
This has a couple of problems:
- It's somewhat unwieldy to use - you need to keep track of array
indices, which leads to ugly code.
- Functions which yield (for instance, those which run on the main
thread) are blocking. This means we need to spawn new threads for
each CC-side yield.
We replace this system with a few changes:
- @LuaFunction annotation: One may annotate a public instance method
with this annotation. This then exposes a peripheral/lua object
method.
Furthermore, this method can accept and return a variety of types,
which often makes functions cleaner (e.g. can return an int rather
than an Object[], and specify and int argument rather than
Object[]).
- MethodResult: Instead of returning an Object[] and having blocking
yields, functions return a MethodResult. This either contains an
immediate return, or an instruction to yield with some continuation
to resume with.
MethodResult is then interpreted by the Lua runtime (i.e. Cobalt),
rather than our weird bodgey hacks before. This means we no longer
spawn new threads when yielding within CC.
- Methods accept IArguments instead of a raw Object array. This has a
few benefits:
- Consistent argument handling - people no longer need to use
ArgumentHelper (as it doesn't exist!), or even be aware of its
existence - you're rather forced into using it.
- More efficient code in some cases. We provide a Cobalt-specific
implementation of IArguments, which avoids the boxing/unboxing when
handling numbers and binary strings.
|
||
|---|---|---|
| .github | ||
| config | ||
| doc | ||
| gradle/wrapper | ||
| src | ||
| tools | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| build.gradle | ||
| CONTRIBUTING.md | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| illuaminate.sexp | ||
| LICENSE | ||
| README.md | ||
| settings.gradle | ||
CC: Tweaked is a fork of ComputerCraft, adding programmable computers, turtles and more to Minecraft.
What?
ComputerCraft has always held a fond place in my heart: it's the mod which really got me into Minecraft, and it's the 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.
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.
Features
CC: Tweaked contains all the features of the latest version of ComputerCraft, as well as numerous fixes, performance improvements and several nifty additions. I'd recommend checking out the releases page to see the full set of changes, but here's a couple of the more interesting additions:
- Improvements to the
httplibrary, including websockets, support for other HTTP methods (PUT,DELETE, etc...) 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 installed).
- 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.
- Several profiling and administration tools for server owners, via the
/computercraftcommand. This allows operators to track which computers are hogging resources, turn on and shutdown multiple computers at once and interact with computers remotely. - Closer emulation of standard Lua, adding the
debugandiolibraries. 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.
Relation to CCTweaks?
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.
Contributing
Any contribution is welcome, be that using the mod, reporting bugs or contributing code. If you want to get started developing the mod, check out the instructions here.
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 and Discord guild! There's also a fairly populated, albeit quiet IRC channel, 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!
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 instead.
dependencies {
maven { url 'https://squiddev.cc/maven/' }
}
dependencies {
implementation fg.deobf("org.squiddev:cc-tweaked-${mc_version}:${cct_version}")
}
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.