Editing – Uploading Files
Below are detailed rules and step-by-step guides for properly uploading files to the wiki.
Upload Guidelines
- Make sure the file is relevant to the page, like a screenshot demonstrating something that's described in the page's text.
- Don't upload memes or content that doesn't suit the wiki.
- Tag the file appropriately.
- Do not upload duplicate files.
- If your file is a higher quality version, go to the file's page and click on "Upload a new version of this file".
- Exception: If the file is in a different format, a new version can't be uploaded. In this case, replace the old file in every page it appears on before marking it for deletion.
- If your new version doesn't appear, clear your browser's cache or press Shift + F5 together to clear the specific page's cache.
- Only use the latin alphabet and do not use invalid characters (\, /, :, *, ?, ", <, >, |, ~, `, !, @, #, $, %, €, ^, &).
- Do not upload builds directly to the wiki.
Filename Guidelines
It is important to name files properly in order to reference them on pages. It also helps for organization purposes. If the file is an asset from the game:
- Prefix the name with "PT-."
- If the sprite is exclusive to a specific build, add onto the prefix with the build name. For example, if the asset is exclusive to the Western build, prefix the file name with "PT-Western-."
- Keep the original sprite name at the end of the file.
If the file is artwork:
- Prefix the file with "TdP-."
- Include the name of the website where the art was pulled from.
- If the art does not have a title (which is likely), give it an appropriate name.
- When multiple pieces of art originate from a single post or a thread, give it the same name and number the images at the end of the file name.
Some examples of appropriate file names:
- PT-spr_player_idle.gif
- TdP-Twitter-NoiseConcepts1.png
- PT-Golf-GeromeLocation-Golf.png
Some examples of inappropriate file names:
- We're in minecraft.gif
- Cutie alert!.gif
- spr_player_idle.gif
Extracting Assets
Extracting files and other assets from the game's data.win file is done with the use of UndertaleModTool, a general purpose tool for modding games built in Game Maker. Make sure you're on the latest revision - known as Bleeding Edge - before extracting.
To extract audio, use either FMOD Bank Tools or foobar2000 in combination with the vgmstream plugin.
Extracting Graphics
Extracting graphics requires tools to correctly combine loose images into a .gif file. We recommend you use Aseprite or its forked counterpart LibreSprite. Using Ezgif is not allowed, as it'll result in improper animation speeds and canvas misalignment. This guide applies to sprites, backgrounds and tilesets.
- Unfold the Sprites tab and look for a sprite, background or tile. You can use the search bar on top to limit your results.
- Once you've double clicked on an entry, scroll down to Export all frames. If UndertaleModTool asks to include padding, always click yes.
- If you've extracted a non-animated background or tileset, you can skip these next few steps. Open Aseprite or LibreSprite and browse for the folder with the extracted sprite. Select the first frame (spr_..._0.png) of the animation. If you've been asked to load this as a sequence of bitmaps, click Agree.
- In the editor, click on Frame > Constant Frame Rate. For the duration, enter 50, as this is matches the 24 FPS speed that most sprites in the game use. Click on OK once you're done.
- Important in case you're extracting Peppino's sprites: Remove all yellow coloring from his clothes. This is due to the game having to separate Peppino's white teeth from his white clothes when using palettes. You can remove the yellow coloring by clicking on Edit > Replace Color... and clicking on the dot under RGBA to spread this color change across the entire animation.
- Click on File > Save As, change the file type to gif files and enter a file name that lines up with our filename guidelines. Ignore any warnings related to alpha channels. Make sure that Interlaced is unchecked and Animation Loop checked. Click OK and save.
- If your graphic isn't animated, you can simply rename the file and upload it with the .png file extension.
Now you're ready to upload your extracted graphic to the wiki. Below are examples of incorrectly ripped graphics to get a grasp of how animations should look.
-
All good, no issues.
-
Canvas is misaligned, combined with a lack of padding.
-
First frame of the animation wasn't selected.
-
Animation speed is wrong and kept at 100.
-
Peppino's clothes are yellow.
-
Sprites are overlapping and animation speed is incorrect, caused by using Ezgif.
-
Animation doesn't loop.
Cropping
Occasionally, when uploading a sprite to the wiki, it may be beneficial to remove the empty space around it. In almost all cases, this padding should be untouched. Some exceptions to this rule are:
- The HUD's TV sprites, as the dimensions of the TV itself never change.
- To increase visibility of the sprite when displayed in a gallery.
In the case of the last exception, it is important to contact a wiki administrator for expressed permission. Upon approval, the suffix "-CROPPED" must be added to the end of the filename.
Video
There are two ways you can easily add videos to the wiki:
- Uploading a video directly to the wiki, useful when posting video recordings originally posted on Discord.
- Embedding a video using tags, useful for showcasing YouTube videos.
Uploading a video directly to the wiki is a very similar process for uploading other files. Go to the file uploading page, and select a video file in a .mp4 format. Make sure to add {{video}} in your summary before uploading. When the upload is completed, you can embed the video like any other file uploaded directly to the wiki.
- Example:
[[File:PizzaTower-TOTW-2018-09-18_19-50-14.mp4|left|300px]]
If your video is already uploaded to YouTube or exceeds the 250MB file size limit, you can use <youtube> to embed the video on a page. Only the video ID is relevant, make sure to remove https://www.youtube.com/watch?v= from the URL, otherwise the video will not embed. To set the width or height of a video, add width or height in between brackets.
- Example:
<youtube width="320" height="180">Wlq6fFOqI28</youtube>