https://github.com/natuworkguy/wilco

A modular Pygame-based 3D game featuring animated assets, custom fonts, and a unique .wlco world format.
https://github.com/natuworkguy/wilco

Last synced: 12 months ago
JSON representation

A modular Pygame-based 3D game featuring animated assets, custom fonts, and a unique .wlco world format.

• Host: GitHub
• URL: https://github.com/natuworkguy/wilco
• Owner: Natuworkguy
• License: agpl-3.0
• Created: 2025-06-04T00:16:51.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-17T17:57:40.000Z (about 1 year ago)
• Last Synced: 2025-06-17T18:46:24.249Z (about 1 year ago)
• Language: Python
• Size: 5.94 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
[![`WILCO Banner`](assets/images/front-dog.png)](https://github.com/Natuworkguy/Wilco/)

# **WILCO**

**WILCO** is a pixel-perfect Pygame adventure featuring animated animals, retro-inspired visuals, and a fully custom world system. Whether you're a dev or a player, WILCO invites you into a world of charm, action, and creativity. Built with ❤️ in Python.

---

## 🎮 Features

- 🐶 Dynamic sprites for dogs & cats (idle, walk, jump, and more!)

- 🌍 Custom `.wlco` world file format

- 🖋️ Retro UI using hand-picked fonts like **Orbitron**, **ComicNeue**, and more

- 🔤 Built-in asset system with organized folders for fonts and images

---

## 🧠 Requirements

- [![`Python 3.9+`](http://img.shields.io/badge/Python%203.9+-blue)](https://www.python.org/)

- [`pygame`](https://www.pygame.org/)

Install dependencies:

```bash

pip install -r requirements.txt

````

---

## 🚀 Getting Started

Clone the repo and start the game:

```bash

git clone https://github.com/Natuworkguy/wilco.git

cd wilco/

python main.py

```

---

## 📁 Project Structure

```

Wilco/

├── main.py               # Main game script

├── assets/

│   ├── fonts/            # Orbitron, VT323, ComicNeue, etc.

│   └── images/           # dog.png, cat.png, jump-sprites, etc.

│   └── sounds/           # bgm.mp3, and future sounds.

```

---

## ❤️ Credits

Code by [**`Natuworkguy`**](https://github.com/Natuworkguy),

Idea by **Kath Hill**,

Music:

    - Background music by **Gloomy_Background755** - [`MakoVII`](https://github.com/OnionUI/Themes/tree/main/themes/MakoVII%20by%20Gloomy_Background755)

    - Credits music by **JXM** and **Polaris**

## 🪪 License

---

Licensed under the **GNU Affero General Public License v3.0**.

See the [`LICENSE`](./LICENSE) file for full details.