Skip to content

Commit de88a57

Browse files
authored
Updated README (#234)
- Added logo - Added CONTRIBUTING.md for setting up - Added gradle wrapper - Removed outdated Notepad++ language file - Moved credits further down - Make release workflow run only in main repo
2 parents dbd53a7 + fd448a8 commit de88a57

File tree

9 files changed

+404
-106
lines changed

9 files changed

+404
-106
lines changed

.github/workflows/release.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ on:
55
jobs:
66
build:
77
runs-on: ubuntu-latest
8+
if: github.repository == 'MinecraftTAS/TASmod'
89
steps:
910
- uses: actions/checkout@v4
1011
- name: Setup Java

.gitignore

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,6 @@ out
1616
# gradle
1717
build
1818
.gradle
19-
gradle
20-
gradlew
21-
gradlew.bat
2219

2320
# other
2421
eclipse

CONTRIBUTING.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Setting up
2+
## 1. Clone this repository into your workspace
3+
```sh
4+
git clone https://github.com/MinecraftTAS/TASmod.git
5+
```
6+
## 2. Import root project into your IDE
7+
### Eclipse
8+
1. Set your workspace folder to the parent folder of the TASmod folder, so if you have something like `workspace/TASmod`, set the workspace folder to "TASmod".
9+
2. Click `File>Import` then search for "Existing Gradle project" and click next
10+
3. Select the "TASmod" folder as a project root directory then click finish
11+
### IntelliJ
12+
Use `File>Open`, then select the `TASmod` folder
13+
## 3. Decompile Source
14+
Run the gradle task `genSources` either in your IDE or by running
15+
```sh
16+
./gradlew genSources
17+
```
18+
# Run Minecraft in Dev-Environment
19+
## Eclipse
20+
1. Run the gradle task `eclipse`
21+
2. Select the project, right click, then gradle>Refresh Gradle Project
22+
3. Select the TASmod_client.launch file then click the run button or press Ctrl+F11
23+
## IntelliJ
24+
Run the gradle task `runClient`
25+
26+
# Building
27+
1. Run the gradle task `build`
28+
```sh
29+
./gradlew build
30+
```
31+
2. The generated jar is in `build/libs`

README.md

Lines changed: 20 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,12 @@
1-
> [!WARNING]
2-
> This mod is in **early-development** and is not ready for use yet. If you wish to download the early testing releases, be prepared to encounter various bugs and desyncs!
3-
> For a more stable mod, without input recording and playback, check [LoTAS](https://github.com/MinecraftTAS/LoTAS)
4-
# TASmod
5-
A Tool-Assisted Speedrun-Mod for Minecraft 1.12.2.
6-
Is able to capture inputs and play them back, by pretending to be a keyboard.
1+
<p align="center"><img src="https://minecrafttas.com/images/TASmodLogo.svg" alt="Logo" width="500"></p>
72

8-
To reduce complexity, all aspects of RNG-Manipulation have been externalized to a repository called [KillTheRNG](https://github.com/MinecraftTAS/KillTheRNG). It is now available as an optional dependency and a [standalone mod](https://maven.mgnet.work/#/main/com/minecrafttas/killtherng-full)
3+
A [Tool-Assisted Speedrun](https://tasvideos.org/WelcomeToTASVideos) mod for Minecraft.
4+
Adds tools such as input playback, slowdown and savestates for creating TASes,
5+
which aim to beat the game as fast as possible.
96

10-
> [!IMPORTANT]
11-
> We are currently shifting over to **[Legacy-Fabric 1.12.2](https://legacyfabric.net/)**. The development branch currently works with Legacy-Fabric while the release branch is on **Forge** 1.12.2
12-
>
13-
> This means all **Alpha** releases only work for Forge.
14-
>
15-
> Future **Beta** releases will be on Legacy-Fabric.
16-
17-
# Credits
18-
Author of the original mod: [tr7zw](https://github.com/tr7zw/MC-TASmod)
19-
Main Mod Author: Scribble
20-
21-
Contributions by: famous1622, Pancake
22-
23-
Tickratechanger: [Guichaguri](https://github.com/Guichaguri/TickrateChanger)
24-
Tickrate 0 idea: [Cubitect](https://github.com/Cubitect/Cubitick)
25-
Savestate idea: [bspkrs, MightyPork](https://github.com/bspkrs-mods/WorldStateCheckpoints), although implementation is totally different now
26-
27-
Special thanks: Darkmoon, The Minecraft TAS Community
7+
# Installation
8+
This mod uses the modloader [LegacyFabric](https://legacyfabric.net/), a fork of [Fabric](https://fabricmc.net/) for versions below 1.14.4.
9+
**Does NOT need LegacyFabric-API**
2810
# Features
2911
## Playback
3012
This mod can record and play back
@@ -66,24 +48,23 @@ This mod can record and play back
6648
Record TASes with friends! Needs operator permissions to run tasmod related commands.
6749
/savestate can be used to manage savestates.
6850

69-
> **Note:** /fullrecord, /fullplay and /restartandplay are not guaranteed to work in multiplayer at this time.
51+
> [!Note]
52+
> /fullrecord, /fullplay and /restartandplay are not guaranteed to work in multiplayer at this time.
7053
7154
## HUD
7255
When ingame, hitting <kbd>F6</kbd> will show you options for customising your HUD, with monitoring options and more. Even more options are available when KillTheRNG is installed.
7356

74-
# Development
75-
## Setup
76-
1. Clone this repository and put it in your workspace directory (where you open eclipse or idea)
77-
2. Import gradle project
78-
- Use gradle version 4.10.3
79-
- Use [JDK 8](https://adoptium.net/en/temurin/releases/?version=8)
80-
3. Run gradle tasks `setupDecompWorkspace` then `eclipse`.
81-
4. *Optional but recommended:* Run gradle task `downloadKTRNG` (in the "tasmod" category) to download KillTheRNG to the run/mods folder.
57+
# Credits
58+
Author of the original prototype: [tr7zw](https://github.com/tr7zw/MC-TASmod)
59+
Main Mod Author: Scribble
8260

83-
## Running
84-
The task `eclipse` should've generated to launch configs: `TASmod_Client.launch` and `TASmod_Server.launch`. Select it, then click the run or debug button in your IDE.
61+
Contributions by: famous1622, Pancake
62+
63+
Initial Tickratechanger: [Guichaguri](https://github.com/Guichaguri/TickrateChanger)
64+
Tickrate 0 idea: [Cubitect](https://github.com/Cubitect/Cubitick)
65+
Savestate idea: [bspkrs, MightyPork](https://github.com/bspkrs-mods/WorldStateCheckpoints)
8566

86-
> **Note:** Additional setup is required for the server to actually start, like changing the eula.txt and setting `online-mode` to false in server.properties.
67+
Special thanks: Darkmoon, notz23, The Minecraft TAS Community
8768

88-
## Building
89-
Build the mod using the gradle task `build` (or alternatively `shadowJar`).
69+
# Development
70+
For setting up and building the mod, check [CONTRIBUTING.md](https://github.com/MinecraftTAS/TASmod/blob/develop/CONTRIBUTING.md)

TASFile_Dark_Npp_language.xml

Lines changed: 0 additions & 64 deletions
This file was deleted.

gradle/wrapper/gradle-wrapper.jar

42.6 KB
Binary file not shown.
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
distributionBase=GRADLE_USER_HOME
2+
distributionPath=wrapper/dists
3+
distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
4+
networkTimeout=10000
5+
validateDistributionUrl=true
6+
zipStoreBase=GRADLE_USER_HOME
7+
zipStorePath=wrapper/dists

0 commit comments

Comments
 (0)