You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+21-13Lines changed: 21 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,16 @@
1
1
## Minecraft: Python Edition
2
2
3
-

3
+

4
4
5
5
_**Minecraft: Python Edition**_ is a project that strives to recreate each and every old Minecraft version in Python 3 using the **Pyglet** multimedia library and **Cython** for performance.
6
6
7
-
This project is currently recreating the **Late Classic** versions of Minecraft. The latest version is **Classic 0.29_02** as released on _**October 30, 2009**_.
7
+
This project has finished recreating the **Classic** versions of Minecraft. The latest version is **Classic 0.30** as released on _**November 10, 2009**_.
8
8
9
-
Learn more about this version [here](https://minecraft.fandom.com/wiki/Java_Edition_Classic_0.29_02).
9
+
This version comes with both survival and creative modes: to enable survival mode, just run with the argument `-survival`.
10
10
11
-
Or the server version [here](https://minecraft.fandom.com/wiki/Java_Edition_Classic_server_1.8.3).
11
+
Learn more about this version [here](https://minecraft.wiki/w/Java_Edition_Classic_0.30).
12
+
13
+
Or the server version [here](https://minecraft.wiki/w/Java_Edition_Classic_server_1.10.1).
12
14
13
15
This project is organized so that every commit is strictly the finished Python version of the Java game of the same version number.
14
16
This means that you can go back into this repository's commit history and see only the source code changes between versions of Minecraft,
@@ -18,34 +20,40 @@ you can play it just by specifying the Minecraft version you want to play in the
18
20
### General Usage
19
21
20
22
*Pyglet*, *Cython*, *Pillow*, and *PyOgg* are required dependencies and can easily be installed with *pip*. Use the versions specified in `requirements.txt`.
23
+
*wxPython* is an optional dependency for the level file picker, but if you don't have it then *Tkinter* is used instead.
21
24
22
25
For audio to work you will either need *PyOgg* which is recommended, or FFmpeg which is installed on the system.
23
26
GStreamer is also supported on Linux through the *gst-python* library. PyOgg requires that your system have one of the *Opus*, *FLAC*, or *Vorbis* codecs. OpenAL is required.
24
27
25
-
To easily install this version of *Minecraft: Python Edition*, just run `python -m pip install minecraft-python==0.29`.
28
+
To easily install this version of *Minecraft: Python Edition*, just run `python -m pip install minecraft-python==0.30`.
26
29
27
30
Alternatively, for a manual Cython build, run `python setup.py build_ext --inplace`.
28
31
29
32
Run `python -m mc.net.minecraft.Minecraft` to launch the game. *Minecraft: Python Edition* should be compatible with any modern platform that supports OpenGL and Cython.
30
33
31
34
Run with the argument `-fullscreen` to open the window in fullscreen mode.
32
35
33
-
It is possible to enable a limited survival mode by editing `self.gamemode` in `Minecraft.py`.
36
+
### Creative Gameplay
37
+
38
+
In creative mode, no mobs exist. All Classic ores and tiles are made available by pressing B to pick blocks.
39
+
40
+
You can press F5 to toggle rain. Other keys are listed in the regular options menu.
41
+
42
+
### Survival Gameplay
34
43
35
-
### Gameplay
44
+

36
45
37
-
This is a creative version of Classic, so no mobs exist. All ores and tiles are featured in this version.
46
+
The survival version features early mobs (pigs, creepers, skeletons, zombies, spiders) and basic combat. Press Tab to launch arrows at enemies.
38
47
39
-
If you enable survival mode, there will be limited functionality.
40
-
Only sheep will spawn, which you can get wool from. Apart from that, no items drop.
48
+
There are pigs that drop brown mushrooms. Sheep also exist. Creepers explode only upon death.
41
49
42
-
Press B to pick blocks. Press F5 to toggle rain. Other keys are listed in the regular options menu.
50
+
To heal, pick up mushrooms and right click to eat. Red mushrooms are poisonous and will take away health.
43
51
44
52
### Multiplayer
45
53
46
-
To launch the multiplayer game, run `python -m mc.net.minecraft.Minecraft -server <host:port> -user <username> -mppass [password]`.
54
+
To launch the multiplayer game while in creative mode, run `python -m mc.net.minecraft.Minecraft -server <host:port> -user <username> -mppass [password]`.
47
55
48
-
This client is compatible with any 0.30 server that doesn't use an extended network protocol.
56
+
This client is compatible with any Classic server that doesn't use an extended protocol.
0 commit comments