Metadata-Version: 2.4
Name: miney
Version: 0.5.8
Summary: The python interface to Luanti
Home-page: https://github.com/miney-py/miney
Author: Robert Lieback
Author-email: robertlieback@zetabyte.de
Project-URL: Documentation, https://miney.readthedocs.io
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

<p align="center">
<img src="https://github.com/miney-py/miney/raw/master/docs/miney-logo.png">
</p>

# Miney - The python interface to Luanti

Miney is the Python API to Luanti/Minetest.

Miney connects locally, over network or internet with the Luanti protocol and provides a pythonic interface to the server, players, blocks and more.

* `PyPI <https://pypi.org/project/miney/>`_

* `Luanti ContentDB <https://content.luanti.org/packages/Miney/miney/>`_

## Documentation

https://miney.readthedocs.io/en/latest/

## Status

https://miney.readthedocs.io/en/latest/changelog.html

**With version 0.5 we removed mineysocket and talking now directly to the server over the Luanti protocol.**

Miney is still in beta, so expect breaking changes.

## Requirement

* Python 3.6+ (tested on 3.12)
* Installed "miney" mod in the server.

# Development

Clone the repo:
```
git clone https://github.com/miney-py/miney.git
```

# TODO

A list of things i'm planning to do. There will be no fixed timeline. 

Feel free to contribute!

* [ ] Github-Actions
  * [ ] run tests
  * [ ] Tests for pull requests
  * [ ] Build and push to pypi for tagged commits
  * [ ] Build and push to Luanti ContentDB for tagged commits
* [ ] Callbacks
  * [x] Basic API and some callbacks implemented
  * [ ] Implement more "register_on_..." functions
* [ ] Mesecons: Add a python script processor that executes python code. 
* Documentation:
    * [ ] Better first steps guide
    * [ ] Python learning lessons that build on each other
    * [ ] Education material for beginners, teachers and students
    * [ ] Multilanguage
* Native client
    * [ ] Get chunks, blocks and positions of surrounding entities like a normal client
        * Could be interesting for machine learning and bots to make them aware of their surroundings
    * [ ] Normal player movement without using lua
    * [ ] Player interactions like punching and interacting with blocks and entities
* [ ] Asyncio
* Python driven mobs? 
