Magic Words: Import/Export v1.0

::----- README.txt -----::
Magic Words IE (Import/Export) 1.0
by Amaikokonut with Bonus Creature "Path Pain" contributed by Mea (see notes at the end for info)

May be found at Naturing :: Nurturing (https://naturingnurturing.blogspot.com) and/or Naturing :: Nurturing :: Static (https://naturingnurturing.songua.com) and/or a friendly community archive near you!

If you're going to rehost or redistribute this agent, please leave this readme intact.

If you have any comments, questions, bug reports, or just want to chat, email *****@songua.com

:: About ::

This set of Magic Words hopes to make it easier for you to handle importing and exporting creatures in your world.

A word of caution-- the more creatures you have in your My Creatures folder, the slower these commands will run. If you have hundreds of creatures, you may occasionally get the 'infinite loop' error, but it's not actually infinite-- you can retry until the script finishes running, or abort the loop and run the command again until you get all the creatures you want. Additionally, be very careful when importing tons of creatures. The last thing you want is to import 500 creatures and then your game crashes, erasing all the creatures you just imported.

The basic syntax for these commands is simply Import [what] and Export [what]. There can be many 'whats'. You can specify number, species, gender, lifestage, and/or world, in any order. There is a safeguard limit of 50 creatures for imports, but you can override this (at your own risk!) by specifying a number higher than 50 or simply "all" Some examples:

Import 4 -> Imports 4 of any creature
Import ettin -> Imports one ettin
Import norns -> Imports up to 50 norns
Export male norns -> Exports all male norns
Import all grendels -> Imports ALL grendels, even if there are more than 50 in your exports folder.
Import ettin 4 -> Imports 4 ettins. 'Import ettins 4' has the same effect.
Import 4 ettin child female -> Imports 4 female child ettins
Export youths -> Exports all youth creatures
Import 10 adult genderless -> Imports 10 adult genderless creatures of any species
Import 4 ettin child female w:ettin_world -> Imports 4 female child ettins that were exported from a world named "Ettin World"

'World' is a special parameter that will look for only creatures who have been exported from the specified world. This is useful when doing a complete migration from another world. This specification must begin with "w:" and contain no spaces. If there are spaces in the world name, you will need to replace them with underscores. This does mean that there is no distinction between creatures exported from 'Albian Reborn' and 'albia_reborn' so if for some reason you name your worlds like that, keep that in mind.

The export command works identically to the import, sans the world parameter and 50 creature limit.

One last thing worth mentioning-- this agent does include an additional command: 'Cloning Toggle'. By default, it is set to NOT bypass import cloning and WILL clone creatures that you import that were not originally exported from one of your worlds (such as creatures you've downloaded). This is important to prevent moniker clashes if the creature is sent through the warp later. While, as of writing, online creature tracking isn't set up in Albian Warp or Rebabel, it's not impossible that it will be one day in the future. If you choose to turn cloning off, please consider not sending the creatures that you import through the warp. Also note that this toggle ONLY affects Magic Words Import, and does not impact imports that happen via the traditional control panel.

Otherwise, hope you find this useful!

:: Bonus ::

Included is a creature very appropriately autonamed Path Pain, with a moniker, also appropriately, ending in 666. While rigorously testing Magic Words IE, Mea discovered that this creature-- and for some reason, this creature only-- was causing the agent to throw errors after she had moved it out of the exports folder. When she sent me the creature, I discovered the exact same thing. It was super ominous. Eventually we were able to fix the error with a better-placed PRAY REFR, but this creature might actually be cursed, so in the true spirit of 2020, we're passing this curse on to you. Import at your own risk, of course! And like any creature you download from the internet, you'll need to bypass import cloning to retain the original name and moniker of the creature.

 <...truncated>

Name: Path Pain
Genus: Norn
Gender: Female