A python implementation from scratch of the popular infinite world game. (Work in progress)

main.py is the original code created by fogleman. It's a showcase of the power and simplicity of Python. Having only 2 files, main.py and texture.png, you should be all set to run a complete version of this Minecraft clone.

mine.py is intended to be a fully functional API. It was refactored to be more object-oriented and easier to maintain and expand. With this version you should be able to use a text-based rendered version of the world generated. Read more about that below on the Into the future section.

You can read details about the evolution of this code in the history/README.md file.

- version 0.1.0 - commented, Python3, PEP8'd, working fork of fogleman's (done!)
- version 0.1.1 - objected-oriented blocks definition (refactor)  (done!)
- version 0.1.2 - replace unittest with pytest
- version 0.1.5 - reorganize code into classes (Block, World, Player...)
- version 0.2.0 - text-based (ASCII) playable version
- version 0.3.0 - connection to a server
- version 0.4.0 - most basic blocks visible (wood, water, raw stone...)
- version 0.5.0 - first working mob (an ugly cow, maybe)
- version 1.0.0 - Working gui

git clone https://github.com/ocarneiro/mine.py.git
cd mine.py
pip install -r requirements.txt
python mine.py

• W: forward
• S: back
• A: strafe left
• D: strafe right
• Mouse: look around
• Space: jump
• Tab: toggle flying mode

• Selecting type of block to create:
  • 1: brick
  • 2: grass
  • 3: sand
• Mouse left-click: remove block
• Mouse right-click: create block

• ESC: release mouse, then close window

You can run this game using

python -i mine.py

And then explore some of the objects already created. You can see an ASCII representation of the generated world, for instance:

>>> txtmap.draw(world)

And if you want to see the same map using as references other heights (y=2, for instance), you can type:

>>> txtmap.draw(world, 2)
>>> # or #
>>> txtmap.draw(world, y=2)

It's been a lot of fun to play with text representations of the blocks, so you should see more commits in this direction in the near future.

This could grow into a client gui to access Minecraft-compatible servers.

This software would connect to servers such as cuberite to provide them an interactive screen that ressembles Minecraft. It would use a middleware like SpockBot and generate the corresponding images.

It could work in an architecture such as this:

Server (like cuberite) | | Middleware (like SpockBot) | | mine.py (this software)