Skip to content

Commit 7978fa8

Browse files
authored
Initial readme commit
1 parent 71cf97b commit 7978fa8

1 file changed

Lines changed: 67 additions & 1 deletion

File tree

README.md

Lines changed: 67 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,67 @@
1-
# UnityTimeRewinder
1+
</p>
2+
<p align="center">
3+
<img src="https://user-images.githubusercontent.com/68167377/196243323-3509d486-b9dd-4575-9753-134ab1b39de2.png"/>
4+
</p>
5+
6+
# Time Rewinder for Unity
7+
8+
Rewind time in Unity with ease! While there are certain frameworks that let you rewind time in Unity, they are usually quite restrictive and hard to modify. I faced these problems myself when i needed to add time rewind mechanics in my game and none of the solutions that i have found were good enough. That is why i decided to start this open source project that i hope you find usefull.
9+
10+
**Customizability is one of the main points of this project, so it can be used in any of your custom Unity projects and you can track and rewind anything you want!**
11+
12+
The steps how to setup this custom tracking are explained in documentation. Time Rewinder should be also compatible with any Unity version (except maybe prehistoric Unity first releases)
13+
14+
Straight from the box you can start rewinding **positions, rotations, velocities, animators, audios and particle systems**.
15+
16+
## How to install
17+
18+
You have two options how to install it into your project.
19+
20+
- First option is to download prepared Unity package in Github release section. After download, open your Unity project and simply open the downloaded package, import dialogue window should appear (Unity should automatically associate the package with itself). If it didnt work out for you, you can also import it thru Unity package manager.
21+
- Second option is to download this sample project from Github and start using it, or just import the TimeRewinder folder under Assets/TimeRewinder into your project
22+
23+
## Features
24+
25+
TimeRewinder supports two types of rewinds.
26+
27+
- Instant rewinds where you rewind time by specified amount of seconds
28+
- Rewinds with previews
29+
30+
The latter of the two is definitely more interesting option, cause you can freely choose which snapshot you can return to after you spectate these previews for yourself. This is especially helpfull if you want to give more control to player with rewinding time. As shown in demo-scene examples, player can choose on the time axis the exact moment he wants to return to, while the time is stopped (technically time is not stopped, but for the objects that are rewinded, it appears like it). The showcase of this mechanic is shown right below. I think, this is also unique feature of this project, because i havent found a similar functionality in other Time Rewind frameworks.
31+
32+
![ezgif com-gif-maker (9)](https://user-images.githubusercontent.com/68167377/196203578-a476d5b1-5314-49bd-933d-904eba1dd51a.gif)
33+
34+
The classic functionality to rewind time by holding button, which you probably already know from other solutions is also here. These two types of rewinds inputs are prepared straight from the box, but it would be very easy to design completely new rewind input system. You would only have to call corresponding methods, that are all prepared and documented for you.
35+
36+
![ezgif com-gif-maker (10)](https://user-images.githubusercontent.com/68167377/196241351-b1c05483-79e1-4554-8fc2-d4f6efc69b14.gif)
37+
38+
39+
## How to use
40+
41+
Detailed steps how to use TimeRewinder are described in [documentation](https://github.com/SitronX/UnityTimeRewinder/blob/main/Assets/TimeRewinder/Documentation/Unity%20Time%20Rewinder.pdf) and all important parts of code are also documented.
42+
43+
If you still face any problem, dont hesitate to contact me, I will gladly help you out.
44+
45+
## Showcase of rewinding
46+
47+
48+
In demo-scenes there are few examples of time rewinding, as well as two examples of tracking and rewinding custom variables. I recommend you look into it , so you get the idea how everything is connected. Here comes few other videos showcasing rewinding time from demo scenes
49+
50+
51+
52+
https://user-images.githubusercontent.com/68167377/196215651-c3002e8b-a722-4bb6-b655-81946cfeff18.mp4
53+
54+
https://user-images.githubusercontent.com/68167377/196215735-e3e612a4-aa69-40e2-8e4f-3fd68669b667.mp4
55+
56+
https://user-images.githubusercontent.com/68167377/196240813-ba4c6b79-ebec-461e-9bbe-335cc75a7af7.mp4
57+
58+
59+
60+
And here is example and maybe motivation how it could look in actual game, where you customize it for your needs :)
61+
62+
63+
64+
https://user-images.githubusercontent.com/68167377/196215814-45e4667b-748a-4eff-a2ce-8c62b9d90f29.mp4
65+
66+
67+

0 commit comments

Comments
 (0)