|
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> |
7 | 2 |
|
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. |
9 | 6 |
|
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** |
28 | 10 | # Features |
29 | 11 | ## Playback |
30 | 12 | This mod can record and play back |
@@ -66,24 +48,23 @@ This mod can record and play back |
66 | 48 | Record TASes with friends! Needs operator permissions to run tasmod related commands. |
67 | 49 | /savestate can be used to manage savestates. |
68 | 50 |
|
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. |
70 | 53 |
|
71 | 54 | ## HUD |
72 | 55 | 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. |
73 | 56 |
|
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 |
82 | 60 |
|
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) |
85 | 66 |
|
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 |
87 | 68 |
|
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) |
0 commit comments