Metadata-Version: 2.4
Name: mlang-py
Version: 1.0.1
Summary: MLang - Minecraft scripting language with WebSocket bridge
Author: Gosciu
License: MIT
Project-URL: Homepage, https://github.com/Gamer542-arch/MLang
Project-URL: Documentation, https://mlang-docs.vercel.app
Project-URL: Repository, https://github.com/Gamer542-arch/MLang
Project-URL: Issues, https://github.com/Gamer542-arch/MLang/issues
Keywords: minecraft,scripting,language,websocket,fabric,mod
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Interpreters
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: websockets>=12.0
Requires-Dist: colorama>=0.4.6

# MLang — Minecraft Scripting Language

Custom programming language for controlling Minecraft. Write `.GLang` scripts, run them with a Python interpreter connected via WebSocket to the MLang Fabric mod bridge.

## Install

```bash
pip install mlang
```

Or from source:
```bash
git clone https://github.com/Gamer542-arch/MLang
cd mlang/mlang
pip install -e .
```

## Quick Start

### 1. Run a script
```bash
python -m mlang script.glang
```

### 2. Interactive REPL
```bash
python -m mlang
```

### 3. Connect to Minecraft
```python
import asyncio
from mlang.bridge import BridgeClient

async def main():
    bridge = BridgeClient()
    await bridge.connect()
    await bridge.player_teleport(0, 64, 0)
    await bridge.chat_send("&aHello from Python!")
    await bridge.disconnect()

asyncio.run(main())
```

## Features

- **GLanguage** — C#-like scripting language with full interpreter (lexer, parser, AST, tree-walk)
- **MC Bridge** — WebSocket JSON-RPC client for the MLang Fabric mod
- **GUI System** — 17 widget types, 7 themes (dark, neon, glass, future...), animations
- **CLI + REPL** — Run scripts or interactive development

## Requirements

- Python 3.10+
- Minecraft 1.21.8 with Fabric Loader and MLang Bridge mod
