mc-creative-clone 0.1.0

Copies a Minecraft world and converts it to a creative mode backup

Minecraft Creative Backup

A command-line tool that copies a Minecraft world save, patches it into creative mode with cheats enabled, and launches it through PrismLauncher — all in one command.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
   • Options>
4. Contributing
5. License
6. Contact

About The Project

Minecraft Creative Backup is a Python CLI tool that automates the process of creating creative mode backups of Minecraft worlds managed by PrismLauncher.

When building or experimenting in Minecraft, it's useful to have a creative mode copy of a survival world - but doing it manually means copying the folder, opening the world, changing the game mode, and enabling cheats. This tool automates all of that in a single command.

What it does

• Copies a Minecraft world save folder
• Patches the world's level.dat to enable creative mode and cheats
• Renames the backup with the current date for easy identification
• Launches the instance directly through PrismLauncher

(back to top)

Built With

• 
• 
• 
• 

(back to top)

Getting Started

Prerequisites

• Python 3.14 or higher
• PrismLauncher installed and configured with at least one instance and world.
• uv (recommended) or pip

Installation

1. Clone the repository

   git clone https://github.com/xanderboy2001/mc-creative-clone.git
   cd mc-creative-clone

2. Install the package

   uv tool install .

Or with pip:

   pip install .

3. Verify the installation

   mc-creative-clone --help

(back to top)

Usage

Run the tool interactively - you will be prompted to select an instance and world:

mc-creative-clone

Or specify options directly to skip the interactive prompts

mc-creative-clone --instance "My instance" --world "My world"

Options

Option	Short	Description
--prism-path PATH	-p	Path to PrismLauncher data directory. Defaults to the standard OS path.
--instance INSTANCE	-i	Name of the PrismLauncher instance to use.
--world WORLD	-w	Name of the world to copy.
--force	-f	Overwrite the destination world if it already exists without prompting.
--dry-run		Preview actions without making any changes to the filesystem.
--verbose	-v	Enable verbose debug logging output.

Examples

Preview what would happen without making any changes:

mc-creative-clone --dry-run --instance "Survival" --world "My World"

Force overwrite an existing backup:

mc-creative-clone --force --instance "Survival" --world "My World"

Use a custom PrismLauncher data directory:

mc-creative-clone --prism-path "/path/to/prismlauncher"

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top contributors:

License

Distributed under the GPL-3.0-or-later. See LICENSE.txt for more information.

(back to top)

Contact

Alexander Christian - [e-mail]

Project Link: https://github.com/xanderboy2001/mc-creative-clone

(back to top)