Contributing

From WoopMC
Revision as of 14:41, 27 May 2023 by StardustLabs>Tera458
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This Contributing page is here to explain how you can help the community of this Wiki grow and assist the gathering of information and content about all Stardust Labs projects.

There are different ways to achieve that, which will be explained in the following chapters.

Gathering info

Identifying and gathering info is important for this Wiki to centralize and keep it updated. Depending on the article, if it is about a biome, a structure, a mob, an item, a feature... Although exploring/testing in-game and taking screenshots to give an overall description of a project element is the best way to start an article, precise info can be difficult to gather. Things like biomes' data, including biome colors, precipitations, temperature, downfall, mob spawn, or biomes a structure can spawn in or loot chance are things that can only be made certain by exploring the projects' files.

If you need any more help or directions of what you can help look for, you can write in the #wiki channel in https://discord.gg/QYDSunbGNP.

Biome info

Biome info gathering is pretty simple and self-explanatory, despite the amount of info there is to find. You can most of the time find everything just by opening the corresponding biome .json that you will find in \data\project name\worldgen\biome. Note that the info can sometime be mixed up and still work. Right now, we are working on a script able to extract the info from those .json and transform them into different template, allowing us to display this info on the wiki in a more readable format.

If you are experienced in coding and able to help automatize the gathering and reformatting of biomes .jsons. Please inform us on the https://discord.gg/QYDSunbGNP.

Otherwise, it is not possible to list all blocks used only on the surface on each biomes. Gathering that info is crucial, since it is the only missing piece of the puzzle.

Structure info

Since 1.18.2, structures are linked to biomes through a tag system, each biome having a corresponding tag and or sometimes tags, that we will call category tags, including multiple biome, like is_savanna or is_ocean. This new system adds support between Vanila structures or structure Datapacks and Vanilla or Worldgen datapacks since each worldgen datapack can modify a category tag to include their biome and by doing so, let structures that spawn in that category tag to also spawn in this new biome.

Those category tags can most of the time be found in \data\minecraft\tags\worldgen\biome, and each tags a vanilla structure uses can be found in \data\minecraft\tags\worldgen\biome\has_structure. If a project adds structures, the tags for that structure can be found in \data\project name\tags\worldgen\biome\has_structure.

We are working on a script able to read those tag files and compare them to other Stardust Labs' projects files to list which structures can spawn in each biome and vice versa.

If you are experienced in coding and able to help automatize the gathering and reformatting of those files. Please inform us on the https://discord.gg/QYDSunbGNP.

Mob info

Example of a mob .nbt file location
Example of an entity NBT code
File:Entity info Google sheet.png
Example of an entity info gathering Google sheet

Finding where a custom entity spawn is pretty easy in-game, but finding out their statistics is more tedious.

To do so, you would have to first find the mob .nbt file. If the mob is tied to a structure, you should find it in that structure's folder. Once located, it is recommended to open it using Visual Studio Code with the NBT Viewer extension. Once both are installed, just drag the .nbt into the program, wait, then select SNBT to see the entity code. Inside that code, you will find everything from the entity's health to it's equipment.

If you are unable to find this file, you can go in-game, near the entity you want the stats of, and use /data get entity @e[type=!minecraft:player,sort=nearest,limit=1]. This will give you the stat you specified of the entity.

Right now, we have no program to extract that info and put in the corresponding Entity Template infobox code, so we use a Google Sheet and manually copy and paste each info of each entity using this function :

="{{Entity
|health={{hp|"&B2&"}}
|armor={{Armor|"&B7&"}}
|spawn=[["&B8&"]]
|damage='''Armed'''<br>
''Easy'': {{hp|0}}<br>
''Normal'': {{hp|"&B11&"}}<br>
''Hard'': {{hp|0}}<br>
'''Unarmed'''<br>
''Easy'': {{hp|0}}<br>
''Normal'': {{hp|"&B9&"}}<br>
''Hard'': {{hp|0}}<br>
|speed="&B12&"
|behavior="&B13&"
|drops="&B14&"}}"""

You can also ask for access on the shared Google Sheet in the #wiki channel of the https://discord.gg/QYDSunbGNP.

Item info

WIP

History info

The History section of a page is there to yarn about the origin and development of a biome, item, structure or mob. The best way to know is this look on the https://discord.gg/QYDSunbGNP or ask the developers when they are available.

Lore info

The Lore section of a page is the place where you can link and interpret information found in and around a project about the in-game origins of a specific biome, item, structure or mob. This information may also be brought together in the Lore section of a project.

Making an account

As a security for the users and for the Wiki, you first have to create an account and validate your email adress to be able to do any modification on the Wiki. For this, click create an account at the top right of your screen. Follow the short steps and you should receive an email soon after creating the account. If that is not the case, you can click Preferences at the top right of your screen. Scroll down your User profile and you should find an Email options section at the end. Make sure your email is confirmed here.

Basics

In the upper right corner of almost all of the Wiki pages, you should see a "Create" or "Edit" button, depending on if the page is created or not. Click this to go into Visual edit mode and start contributing! Different tools are available and will be showcased to you. A more advanced mode, Source editing, or Create source on a new page, can also be accessed, but it is not recommended for new users or people with no coding knowledge.

If you want to create an article, take a look at the other articles in that category, especially how they are formatted. For example, most articles should start by re-adding the Title of the page using the BOLDPAGENAME template like so : Contributing or use the BOLDPAGENAMES template if plural.

Then, write a short description of what the article is showcasing, like this page is doing. You should also link pages related to the page you are creating, even if the pages are not created or if it's from another site like Wikipedia. Also learn to use the different templates at your disposal, all details here.

Feel free to modify an existing article if it contains grammatical errors, info errors, missing info, or is just awkward to read. Do not restructure an article unless said article was not formatted like other articles of the same category.

Small tip: in the Visual editor, writing "[[" will open the link creation window. You can also use the Sandbox link in the top right to access a page that can be used as you please. You can also use that page to test out the edit tools of Mediawiki explained below.

Models

Depending on the content, a page can be formatted the same way through different projects. Those templates are here to help you create a page easily by completing the pre-made formatting with the missing information. To use them, simply copy whats inside the code blocks and paste it in the Visual editor mode on the page you want to create. All of those models include empty template, to fill them, simply click on them to open their menu with all the information on how they work. To skip a line in a template, use <br>.

Biome page model

{{Biome
|biomeid=
|category=
|temperature=
|humidity=
|precipitation=
|type=
|rarity=
|structures=
|blocks=
|mobs=
|skycolor={{color|}}
|fogcolor={{color|}}
|grasscolor={{color|}}
|foliagecolor={{color|}}
|watercolor={{color|}}
|underwaterfogcolor={{color|}}}}The {{BOLDPAGENAME}} (Description)
(If a TOC appears, use {{TOCleft}} (you can delete this line))
<gallery mode="slideshow">
File:Screenshots needed.jpg
</gallery>

== Spawn rates ==
{{Spawn table}}

== History ==
(Incendium only) (Story behind the creation/conception of the biome by the devs)

=== Lore ===
(Lore behind the existence of the biome)

== Media ==
(All accurate mediatic representations of the page subject, if none, delete the sub-headings and this text, replace with {{WIP}})
=== Animations ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Screenshots ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Artwork ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Video ===
{{#ev:youtube|LINK -eg|720}} (Replace LINK with the link to a youtube video showcasing the subject)

== Changelogs ==
{{Version|Name=|Version=}} (Change made to that biome in specified project version)

Structure page model

{{Structure
|structureid=
|biomelist=
|mobs=}}The {{BOLDPAGENAME}} (Description)
(If a TOC appears, use {{TOCleft}} (you can delete this line))
<gallery mode="slideshow">
File:Screenshots needed.jpg
</gallery>

== Layout ==
(Only for complex structures) (Description of each section and each rooms in those sections)

== History ==
(Incendium only) (Story behind the creation/conception of the structure by the devs)

=== Lore ===
(Lore behind the existence of the structure)

== Media ==
(All accurate mediatic representation of the page subject, if none, delete the sub-headings and this text, replace with {{WIP}})
=== Animations ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Screenshots ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Artwork ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Video ===
{{#ev:youtube|LINK -eg|720}} (Replace LINK with the link to a youtube video showcasing the subject)

== Changelogs ==
{{Version|Name=|Version=}} (Change made to that structure in specified project version)

Entity page model

{{Entity
|health=
|spawn=
|behavior=}}The {{BOLDPAGENAME}} (Description)

== Location ==
(Exact conditions/place the entity can appear in)

== Loot ==
(Use the Loot table Template)

== History ==
(Incendium only) (Story behind the creation/conception of the entity by the devs)

=== Lore ===
(Lore behind the existence of the entity)

== Media ==
(All accurate mediatic representation of the page subject, if none, delete the sub-headings and this text, replace with {{WIP}})
=== Animations ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Screenshots ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Artwork ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Video ===
{{#ev:youtube|LINK -eg|720}} (Replace LINK with the link to a youtube video showcasing the subject)

== Changelogs ==
{{Version|Name=|Version=}} (Change made to that entity in specified project version)

Item page model

{{Item
|attack speed=
|baseitem=
|durability=
|attack damage=
|command=}}The {{BOLDPAGENAME}} (Description)

== Obtaining ==
The {{BOLDPAGENAME}} (Location in a structure or chance of drop from an entity, link included)
<gallery>
File:Screenshots needed.jpg
</gallery>

== Modifications ==
(Indicate if this item can be renamed, if it keeps it's font color when doing so, and if it can be trimmed)
=== Possible upgrades ===
(Modifications that could make the item stronger or better, if none, delete)
=== Downsides ===
(Modifications that could make the item weaker or unusable, if none, delete)

== History ==
(Incendium only) (Story behind the creation/conception of the item by the devs)

=== Description ===
(Description on the item, if none, delete)

=== Lore ===
(Lore behind the creation, existence and use of the item)

== Media ==
(All accurate mediatic representation of the page subject, if none, delete the sub-headings and this text, replace with {{WIP}})
=== Animations ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Screenshots ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Artwork ===
<gallery>
File:Screenshots needed.jpg
</gallery>
=== Video ===
{{#ev:youtube|LINK -eg|720}} (Replace LINK with the link to a youtube video showcasing the subject)

== Changelogs ==
{{Version|Name=|Version=}} (Change made to that item in specified project version)

Edits

Editing and updating existing pages is also important to make sure the information is accurate and that it's presentation is also to the standards and formatting of the rest of the Wiki. Proofreading, adding new media, images, videos, illustrations, or simply making sure the info is as complete and detailled as necessary.

Here are lists of the oldest page edits and newest pages edits to help in knowing what pages to update in priority.

{{#dpl: namespace=

addeditdate=true ordermethod=lastedit order=ascending

}}

{{#dpl: namespace=

addeditdate=true ordermethod=lastedit order=descending

}}

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 "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 Isometric Render Fabric mod. It is also recommended to use the 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 /isorender to load up additional flags: area, block, creative_tab, entity, insanity, item, lighting, and namespace - area and entity are priority here.
    • The insanity flag is for enabling larger resolutions, use at your own risk.
  • You can find your renders in the render folder of your .minecraft directory - \.minecraft\renders.

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 1.19, you can use /place structure 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 /give @s structure_block 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 + Your Configured Keybind.
  • Disable your shaders if you have any.
  • Type /isorender area and it will render the selected area you have made.
  • Configure the render to your liking by changing the Transform Options section. For a 3D view, click the Isometric button in the Presets options then, if needed, change the Rotation in the Rendering options 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 .minecraft/renders/areas file, if the sides of the render are cut, change the Scale in the Transform Options 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 Export to export your render .
  • Once you are done with your area, use your sneaking keybind + Your Configured Keybind to remove the area selection.

Or

  • You can specify coordinates when using /isorender area, you will need the first X Y Z coordinates and the second X Y Z coordinates of an area.
  • Type /isorender area X1 Y1 Z1 X2 Y2 Z2 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 Transform Options section. For a 3D view, click the Isometric button in the Presets options then, if needed, change the Rotation in the Rendering options 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 .minecraft/renders/areas file, if the sides of the render are cut, change the Scale in the Transform Options 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 Export to export your render.

Entity render

Isometric render mob rendering 1.18 window
  • Disable your shaders if you have any.
  • To make a render of an entity, type /isorender entity ENTITY_id or find the entity you want to render, look at it and type /isorender entity.
    • NBT tags work with Isometric Renders, it follows the same way of summoning an entity with NBT tags /isorender entity ENTITY_id {NBT tag}.
  • Configure the render to your liking by changing the Transform Options section. Depending on the entity and it's equipment, the rotation may vary. It is recommended make sure the Use External Renderer option is checked to click the Isometric button in the Presets options then change the Rotation in the Rendering options 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 .minecraft/renders/minecraft/entities file. Make sure the entity fits the .png or it will appear smaller than the image box, to fix this, change the Scale in the Transform Options 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 Animations option and un-check it until the face of the entity is visible.
  • Click on Export 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

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 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.

Templates

Location of the Insert Template tool

To help you when creating a page and to keep the Wiki formatted, Templates are available. To find them, click on "Insert", then "Template" and search for the Template for the type of page you're creating. For example, if you create a page for a biome, look for the "Biome" template, then follow the instructions inside that template.

Small tip, in the Visual editor, writing "{{" will open the Template window.

Existing templates

Project

Displays a link to a chosen project main page, do not use on projects main pages. {{Project|Project name=...}}

Example : Terralith

BOLDPAGENAME

Auto displays the page's name in bold. {{BOLDPAGENAME}}

Example : Contributing

BOLDPAGENAMES

Auto displays the page's name in plural and bold. {{BOLDPAGENAMES}}

Example : Contributings

Link

Makes any word.s a link. if the page exists on the Wiki, it will link to that page. If not, it will link to the Minecraft Wiki. {{Link|...}}

Example : Incendium, Frog

Version

Helps you display a project's version with a link to its changelog. Used in descriptions and Changelogs parts of an article. {{Version|Name=...|Version=...}}

Minecraft version

Helps you make a link to a Minecraft Java or Bedrock version information/changelog page, if the Edition is not specified, it automatically links to the Java version. {{MCV|Edition=...|Version=...}}

Example : 1.16.5

L2MCW

Short for Link to MC Wiki, used to link to a Minecraft Wiki page quickly, also used in infoboxes. {{L2MCW|...}}

Example : Frog

Tip

Used to display a small logo which display more text if hovered over. {{Tip|Info=...}}

Example :

WIP

Branch of Tip, used to quickly indicate part of a page is a Work In Progress, allows marking of missing info/files by checking this page. {{WIP}}

InlineInfo

Used to display info over a choosen text when hovering it. {{InlineInfo|Text=...|Inline text=...}}

Example : {{#tip-text: Brasil | The biome, not the country.}}

Warning

Use to display a Warning logo with the reason for the warning on hover. {{Warning|Warning=...}}

Example :

CheckCheck

Branch of Warning, allow users to indicate info needs to be verified, a motive can be added. Allows marking of missing info by checking this page. {{CheckCheck|Reason=...}}

Example :

Spoiler

Used to hide info behind a clickable box. {{Spoiler|Text=...}}

Example :

{{#spoiler:show=Show|hide=Hide|boo}}

Biome

Helps you create an Infobox with most technical information about a biome. Refer to Biome info to fill out the Template.

Structure

Helps you create an Infobox with most technical information about a structure.

Entity

Helps you create an Infobox with most technical information about a mob.

Item

Helps you create an Infobox with most technical information about an item.

EffectLink

Used to display an effect icon next to a text linking to it's Minecraft Wiki page.{{EffectLink|Name of effect|Text displayed}}

Example : Regeneration V

ItemLink

Used in lists of link to Item pages, displays the a link to the item alongside it's texture. {{ItemLink|Item=...}}

Example : Traveler's map

QuickLinks

Displays clickeable or unclickeable websites logos depending on if a download external link is provided for the corresponding website. Used for Compatibilities lists.

QuickLinksALT

Displays clickeable websites logos depending on if a download external link is provided for the corresponding website. Used for Compatibilities lists dependencies.

VideoShowcase

Facilitates the inclusion of a video or multiple videos on a page. Mostly used in the Showcases Videos section of a project.

Changelogs

Used only on the Changelogs part of projects pages. Helps you make a line with all the changes of a project's version.

Troubleshooting

Used only on Troubleshooting pages. Helps you make a window with an issue title, issue description, issue example and issue possible fix.

Markers

Markers are used when a whole page and its sub-pages are affected. Not to be confused with WIP, Warning and CheckCheck.

Page in progress

Indicates the page is still being researched/formatted/edited/incomplete. {{Page in progress}}

Update

Indicates the page has to be reworked to take into account new/updated elements caused by an update. {{Update|Reason=...}}

Discontinued

Marks a project as discontinued. {{Discontinued|Reason=...}}


Redirects

Location of the quick Redirect making button

Redirects are a type of page made to have multiple wordings of a page title lead to the same page, like the plural of an existing page. Forbidden castles for example, is a redirect page, plural of the Forbidden castle page, where it leads you.

To make a page a redirect page, create one in Source editing and add " #REDIRECT [[Page Name]] " or simply click the Redirect button and follow the instructions there.