Editing Arcane University:XEdit Tutorial

Everything you see under your plugin in xEdit is an edit. Your plugin may add cells, worldspaces, references, forms, and so on. It can also modify any of these things. Good practice generally for creating a plugin is to avoid editing anything from vanilla Skyrim. If you need a container to contain a certain item and no vanilla chest has it, make a new container record. (This can be done quite easily by duplicating an existing chest and modifying the contents.) This is not always the case of course, if you're making a house, that house needs to go somewhere, so you'll need to edit Tamriel (the Skyrim worldspace) to place it. You could make a new worldspace, but the player will need a way to get there too, so you'll need to add a boat or portal of some kind to Tamriel or another cell. Any edits that are unintentional or unnecessary should be cleaned from your plugin.

Everything you see under your plugin in xEdit is an edit. Your plugin may add cells, worldspaces, references, forms, and so on. It can also modify any of these things. Good practice generally for creating a plugin is to avoid editing anything from vanilla Skyrim. If you need a container to contain a certain item and no vanilla chest has it, make a new container record. (This can be done quite easily by duplicating an existing chest and modifying the contents.) This is not always the case of course, if you're making a house, that house needs to go somewhere, so you'll need to edit Tamriel (the Skyrim worldspace) to place it. You could make a new worldspace, but the player will need a way to get there too, so you'll need to add a boat or portal of some kind to Tamriel or another cell. Any edits that are unintentional or unnecessary should be cleaned from your plugin.

Here is a dummy plugin made for the purposes of this tutorial. As you can see, there are many edits. Some of these edits are intentional, but some of them are not. How can you tell the difference? Ultimately, only you know what you intended to change, but xEdit has features to help. My plugin creates a small farmhouse, which has an interior cell (aaaBSTestCell) and an exterior that it's linked to. I also created a custom knapsack with specific items to go in my house.

Here is a dummy plugin made for the purposes of this tutorial. As you can see, there are many edits. Some of these edits are intentional, but some of them are not. How can you tell the difference? Ultimately, only you know what you intended to change, but xEdit has features to help. My plugin creates a small farmhouse, which has an interior cell (aaaBSTestCell) and an exterior that it's linked to. I also created a custom knapsack with specific items to go in my house.

What you'll notice is that various entries are marked with colors. Dark green, seen on the WarehouseAmbushes cell means that the record was declared in a different file and is marked as edited by another, but that record does not have any changed data. In this instance, this is because an object in the cell was moved, but the cell data itself is unchanged. Regardless, this is a dirty edit, and needs to be cleaned. The yellow color seen on PersonalChestSmall means something about the record, which was created in Skyrim.esm, was changed by your file. This could be the name, the contents of the chest, or just about anything. Regardless, it is a dirty edit. Lastly you'll see the red color on Tamriel. This is the Skyrim worldspace, and it will always show up as red. All this means is there were edits made in one file, which were reverted in another. For Tamriel specifically, blame Bethesda, but in other cases, you should investigate why it shows as red. Any record that shows the plain background color is a record that was created/placed by your plugin, and in most cases these will be intentional, but there can be exceptions. Only you will know these exceptions, as only you will know if something created in your plugin was intended.

What you'll notice is that various entries are marked with colors. Dark green, seen on the WarehouseAmbushes cell means that the record was declared in a different file and is marked as edited by another, but that record does not have any changed data. In this instance, this is because an object in the cell was moved, but the cell data itself is unchanged. Regardless, this is a dirty edit, and needs to be cleaned. The yellow color seen on PersonalChestSmall means something about the record, which was created in Skyrim.esm, was changed by your file. This could be the name, the contents of the chest, or just about anything. Regardless, it is a dirty edit. Lastly you'll see the red color on Tamriel. This is the Skyrim worldspace, and it will always show up as red. All this means is there were edits made in one file, which were reverted in another. For Tamriel specifically, blame Bethesda, but in other cases, you should investigate why it shows as red. Any record that shows the plain background color is a record that was created/placed by your plugin, and in most cases these will be intentional, but there can be exceptions. Only you will know these exceptions, as only you will know if something created in your plugin was intended.

To remove a dirty edit, simply right click and Remove.

To remove a dirty edit, simply right click and Remove.

xEdit will give a warning after the first time you click remove, this is just informing you that it's dangerous to edit files like this. Click yes. This will happen every time you reopen xEdit and try to make an edit. Cleaning plugins as outlined in this document shouldn't result in dangerous changes, but it's always good practice to backup your plugins before cleaning them. xEdit creates backups by default as well. If you are ever unsure if an edit is safe, you can always ask in the AU or ask someone more experienced with xEdit and the Skyrim engine.

xEdit will give a warning after the first time you click remove, this is just informing you that it's dangerous to edit files like this. Click yes. This will happen every time you reopen xEdit and try to make an edit. Cleaning plugins as outlined in this document shouldn't result in dangerous changes, but it's always good practice to backup your plugins before cleaning them. xEdit creates backups by default as well. If you are ever unsure if an edit is safe, you can always ask in the AU or ask someone more experienced with xEdit and the Skyrim engine.

This is the same plugin after being cleaned. As you can see, the cell I created remained, the container I made also remained, and the door and farmhouse I placed in Skyrim remained while all other changes were removed. One last note is the Navigation Mesh Info Map. This is navmesh data. This will never be highlighted with a color, and is slightly harder to determine whether it's a dirty edit. In this case, it was not, this is simply the navmesh in my cell. However, Sometimes the Creation Kit will erroneously edit this record. If this record is present in your plugin but you didn't edit any navmeshes, you are safe to remove it.

This is the same plugin after being cleaned. As you can see, the cell I created remained, the container I made also remained, and the door and farmhouse I placed in Skyrim remained while all other changes were removed. One last note is the Navigation Mesh Info Map. This is navmesh data. This will never be highlighted with a color, and is slightly harder to determine whether it's a dirty edit. In this case, it was not, this is simply the navmesh in my cell. However, Sometimes the Creation Kit will erroneously edit this record. If this record is present in your plugin but you didn't edit any navmeshes, you are safe to remove it.

xEdit allows you to remove unneeded master files from your plugin, but it's not quite as simple as removing an edit. Firstly, you need to ensure your file does not use anything from the unneeded master file. This means any asset, cell, worldspace, quest, or anything else declared in that master file, must not be placed or edited by your plugin. Once you have ensured this, right click your plugin and click Clean Masters.

xEdit allows you to remove unneeded master files from your plugin, but it's not quite as simple as removing an edit. Firstly, you need to ensure your file does not use anything from the unneeded master file. This means any asset, cell, worldspace, quest, or anything else declared in that master file, must not be placed or edited by your plugin. Once you have ensured this, right click your plugin and click Clean Masters.

As you can see, doing this removed Update.esm, Dawnguard.esm, HearthFires.esm, and Dragonborn.esm from my plugin's master list, as I did not use any references from any of these masters. For the purposes of Beyond Skyrim, all of these masters are okay to have on your plugin, as well as BSAssets.esm and whatever project you're editing. Your plugin cannot have multiple Beyond Skyrim projects as a master, and if your plugin aims to add or edit something in BSAssets, it is best practice to not have any Beyond Skyrim project as a master, only BSAssets.esm. Additionally, it is not acceptable to have another plugin as a master for your plugin unless the person doing merges for your project explicitly gave you permission to do so. This is because merging a plugin that uses another plugin as master makes the merge process significantly more complicated.

As you can see, doing this removed Update.esm, Dawnguard.esm, HearthFires.esm, and Dragonborn.esm from my plugin's master list, as I did not use any references from any of these masters. For the purposes of Beyond Skyrim, all of these masters are okay to have on your plugin, as well as BSAssets.esm and whatever project you're editing. Your plugin cannot have multiple Beyond Skyrim projects as a master, and if your plugin aims to add or edit something in BSAssets, it is best practice to not have any Beyond Skyrim project as a master, only BSAssets.esm. Additionally, it is not acceptable to have another plugin as a master for your plugin unless the person doing merges for your project explicitly gave you permission to do so. This is because merging a plugin that uses another plugin as master makes the merge process significantly more complicated.