{"id":26235686,"url":"https://github.com/amulet-team/amulet-core","last_synced_at":"2026-02-16T16:14:58.370Z","repository":{"id":37035821,"uuid":"130729079","full_name":"Amulet-Team/Amulet-Core","owner":"Amulet-Team","description":"A Python library for reading and writing the Minecraft save formats. See Amulet for the actual editor.","archived":false,"fork":false,"pushed_at":"2025-03-27T13:29:05.000Z","size":101354,"stargazers_count":227,"open_issues_count":18,"forks_count":29,"subscribers_count":14,"default_branch":"2.0","last_synced_at":"2025-03-27T14:27:57.669Z","etag":null,"topics":["3rd-party","amulet","map-editor","minecraft","python","python3"],"latest_commit_sha":null,"homepage":"https://www.amuletmc.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Amulet-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-23T17:00:04.000Z","updated_at":"2025-03-19T10:12:54.000Z","dependencies_parsed_at":"2024-03-25T10:55:39.995Z","dependency_job_id":"44bb785b-c0f7-4707-b78f-e54086c75f77","html_url":"https://github.com/Amulet-Team/Amulet-Core","commit_stats":null,"previous_names":[],"tags_count":99,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Amulet-Team%2FAmulet-Core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Amulet-Team%2FAmulet-Core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Amulet-Team%2FAmulet-Core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Amulet-Team%2FAmulet-Core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Amulet-Team","download_url":"https://codeload.github.com/Amulet-Team/Amulet-Core/tar.gz/refs/heads/2.0","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247149501,"owners_count":20891954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3rd-party","amulet","map-editor","minecraft","python","python3"],"created_at":"2025-03-13T03:17:21.471Z","updated_at":"2026-02-16T16:14:53.350Z","avatar_url":"https://github.com/Amulet-Team.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amulet Core\n\n![Build](../../workflows/Build/badge.svg)\n![Unittests](../../workflows/Unittests/badge.svg?event=push)\n![Stylecheck](../../workflows/Stylecheck/badge.svg?event=push)\n[![Documentation](https://readthedocs.org/projects/amulet-core/badge)](https://amulet-core.readthedocs.io)\n\nA Python 3 library to read and write data from Minecraft's various save formats.\n\nThis library provides the main world editing functionality for Amulet Map Editor\n\n#### If you are looking for the actual editor it can be found at [Amulet Map Editor](https://github.com/Amulet-Team/Amulet-Map-Editor)\n\n\n## Documentation\n\nOur online documentation can be found here: https://amulet-core.readthedocs.io\n\n## Installing\n1) Install Python 3.7\n2) We recommend setting up a [python virtual environment](https://docs.python.org/3/tutorial/venv.html) so you don't run into issues with dependency conflicts.\n3) run `pip install amulet-core` to install the library and all its dependencies.\n\n## Dependencies\n\nThis library uses a number of other libraries. These will be automatically installed when running the command above.\n- Numpy\n- [Amulet_NBT](https://github.com/Amulet-Team/Amulet-NBT)\n- [PyMCTranslate](https://github.com/gentlegiantJGC/PyMCTranslate)\n\n## Contributing\n\n### For Development\nDownload the code to your computer, install python and run the following command from the root directory.\nrun `pip install -e .[dev]`\nThis command will install the library in development mode with the libraries required for development.\n- [Black](https://github.com/ambv/black) (Required for formatting)\n  - Must be run before pushing a Pull Request\n\nFor information about contributing to this project, please see the contribution section [below](#contributing)\n\n### Code Formatting\nFor code formatting, we use the formatting utility [black](https://github.com/psf/black). \nTo run it, run the following command from your favorite terminal after installing: `black amulet tests`\n\nIn order for your pull request to be accepted, this command must be run to format every file.\n\n### Building the Documentation\nTo build the documentation locally, run the following command: `make html` and then navigate to the\ngenerated directory `docs_build/html` in your favorite web browser\n\n### Branch Naming\nBranches should be created when a certain bug or feature may take multiple attempts to fix. Naming\nthem should follow the following convention (even for forked repositories when a pull request is being made):\n\n* For features, use: `impl-\u003cfeature name\u003e`\n* For bug fixes, use: `bug-\u003cbug tracker ID\u003e`\n* For improvements/rewrites, use: `improv-\u003cfeature name\u003e`\n* For prototyping, use: `proto-\u003cfeature name\u003e`\n\n### Pull Requests\nWe ask that submitted Pull Requests give moderately detailed notes about the changes and explain \nany changes that were made to the program outside of those directly related to the feature/bug-fix.\nMake sure to run all tests and formatting otherwise we cannot accept your pull request.\n\n_Note: We will also re-run all tests before reviewing, this is to mitigate additional changes/commits\nneeded to pass all tests._\n\nOnce a Pull Request is submitted, we will mark the request for review, once that is done, we will\nreview the changes and provide any notes/things to change. Once all additional changes have been made,\nwe will merge the request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famulet-team%2Famulet-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famulet-team%2Famulet-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famulet-team%2Famulet-core/lists"}