Editing Contributing (section)

== Creating & uploading related files ==
Another major part of making a Wiki is illustrating, with images, sounds, or videos, everything is more understandable, whether the description was the most detailed or not.

=== Creating a screenshot ===
Taking screenshots of an in-game element is extremely useful, mainly for Biomes and Structures. The only conditions are that you have to use an unaltered version of the project.s you illustrate through the screenshots, have F1 activated (hidden hotbar and chat), an average FOV, and no Ressource Pack or Shader that would make the in-game blocks unrecognizable.

You can also look at the [[:File:Screenshots needed.jpg|"Screenshots needed" file page]] to see which pages are missing important screenshots.

=== Creating a render ===
Creating a render allows for a clean, accurate and unobstructed 3D view of a Structure or Entity. 

To do so, you will need the [https://www.curseforge.com/minecraft/mc-mods/isometric-renders Isometric Render] Fabric mod. It is also recommended to use the [https://www.curseforge.com/minecraft/mc-mods/nbt-editor NBT Editor] Fabric mod to be able to override the chat character limit that might prevent you from using some commands. Make sure to have cheats enabled and in creative or spectator, then : 

*Boot up your Minecraft instance and configure Isometric Renders' keybind for area selection.
* Load up your desired world that you want to make renders.
*Type <code>/isorender</code> to load up additional flags: <code>area</code>, <code>block</code>, <code>creative_tab</code>, <code>entity</code>, <code>insanity</code>, <code>item</code>, <code>lighting</code>, and <code>namespace</code> - <code>area</code> and <code>entity</code> are priority here.
**The <code>insanity</code> flag is for enabling larger resolutions, use at your own risk.
*You can find your renders in the <code>render</code> folder of your .minecraft directory - <code>\.minecraft\renders</code>.

==== Structure render ====
First, although finding a naturally spawned Structure can work for a overall render, some structures, for example, underground ones or random can be impossible to render accurately, this is why it is recommended to summon the structure or multiple parts of one. Since {{MCV|Edition=Java|Version=1.19}}, you can use <code>/place structure</code> to easily find and summon one, but for older version :  

*Take the target datapack and unzip it. (If it is a mod instead, change .jar extension to .zip and then unzip it).
* Go into the data folder (if mod, the data folder is under the resources folder).
*Now navigate to the data/(datapack or mod name)/structures folder. In there will be nbt files (or more folders containing nbt files).
*In minecraft itself, do <code>/give @s structure_block</code> to give yourself a structure block. Place it down. And right click on it to open a gui.
* Click the save button in bottom left corner until it says “load”. Then at top for name, put the name and path of the nbt file such as “modid:somefolder/filename” (do not put the folder named “structures” into the path).
*Click the bottom right load button and the piece will spawn above the structure block.

Once that is done, you can follow the next instructions to make your renders :

*Use your configured keybind to select an area in your world based on where you're looking (S by default), finish selecting by pressing the configured keybind again. You can use barrier blocks to help you select the exact corners of the structure. You can reset your selection by using your sneaking keybind + <code>Your Configured Keybind</code>.
*Disable your shaders if you have any.
*Type <code>/isorender area</code> and it will render the selected area you have made.
* Configure the render to your liking by changing the <code>Transform Options</code> section. For a 3D view, click the <code>Isometric</code> button in the Presets options then, if needed, change the <code>Rotation</code> in the <code>Rendering options</code> to make the front or opening of the structure face the bottom left corner of the screen. Make sure the render is accurate to the options you set in your <code>.minecraft/renders/areas</code> file, if the sides of the render are cut, change the <code>Scale</code> in the <code>Transform Options</code> section, make sure it is not appearing too small as a .png either. To fix that you can also click and drag the structure's render around and zoom and un-zoom with your scroll-wheel. If some parts of the structure are invisible, make sure all chunks were rendered.
*Click on <code>Export</code> to export your render .
*Once you are done with your area, use your sneaking keybind + <code>Your Configured Keybind</code> to remove the area selection.

Or   

* You can specify coordinates when using <code>/isorender area</code>, you will need the first X Y Z coordinates and the second X Y Z coordinates of an area.
*Type <code>/isorender area X1 Y1 Z1 X2 Y2 Z2</code> and it will render the selected area you have made (XYZ1 and XYZ2 are the specified coordinates you have chosen).
*Configure the render to your liking by changing the <code>Transform Options</code> section. For a 3D view, click the <code>Isometric</code> button in the Presets options then, if needed, change the <code>Rotation</code> in the <code>Rendering options</code> to make the front of the structure face the bottom left corner of the screen. Make sure the render is accurate to the options you set in your <code>.minecraft/renders/areas</code> file, if the sides of the render are cut, change the <code>Scale</code> in the <code>Transform Options</code> section, make sure it is not appearing too small as a .png either. To fix that you can also drag the structure's render around and zoom and un-zoom. If some parts of the structure are invisible, make sure all chunks were rendered.
*Click on <code>Export</code> to export your render.<br>
<gallery>
File:2022-06-10 12.40.29.png|Selection area
File:Screenshot 1308.png|Isometric render mode {{MCV|Version=1.18}} menu
File:Screenshot 1309.png|Example of top view and chunk render issue
File:Efzdrghj (3).png|Example of a cut render
</gallery>
==== Entity render ====
[[File:Isometric mob render example.png|thumb|Isometric render mob rendering {{MCV|Version=1.18}} window]]
*Disable your shaders if you have any.
*To make a render of an entity, type <code>/isorender entity ENTITY_id</code> or find the entity you want to render, look at it and type <code>/isorender entity</code>.  
**NBT tags work with Isometric Renders, it follows the same way of summoning an entity with NBT tags <code>/isorender entity ENTITY_id {NBT tag}</code>.
*Configure the render to your liking by changing the <code>Transform Options</code> section. Depending on the entity and it's equipment, the rotation may vary. It is recommended make sure the <code>Use External Renderer</code> option is checked to click the <code>Isometric</code> button in the <code>Presets options</code> then change the <code>Rotation</code> in the <code>Rendering options</code> to make the entity look to the bottom left corner of the screen. Make sure the render is accurate to the options you set in your <code>.minecraft/renders/minecraft/entities</code> file. Make sure the entity fits the .png or it will appear smaller than the image box, to fix this, change the <code>Scale</code> in the <code>Transform Options</code> section. If needed, you can click and drag the mob render around and zoom and un-zoom with your scroll-wheel. If the entity has an animation that could obstruct it's render, like a Blaze, check the <code>Animations</code> option and un-check it until the face of the entity is visible.
*Click on <code>Export</code> to export your render.

=== Extracting files ===
Reuploading parts of Stardust Labs' projects on the Wiki, like sounds or textures can help illustrate content in new ways. Just note that .png, .gif and .jpeg files have to be at least 256x256 to appear correctly on the Wiki.

=== Uploading files ===
This wiki allows multiple ways of adding files to its library.

==== MSUpload ====
[[File:Screenshot 974.png|thumb|Location of the batch upload option]]
To upload Stardust Labs projects-related files, Edit a page and go in "Source editing mode". Once in that mode, a small window will appear where you can drag the files you want to upload. Select the files from your folders and drag them onto that window. Once all the files are listed, we recommend, if you want, to rename them, so that other users can find files related to the article they are writing or modifying. After that, you can click the "Upload all files" button which will upload your screenshots in the Wiki file gallery. This can take time, but once uploaded, those files will be available to be added into any gallery for a biome, structure, item, or mob, no need to create a page. So do not hesitate to upload all the related files you have.

==== Upload Wizard ====
The Upload Wizard page is a pretty self-explainatory way of uploading multiple files at once, you can access it [[Special:UploadWizard|here]], or use the "Upload multiple files" shortcut always accessible on the left of your screen.

=== Adding files ===
To add those files to a new or existing gallery, in Visual editing, create or click to edit an existing one, then click on "+ Add new image". This will open a window showing your uploaded pictures, you can also search for pictures posted by other users of the Wiki. Once that is done, check the Options to change the display mode if needed.

If you don't have or find any pictures for the article you are writing, you can look for the "Screenshots needed" image to notify other users to add pictures if they have any.<gallery mode="nolines">
File:Screenshot 970.png|Location of the Insert Gallery tool
File:Screenshot 971.png|Example of the Insert Gallery tool.
File:Screenshot 972.png|Example using the search bar of the Gallery tool, showing screenshots uploaded by other users
File:Screenshot 973.png|Example of the Gallery options
</gallery>