Amulet Core
A Python 3 library to read and write data from Minecraft's various save formats.
This library provides the main world editing functionality for Amulet Map Editor
If you are looking for the actual editor it can be found at Amulet Map Editor
Documentation
Our online documentation can be found here: https://amulet-core.readthedocs.io
Installing
- Install Python 3.7
- We recommend setting up a python virtual environment so you don't run into issues with dependency conflicts.
- run
pip install amulet-coreto install the library and all its dependencies.
Dependencies
This library uses a number of other libraries. These will be automatically installed when running the command above.
- Numpy
- Amulet_NBT
- PyMCTranslate
Contributing
For Development
Download the code to your computer, install python and run the following command from the root directory.
run pip install -e .[dev]
This command will install the library in development mode with the libraries required for development.
- Black (Required for formatting)
- Must be run before pushing a Pull Request
For information about contributing to this project, please see the contribution section below
Code Formatting
For code formatting, we use the formatting utility black.
To run it, run the following command from your favorite terminal after installing: black amulet tests
In order for your pull request to be accepted, this command must be run to format every file.
Building the Documentation
To build the documentation locally, run the following command: make html and then navigate to the
generated directory docs_build/html in your favorite web browser
Branch Naming
Branches should be created when a certain bug or feature may take multiple attempts to fix. Naming them should follow the following convention (even for forked repositories when a pull request is being made):
- For features, use:
impl-<feature name> - For bug fixes, use:
bug-<bug tracker ID> - For improvements/rewrites, use:
improv-<feature name> - For prototyping, use:
proto-<feature name>
Pull Requests
We ask that submitted Pull Requests give moderately detailed notes about the changes and explain any changes that were made to the program outside of those directly related to the feature/bug-fix. Make sure to run all tests and formatting otherwise we cannot accept your pull request.
Note: We will also re-run all tests before reviewing, this is to mitigate additional changes/commits needed to pass all tests.
Once a Pull Request is submitted, we will mark the request for review, once that is done, we will review the changes and provide any notes/things to change. Once all additional changes have been made, we will merge the request.
3 maintainers
Release files for amulet-core 1.9.47
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| amulet_core-1.9.47.tar.gz | 206.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| amulet_core-1.9.47-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 483.9 kB
Release files / amulet_core-1.9.47.tar.gz
| Download URL | amulet_core-1.9.47.tar.gz |
|---|---|
| Size | 206.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8a40efb857b9f8b7acf6674f4252eb94fca831cf870e576468d2410087ef4152
|
|
BLAKE2b-256 checksum How to use checksums |
94d8974b602175898ff6c2f9500230cb4cbb035fe6095e1b922b9dab315f6d3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Release files / amulet_core-1.9.47-py3-none-any.whl
| Download URL | amulet_core-1.9.47-py3-none-any.whl |
|---|---|
| Size | 277.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e07281a296b2c5be6a82b7df97357e2fb3bcca03171b58852433cc30d622c018
|
|
BLAKE2b-256 checksum How to use checksums |
4e428a0a10a4431dc75140c5467069376cb3988ed234c4ccf2abeb808b2e246b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
