1
0
mirror of https://github.com/SquidDev-CC/CC-Tweaked synced 2024-12-14 04:00:30 +00:00
CC-Tweaked/CONTRIBUTING.md
SquidDev cb8135a0d1 Bump Cobalt version
- Remove stub for table.pack/table.unpack.
 - Remove Lua 5.3 bitlib stub. We're not on 5.3, there's no
   point emulating it.
 - Change peripheral.call to correctly adjust the error level. This is a
   terrible hack, but I believe the only good option.

It'd be good to remove load as well, but it's a little more complex due
to our injecting of _ENV.

Closes #363
2020-04-16 10:48:26 +01:00

2.0 KiB

Contributing to CC: Tweaked

As with many open source projects, CC: Tweaked thrives on contributions from other people! This document (hopefully) provides an introduction as to how to get started in helping out.

If you've any other questions, just ask the community or open an issue.

Reporting issues

If you have a bug, suggestion, or other feedback, the best thing to do is file an issue. When doing so, do use the issue templates - they provide a useful hint on what information to provide.

Developing

In order to develop CC: Tweaked, you'll need to download the source code and then run it. This is a pretty simple process.

  • Clone the repository: git clone https://github.com/SquidDev-CC/CC-Tweaked.git && cd CC-Tweaked
  • Setup Forge: ./gradlew setupDecompWorkspace
  • Run Minecraft: ./gradlew runClient (or run the GradleStart class from your IDE).

If you want to run CC:T in a normal Minecraft instance, run ./gradlew build and copy the .jar from build/libs. These commands may take a few minutes to run the first time, as the environment is set up, but should be much faster afterwards.

Code linters

CC: Tweaked uses a couple of "linters" on its source code, to enforce a consistent style across the project. While these are run whenever you submit a PR, it's often useful to run this before committing.

  • Checkstyle: Checks Java code to ensure it is consistently formatted. This can be run with ./gradlew build or ./gradle check.
  • illuaminate: Checks Lua code for semantic and styleistic issues. See the usage section for how to download and run it.