author nemo
Thu, 27 Jan 2022 17:26:11 -0500
changeset 2219 12e5f8732e54
parent 2151 b558e7ded9ba
permissions -rw-r--r--
latest on 1.0.0 branch is better

#summary A short guide explaing graves and how to create and use them

= Graves =

== Explanation of graves ==
Graves are small images which appear when a hedgehog dies. Graves are chosen on a per-team basis. A grave can be either be unanimated or animated. Animated graves can consist of up to 16 frames.

== Creating graves ==
=== Unanimated graves ===
To create an unanimated grave, draw a PNG image of size 32×32 pixels. You _can_ use semi-transparency.

=== Animated grave ===
An animated grave can have 2, 4, 8 or 16 frames.
To create an animated grave, first you have to draw one image per frame, 32×32 pixels in size.

Those images have to be combined to a single image. The width of the final image is alwas 32 pixels, the height is _n_ · 32 pixels, where _n_ is the number of frames (single image in animation) you chose.
To combine: The first image is placed at the top, the next image is placed 32 pixels below that, the next one 64 pixels, and so on.

Each of these sub-images is a frame in the final grave animation. It starts with the topmost image, continues with the image below, and so on. After the last sub-image, the animation repeats with the first frame. Each frame lasts for 128 milliseconds.

The first image will be also the one which is shown in the team creation menu as preview. The grave will only be animated in the game.

== Installing graves ==
To install a grave, put it into `Data/Graphics/Graves` of the Hedgewars data directory.
Make sure the name of your file ends with “`.png”. The displayed name in Hedgewars equals the file name without the suffix.

== Official graves ==
A list of official graves can be seen [ here].

== Sharing graves ==
Custom graves (graves which are not part of the official Hedgewars installation) are only visible to other players if they have the grave installed under the same file name.

In case the other player does not have the custom grave installed, the player will see the default grave (`Statue.png`) instead.

You are encouraged to share your graves in the thread “[ Graves! additions, submissions, information.]”, where submissions are considered for official inclusion into Hedgewars.