Adding Custom Structures - Silverminer007/Shrines GitHub Wiki

Adding custom structures

You'd love to see your own structures appear in new worlds? We've got your back!

Relations:

To add a custom structure using the Shrines mod there are two ways, but both start same:

  1. First build your structure!
  2. Decide how your structure should be named
  3. Export your structure to a file using structure-blocks (vanilla)
  4. For the mod to work, minecraft must have been started at least one time with the latest version of the mod (quit game)

Here you have to decide:

  • Do you want to add the structure manually via filesystem
  • Do you want to add them via using commands

Commands way

!!!Note!!! For experienced users the command help might be sufficient to understand. To get the help type "/help shrines-structures"

  1. Use the command "/shrines-structures" to add your structures

5.1. Add the structure with "/shrines-structures add |name of your structure| |seed|"

|name| of your structure should be replaced with the name chosen in step 2 above

|seed| is optional and should be replaced with an integer (The seed decides where your structure will be placed in the world, but don't care about it and set it to any random value)

!IMPORTANT! Never use same seed twice. This would cause the structures to appear in each other (More Information1, More Information2)

5.2. Type "/shrines-structures query" to see a full list of custom structures that you've added Your name chosen in step 2 should be shown.

5.3. Type "/shrines-structures query |name of your structure|" to see the actual configuration of your structure

5.4. Use "/shrines-structures configure |name of your structure| |option| |value|" to change same values of the configuration of point 5.3

|option| is one of the names in the output of point 5.3 before the ":"

|value| is the value beloning to the |option| above. Only same types as default are supported (e.g. an integer can't be set to an boolean or an string can't be set to an integer)

  1. Restart your Minecraft (Quit game)

  2. Navigate to your Minecarft Directory (Help)

  3. Open up the directory "shrines-saves"

  4. Check if the structure was set up correctly. There should now be a file called "structures.txt" and a folder "shrines" in this directory.

  5. Now open the folder "shrines". There should be a folder with the name of your structure. Open this up

  6. There is a file with the name of your structure. Here you could change any settings. Search for "Pieces:". After this line there should be a line "[resource, [0,0,0]]"

  7. Change "resource" to the name of your exported *.nbt file from step 3 above (Without extension)

  8. Copy your *.nbt file next to the |name of your structure|.txt file (You should have a copy of your structure elsewhere to prevent data loss because of bugs)

  9. Restart your Minecarft again. Your structures should now appear in new worlds (test with "/locate shrines:|name of your structure|")

Manually

  1. Here you do mainly the same as in the way with commands, but you create all the directories and files on your own

5.1. Navigate to your Minecarft Directory (Help)

5.2 open up the directory "shrines-saves"

5.3 there create a file named "structures.txt" (If it doesn't already exists)

5.4 Put in each line of the file a name of a new structure (lower-case, no special character, no brackets)

5.5 Restart Minecraft to create needed files

5.6 Copy the *.nbt files in the associated folder and rename them to resource.nbt

6.0 Restart your Minecarft again. Your structures should now appear in new worlds (test with "/locate shrines:|name of your structure|")

Multiple .nbt files

Having multiple .nbt files in one structure isn't hard to do. You have to add one line (for each additional file) to your config file of the structure. Search there for the option "Pieces:". After this line, there should be a line named "[resource, [0,0,0]]". Add a ";" at the end of this token to mark, that there is one more possible file. Copy this token behind the ";" as much as you have structure pieces (The count of *.nbt files). Change "resource" for each line to the name of one of your .nbt files. Make sure that the last line doesn't have a ";". That would cause syntax errors

The content of the second brackets ([0,0,0]) is an offset position from the original generation position, so you can adjust the distance between the .nbt files. (Note that it isn't the 'distance' between them, but it helps to create the correct distance between them)