Amulet-Editor-Operations

Authored and Contributed Amulet Editor Operations. Based on information from GentleGiantJGC.

• twf_blanket place saplings on grass or dirt

• enclave_TWF_v1 Wrap the selection around a cylinder centred on its lowest x,z point

• sphere_TWF_v1 Generate a 3D Ellipse within the selection box. Block palette is in a table within the script.

• lore_loader_TWF_v1 Creates chests with items with custom naming, lore, enchants, and other properties. Input file goes in Amulet/plugins/operations/lore_loader_input.json and an example of the layout is available here in this repository.

• bedrock_geometry_export_v2_amulet.py exports the selection as a bedrock geometry json file in the Amulet root directory. You can then load this in Blockbench to edit it and fix some of the inefficient cube layouts. Handy for those of us who start all modeling projects by placing blocks in game.

• analyze_TWF_v3.py (compatible with v0.8.8+) will count the block types in the selection and print the results to the Amulet Editor console, and write the data in JSON format to the file analyze_results.json in your Amulet directory. This Operation is a good example of how to work with the selection to find the co-ordinates of all the selected blocks. It also shows how to work with block metadata in the Amulet Editor Universal format.

• dump_chunk_TWF_v1.py (compatible with v0.8.8+) shows how to access the chunks that are intersecting the selection boxes, iterate through them, and write out some of their nbt structures to the Amulet Editor console.

• get_version_block_v1.py output the details and nbt of all the blocks in the selection. Writes to the console. Use for comparing in-game nbt with manual edits.

• set_blocks_from_palette_TWF_v1.py (compatible with v0.8.8+) fills the selection with random blocks defined in a 'palette' of block types set up within the script. It uses the platform and version information from the loaded level to avoid the user having to specify a particular game version in the script. It also has examples of passing block properties, which need to be set as NBT tags. (I've tried to simplify the block access as much as possible for the user, at the expense of performance).

• clone_to_sky_TWF_v1.py replicates the selection vertically. Use this to create towers from a single 'floor'. Shows how to access the copy/paste similar to how we would use MCSchematics in the earlier program MCEdit Unified. Includes a helper method to mark the chunks intersecting the selection boxes as dirty.

• create_and_fill_a_chest_TWF_v1.py shows how to work with NBT data structures, and block entities in a chunk. This Operation creates a single chest at the lowest selection point and puts some items in it.

• tapering_spiral_TWF_v1.py draws a snow-cone shape in space with a series of block types. Radius is average of the halved width and depth of the selection box.

• spiral_sphere_TWF_v1.py draws a spindle shape in space with a series of block types. Radius is average of the halved width and depth of the selection box. Stores the blocks to be placed to minimise drawing requests.

• make_chunk_outline_TWF_v1.py draws wool in the sky at y-255 around the chunk border.

• klein_loop_kangaroo_physics_TWF_v1 Some methods for plotting into a selection box in worldspace with a scaled pointcloud.

More Resources

PremiereHell is writing operations to work with NBT structures here: https://github.com/PREMIEREHELL/Amulet-Plugins

StealthyExpert is writing and sharing Amulet Editor Operations here: https://github.com/StealthyExpertX/Amulet-Plugins

5uso uses Amulet Core API to do useful things here: https://github.com/5uso/AmuletScripts

Amulet Core API docs: https://amulet-core.readthedocs.io/en/stable/api_reference/

The Amulet Editor and MCEdit Unified Discord is where all the cool kids hang out. Check the #amulet-plugins channel. Join via https://www.amuletmc.com/, the /r/MCEdit reddit, or with this invite: https://discord.gg/pGUwZb9m65

I'm doing a bit of tweet-devlog over here. Follow for new discoveries, methods and real time discussions: https://twitter.com/abrightmoore/status/1408697813542658048

Need help installing and using an Operation?

Here is a walkthrough of using the Analyze operation:

1. Go here: https://github.com/abrightmoore/Amulet-Editor-Operations
2. Click here: analyze_TWF_v3.py
3. Click the button that says "Raw"
4. Right Click and choose Save As
5. In the location chooser, navigate to your Amulet/plugin/operations directory and save the file with its .py extension
6. In the 3D editor of an Amulet Open World, mark a selection box using Select mode
7. Choose the Operations mode
8. Click the refresh cycle button if your Amulet session was already open when you saved the Analyze operation
9. Choose "Analyze (TWF v3)" from the drop down list
10. Press "Run Operation" button
11. The results are shown on the console output, and a .json file is saved into the Amulet directory called "analyze_results.json"