Graal Update Packages!

[petro1212]

GUPD's, Graal Update Packadges

Since no one posted any "FAQ" about them before and little playerworlds are using them I decided to type up a small guide so that people/servers will use them more oftenly.

What are gupd's?
gupd's are basicly packadges containing info needed to automaticly run updates and/or show updates in the Graalv4 "Update" tab.

Every time a Graalv4 client logs onto any given server it will check if the file basepack.gupd excists on the server and attempt to run it.

You can edit/create gupd files with any kind of word/text editor. Best would be to automaticly assign them to the editor of your choice for fast editing.

Be sure to add file *.gupd to your server's folder configurations. You could also put it in a more private folder to prevent other staff from editing them.

gupd file example:

GRPKG001
NAME Graal Packages
VERSION 1.00
PLATFORM any
SUBPACKAGE basepackage_win.gupd
SUBPACKAGE basepackage_linux.gupd
SUBPACKAGE basepackage_mac.gupd
USECHECKSUM false
PROTECTOVERWRITE true
FLAG popupforoptionalpackages=false

This gupd file can be found in your Graal game folder within the subfolder updatepackages

Most of the actions inside of the gupd are pretty easy to understand;
NAME, will display the name of the packadge. Giving the "basepack" the name of your server would be wise I guess, since it will show up ontop of the "tree" in the update tab.

PLATFORM, will allow you to limit files for a certain system. Possible flags; any,win,linux,mac

VERSION, Increase this number wich each update you make to a specific package. This way players can see if the package has been update, they can click "Update" if a packadge version is diffrent from the one they downloaded before.

SUBPACKAGE, list the files you wish to be added into the tree. You can use this to split up your gupd files instead of making one "huge" file containing everything that needs to be updated. (Not a great way of putting it =P)

Item description, example:

DESCRIPTION
Welcome to the download menu!
Choose a package on the left side of
the screen and then click on "Download".
DESCRIPTIONEND

MODE ,available package modes: base - updates are checked at each login (can be slow if it contains many files), required - updates are checked if the local version differs, optional - only downloaded if the user downloads it, we will improve this soon though to display a special window where it tells you about optional updates (like new RCs)

FLAG popupforoptionalpackages=false/true, Putting this in a optional pack (When the MODE isn't set to required) will create a popup where the player can choose to download it. Cancel/Ok

FILE FOLDERNAME+FILENAME, these are basicly the files that the packadge downloads. You are required to list the exact location on your server.
e.g FILE levels/images/block.png
Do every "FILE ..." on a new line
The files are put in the same folder as on your server. It might be wise to use nicely arranged foldernames containing your server name; e.g levels/Npulse/images/ ect
But than again that is totaly up to you, also try to prefix your server files (See "Lance's sticky post")

PS: Note that that there are functions that I did not list thats either because
1) I'm not 100% sure of their function
2) I'm not aware of these functions

Also note that I am not an expert just a goofball trying to get people to use gupd's more extensively. Imagine a server like unholy nation having a optional update for the heads that where added for Each Month (wow... that would save us some ingame lag now)