Difference between revisions of "TerraFirmaCraft:How To Contribute"

Revision as of 14:39, 15 September 2019

Creating A New Page

Remember to include {{Blocks}} at the end of the page. This adds the Navigation menu.

Knapping Template

Here is blank knapping template:

{{Knapping
|A1= |B1= |C1= |D1= |E1=
|A2= |B2= |C2= |D2= |E2=
|A3= |B3= |C3= |D3= |E3= 
|A4= |B4= |C4= |D4= |E4= 
|A5= |B5= |C5= |D5= |E5=
|Output= 
}}

Materials used in knapping template have "Flat" in the filename. ex: Flat Straw, Flat Leather, Flat Linen, etc. Just add the name of the material next to the cell you want it displayed in. For example:

{{Knapping
|A1= Flat Straw |B1= |C1= |D1= |E1= Flat Straw
|A2= Flat Straw |B2= |C2= |D2= |E2= Flat Straw
|A3= Flat Straw |B3= |C3= |D3= |E3= Flat Straw 
|A4= Flat Straw |B4= |C4= |D4= |E4= Flat Straw 
|A5= Flat Straw |B5= Flat Straw |C5= Flat Straw |D5= Flat Straw |E5= Flat Straw
|Output= Straw Basket}}

results in:

There is another version of the template that begins {{Grid/Knapping that's sometimes used on the wiki when there are alternate knapping recipes. This template allows the pattern to animate, but it is buggy... it resizes the alt textures to 32px). In the few cases there are two knapping recipes for something, it's usually swapping materials as a whole (wolf fur vs bear fur) or it's mirroring the pattern (clay axe mold). It might be better to just make a note in the text instead of using the buggy template.

Alternate outputs can be animated by listing them in the appropriate space separated by a semicolon. To add a number to the output, follow the name with a comma and the number.

Uploading Images

Finding Images

The textures can be found in the mod folder (or unzipped jar) under \assets\terrafirmacraftplus\textures.

Resizing

When you scale them up set interpolation to none or nearest neighbor to keep the pixel edges clean. For batch editing, I use the BIMP 2.0 extension for GIMP 2.10 to scale a whole folder of images.

Naming Conventions

Files names should have the first letter of each word capitalized. The exception is when ProPick is used. Spaces and underscores are interchangeable. ex: Foo Bar.png or Foo_Bar.png not Foo bar.png.

Sizes

Items may need to be uploaded in two versions:

A 32x32 px with the naming convention: Grid_Item.png is used for items in [crafting grid templates.]

A 36x36 px with the naming convention: Grid_Flat_Item.png is used for knapping materials.

A 150x150 px (or as close as possible) with the naming convention: Item.png is used in the block info template for an item's individual wiki page. A gif can be used instead of a png for the larger item image. Use a frame delay of 2000 ms.

New versions of images not updating?

If you upload a new version of an image and it is displaying the old version, open the direct link to the image and append ?action=purge to the url and hit enter. This might fix it.

Displaying uploaded images on a page

[[ Image:Image.jpg | frame(or thumb) | position | 300px | caption ]]