minecraft-textcraft 1.0.1
A Python package that converts text into blocky Minecraft-style ASCII art...
Requires Python: >=3.7

[![CI](https://github.com/swe-students-fall2025/3-python-package-brio/actions/workflows/ci.yml/badge.svg)](https://github.com/swe-students-fall2025/3-python-package-brio/actions/workflows/ci.yml)
[![CD](https://github.com/swe-students-fall2025/3-python-package-brio/actions/workflows/deploy.yml/badge.svg)](https://github.com/swe-students-fall2025/3-python-package-brio/actions/workflows/deploy.yml)
# minecraft-textcraft

minecraft-textcraft is a Python package that transforms text into blocky, Minecraft-style ASCII art. It supports special inline item commands like \sword, \shield, and \earth to embed themed icons directly within text.
The output can be colorized, animated, and is center-aligned to create fun, professional-looking console visual effects.

# Installation
```bash
pip install minecraft-textcraft
```

# Usage

minecraft-textcraft supports A-Z, numbers, item commands, adjustable colors and animations.

Rendered output can be:
- **Colors**: `RED`, `GREEN`, `BLUE`, `YELLOW`
- **Animated**: `type`, `scroll`, `wave`
- **FPS**: `10-30` (default: 12)
- Mixed with **both text + Minecraft items**

---

To view available commands:
```bash
minecraft-textcraft --help
```

## Example Usage
```bash
#Basic Text Rendering
minecraft-textcraft "Hello"

#Basic Art Rendering
minecraft-textcraft --get sword

#Text + Command
minecraft-textcraft "Hello \\earth"

#With Color
minecraft-textcraft "Hello" --color GREEN

#With Animation
minecraft-textcraft "Hello" --effect type
```

You can also combine them all or a few of them and mix and match!

```bash
#Text + Command + Animation + Color + Custom FPS
minecraft-textcraft 'GET \\sword NOW' --effect wave --color GREEN --fps 20
```

## Example Output
```bash
minecraft-textcraft 'Hello'
 ██        ██         ████████████         ██                   ██                      ███████    
 ██        ██         ██                   ██                   ██                    ██       ██  
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ████████████         ████████             ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                   ██         ██ 
 ██        ██         ██                   ██                   ██                    ██       ██  
 ██        ██         ████████████         ████████████         ████████████            ███████    
```