blob: c9c87367ee9873837121390a5d2f7ce57bdce672 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
# WorldsPlayer Source Editor
This project enables anyone to fully decompile WorldsPlayer to Java source
files, edit them in any way, and recompile them back to a working WorldsPlayer
Java Archive.
## Usage
WorldsPlayer, and this project, require Java 6 to run. You can obtain a copy
of Java 6 for your platform from the [Oracle Java Archive](https://www.oracle.com/java/technologies/javase-java-archive-javase6-downloads.html).
This project additionally requires the
[Vineflower](https://vineflower.org/usage/) Java decompiler. Make sure that
`vineflower` is accessible from your `PATH` environment variable.
### Decompiling WorldsPlayer
To decompile WorldsPlayer, you will need to run the `decompile` Make task. This
task will decompile the full source tree of the WorldsPlayer Java Archive to the
[`source`](./source) directory.
You'll additionally need to provide the location of the WorldsPlayer Java
Archive as the `WORLDSPLAYER_JAR` environment variable.
```bash
WORLDSPLAYER_JAR=/path/to/worlds.jar make decompile
```
### Editing WorldsPlayer
You can edit the decompiled source files in any way you like.
### Recompiling WorldsPlayer
To recompile WorldsPlayer, you will need to run the `compile` Make task. This
task will recompile the full source tree of the WorldsPlayer Java Archive to the
[`out`](./out) directory.
You'll additionally need to provide the location of the Java 6 compiler as the
`JAVAC` environment variable.
```bash
JAVAC=/path/to/javac make compile
```
The recompiled WorldsPlayer Java Archive will be located at
[`out/worlds.jar`](./out/worlds.jar) and requires no additional configuration
to run in the WorldsPlayer client.
### Step-by-Step
```shell
# Decompile WorldsPlayer
WORLDSPLAYER_JAR=/path/to/worlds.jar make decompile
# Edit the source files in the source directory
find source -type f -name "*.java" -exec sed -i.bak 's/this\.setName(longID);/this.setName(longID + " (" + longID + ")");/' {} \;
# Recompile WorldsPlayer
JAVAC=/path/to/javac make compile
# Copy worlds.jar to your WorldsPlayer client
WORLDSPLAYER_JAR=/path/to/worlds.jar make install
```
Now that we've changed the username format from `username` to `username (username)`, we can run WorldsPlayer to verify that the change has been applied.
## Optional Patches
This project includes a number of optional patches that can be applied to
WorldsPlayer. These patches are located in the
[`patches/optional`](./patches/optional) directory.
- [Free VIP](./patches/optional/free_vip.patch): Enables level two VIP for free
at all times
- [Bypass `assertFail` `exit`](./patches/optional/bypass_assert_fail_exit.patch):
WorldsPlayer crashes when it encounters a failed assertion. This patch
continues to show any failed assertion popups, but attempts to continue
running the client, **if possible**.
## Licence
This project is licensed with the [GNU General Public License v3.0](./LICENSE).
|