pycraft - GitLite

KO | EN

gitlite — search

#python #golang #machine-learning #rust #linux #nodejs #macos #java #cli #kubernetes #vue #awesome-list #security #mcp

pycraft

(★ 207)

A Minecraft-inspired game for the terminal

File Explorer

Download Latest Version (.zip)

.gitignore
.replit
colours.c
colours.py
console.py
convert.py
data.c
data.py
events.py
items.py
LICENSE
main.py
mobs.py
nbinput.py
network.py
pathfinding.py
player.py
README.md
render.h
render.py
render_c_module.c
render_interface.py
saves.py
server.py
server_interface.py
setup.py
terrain.py
tester.py
translate_data.py
ui.py

# Installation Guide

1. Get the code

git clone https://github.com/itsapi/pycraft

Downloads the entire project code from GitHub to your computer.

cd pycraft

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install .

Installs the package published on PyPI directly — no need to clone the source.

python main.py

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Run on Repl.it](https://repl.it/badge/github/itsapi/pycraft)](https://repl.it/github/itsapi/pycraft)

# Pycraft

A command line based 2D Minecraft, runs best on *nix with Python 3.3+. Built by [geraintwhite](https://github.com/geraintwhite) and [olls](https://github.com/olls).

Usage: `python3 main.py`

![Pycraft gameplay image](https://cdn.dvbris.com/pycraft-2.gif)

## Controls

For the best control, set keyboard repeat time to around 200-300ms.

```
Menus:
   Move up                    - W or UP
   Move down                  - S or DOWN
   Select                     - SPACE or RETURN
   Pause                      - SPACE or RETURN
Blocks:
   Break/place block          - K
   Move cursor clockwise      - L
   Move cursor anti-clockwise - J
Inventory:
   Cycle inventory down       - O
   Cycle inventory up         - U
   Toggle crafting menu       - C
   Craft selected item        - I
Movement:
   Move left                  - A
   Move right                 - D
   Jump                       - W
```

## Crafting

A number of items are only obtainable through the crafting system.
Items that can be crafted with the materials in the player inventory will automatically show up in the crafting grid.
Press <kbd>C</kbd> to toggle selection between inventory and crafting grid. Press <kbd>I</kbd> to craft the currently selected item.

#### Recipes:

- 6 sticks:
   - 1 wood
- 4 torches:
   - 1 stick
   - 1 coal
- ladder:
   - 3 sticks
- wooden pickaxe:
   - 2 sticks
   - 3 wood
- stone pickaxe:
   - 2 sticks
   - 3 stone
- iron pickaxe:
   - 2 sticks
   - 3 iron
- diamond pickaxe:
   - 2 sticks
   - 3 diamonds

####  Tools:

Certain blocks require the right tool before being able to mine it.
The tool has to be selected in inventory to be able to use it.
Each tier of pickaxe can break more blocks than the previous tier.

- fist (i.e. don't need a tool):
   - grass
   - tall grass
   - wood
   - leaves
   - torch
   - ladder
- wooden pickaxe:
   - stone
- stone pickaxe:
   - coal
   - iron
- iron pickaxe:
   - redstone
   - gold
   - diamond
- diamond pickaxe:
   - emerald

## Using the C Renderer

The C renderer is likely to be faster than the Python renderer. To use the C renderer, it must be compiled first. To complile, run the command: `python3 setup.py build` in the root of the repository. Then run the game as normal and go into settings to switch the renderers.

Please report any bugs in the C renderer, or differences between the Python renderer and the C renderer in issues.

## Contributing

We welcome pull requests or issues for bug reports/fixes or new feature ideas! Help us make the game more fun :D