Difference between revisions of "Offline KI:Age Writer Tutorials"
(techncial documentation page) |
m (move headers one level down) |
||
| Line 1: | Line 1: | ||
This page contains the technical documentation of the Offline KI. For more information and instructions, go back to the [[Offline KI|Offline KI main page]]. | This page contains the technical documentation of the Offline KI. For more information and instructions, go back to the [[Offline KI|Offline KI main page]]. | ||
| − | = Adding ages = | + | ==Adding ages == |
In order to add an age to the Offline KI, you have to add it to the AvailableFanLinks.inf file. That file is loaded by the Offline KI to learn about the ages and what to show in Nexus. The Offline KI will add all ages it does not know to the end of the Nexus list automatically, but of course it doesn't know the real name of the age then (which is usually different from the filename), so it marks them as "unknown age". | In order to add an age to the Offline KI, you have to add it to the AvailableFanLinks.inf file. That file is loaded by the Offline KI to learn about the ages and what to show in Nexus. The Offline KI will add all ages it does not know to the end of the Nexus list automatically, but of course it doesn't know the real name of the age then (which is usually different from the filename), so it marks them as "unknown age". | ||
| Line 13: | Line 13: | ||
'''Important''': If you install the Offline KI using Drizzle, all the changes you do to the configuration files will be overwritten on the next update! | '''Important''': If you install the Offline KI using Drizzle, all the changes you do to the configuration files will be overwritten on the next update! | ||
| − | = Adding a book to the shelf = | + | == Adding a book to the shelf == |
''Note'': If you just want to quickly reach your own age because you are working on it, the best way to do so (even quicker than using the shelf) is to type "/link InternalName" as soon as you arrive on Relto. This will directly bring you to the default link-in-point. Alternatively, use "/linksp InternalName SpawnPointName" to link to a different link-in-point. To automatically link to your age when Uru starts, type "/autolink InternalName". | ''Note'': If you just want to quickly reach your own age because you are working on it, the best way to do so (even quicker than using the shelf) is to type "/link InternalName" as soon as you arrive on Relto. This will directly bring you to the default link-in-point. Alternatively, use "/linksp InternalName SpawnPointName" to link to a different link-in-point. To automatically link to your age when Uru starts, type "/autolink InternalName". | ||
| Line 24: | Line 24: | ||
where "InternalName" is the name of the age file (without .age), and "SpawnPointName" is the name of the spawn point you want to arrive at. If you leave it out, the game will choose the default spawn point. You can add several links to a book by adding several lines to it's section, just make sure each age is also listed in the AvailableFanLinks.inf file. | where "InternalName" is the name of the age file (without .age), and "SpawnPointName" is the name of the spawn point you want to arrive at. If you leave it out, the game will choose the default spawn point. You can add several links to a book by adding several lines to it's section, just make sure each age is also listed in the AvailableFanLinks.inf file. | ||
| − | = Adding a linking panel = | + | == Adding a linking panel == |
The Offline KI looks for linking panels in the following order: For Relto links, it first looks for videos in the "avi" directory: If "InternalName_SpawnPointName.bik" exists, that file is used. The same goes for "InternalName.bik". Only if both of them do not exists, it looks for static linking images - it tries to read "LinkingImage_InternalName_SpawnPointName.jpg" in the "img" directory. If that file does not exist, it tries "LinkingImage_InternalName.jpg" in the same directory. If that file doesn't exist either, it uses the default panel, the black void. In Nexus, it uses the same procedure without taking videos into account and with "LinkInPointDefault" as SpawnPointName. | The Offline KI looks for linking panels in the following order: For Relto links, it first looks for videos in the "avi" directory: If "InternalName_SpawnPointName.bik" exists, that file is used. The same goes for "InternalName.bik". Only if both of them do not exists, it looks for static linking images - it tries to read "LinkingImage_InternalName_SpawnPointName.jpg" in the "img" directory. If that file does not exist, it tries "LinkingImage_InternalName.jpg" in the same directory. If that file doesn't exist either, it uses the default panel, the black void. In Nexus, it uses the same procedure without taking videos into account and with "LinkInPointDefault" as SpawnPointName. | ||
| Line 30: | Line 30: | ||
To create a linking image for your age, first of all you need a screenshot of what it should show. Then use GIMP or a similar application to first crop the image to 1280x814 (or 800x509 or 640x408 or other resolutions with the same aspect ratio) and then scale it to 410x168 pixel - yes, that stretches it. The scaling is not mandatory, the game will do it for you if you don't do it, but panels shown in books usually look better when you do the scaling with proper interpolation. After the picture has the right format, save it with the appropriate name and in jpg format (see above) in the "img" directory - done! | To create a linking image for your age, first of all you need a screenshot of what it should show. Then use GIMP or a similar application to first crop the image to 1280x814 (or 800x509 or 640x408 or other resolutions with the same aspect ratio) and then scale it to 410x168 pixel - yes, that stretches it. The scaling is not mandatory, the game will do it for you if you don't do it, but panels shown in books usually look better when you do the scaling with proper interpolation. After the picture has the right format, save it with the appropriate name and in jpg format (see above) in the "img" directory - done! | ||
| − | = Adding a custom book cover = | + | == Adding a custom book cover == |
For the mapping of the cover in your Relto to be correct, you have to use exactly the right positions of the elements that make up a book: The cover has to have a size of 128x292 pixel, with the top left corner being at 22,105 and the bottom right at 150,397. The full size of the picture always has to be 512x512 pixel, and it has to be saved as jpg file. Of course, it is always a good idea to have a look at other covers and use them as template. Rainforce created the following test cover which shows the parts of the images used for spine and front. It also contains the top and bottom side, which usually is not changed - but you can do so, if you wish. Click the image to enlarge it. | For the mapping of the cover in your Relto to be correct, you have to use exactly the right positions of the elements that make up a book: The cover has to have a size of 128x292 pixel, with the top left corner being at 22,105 and the bottom right at 150,397. The full size of the picture always has to be 512x512 pixel, and it has to be saved as jpg file. Of course, it is always a good idea to have a look at other covers and use them as template. Rainforce created the following test cover which shows the parts of the images used for spine and front. It also contains the top and bottom side, which usually is not changed - but you can do so, if you wish. Click the image to enlarge it. | ||
Revision as of 16:46, 7 April 2012
This page contains the technical documentation of the Offline KI. For more information and instructions, go back to the Offline KI main page.
Contents
Adding ages
In order to add an age to the Offline KI, you have to add it to the AvailableFanLinks.inf file. That file is loaded by the Offline KI to learn about the ages and what to show in Nexus. The Offline KI will add all ages it does not know to the end of the Nexus list automatically, but of course it doesn't know the real name of the age then (which is usually different from the filename), so it marks them as "unknown age".
To add a link to the top of the "Restoration Links" category, add a new line before the first "restorationlink:" definition which looks like this:
restorationlink:InternalName,Display Name
where "InternalName" is the name of the age file (without .age) and "Display Name" is what you want to have displayed in Nexus and the KI. In case you don't want it it be displayed in Nexus, just use "link:" instead of "restorationlink:". Please note that it is generally not necessary to define the spawn point(s) of your age. If you see spawn point definitions in that file, it's because the corresponding age uses more advanced linking features.
Important: If you install the Offline KI using Drizzle, all the changes you do to the configuration files will be overwritten on the next update!
Adding a book to the shelf
Note: If you just want to quickly reach your own age because you are working on it, the best way to do so (even quicker than using the shelf) is to type "/link InternalName" as soon as you arrive on Relto. This will directly bring you to the default link-in-point. Alternatively, use "/linksp InternalName SpawnPointName" to link to a different link-in-point. To automatically link to your age when Uru starts, type "/autolink InternalName".
However, if you really want to add an age to the Relto Shelf, open the ULMServerLinkBook.inf file. You see a bunch of [Book] sections. The books are numbered from 0 to 17, corresponding to the positions on the lower row of your Relto shelf, from left to right. Each section can either define its position, like [Book 4], or automatically use the book to the right of the previously defined one if the number is omitted. Below the section header, you can define the cover of the book and as many pages as you want. The most basic book, offering a single link to a single age, looks like this:
[Book] age:InternalName[,SpawnPointName]
where "InternalName" is the name of the age file (without .age), and "SpawnPointName" is the name of the spawn point you want to arrive at. If you leave it out, the game will choose the default spawn point. You can add several links to a book by adding several lines to it's section, just make sure each age is also listed in the AvailableFanLinks.inf file.
Adding a linking panel
The Offline KI looks for linking panels in the following order: For Relto links, it first looks for videos in the "avi" directory: If "InternalName_SpawnPointName.bik" exists, that file is used. The same goes for "InternalName.bik". Only if both of them do not exists, it looks for static linking images - it tries to read "LinkingImage_InternalName_SpawnPointName.jpg" in the "img" directory. If that file does not exist, it tries "LinkingImage_InternalName.jpg" in the same directory. If that file doesn't exist either, it uses the default panel, the black void. In Nexus, it uses the same procedure without taking videos into account and with "LinkInPointDefault" as SpawnPointName.
To create a linking image for your age, first of all you need a screenshot of what it should show. Then use GIMP or a similar application to first crop the image to 1280x814 (or 800x509 or 640x408 or other resolutions with the same aspect ratio) and then scale it to 410x168 pixel - yes, that stretches it. The scaling is not mandatory, the game will do it for you if you don't do it, but panels shown in books usually look better when you do the scaling with proper interpolation. After the picture has the right format, save it with the appropriate name and in jpg format (see above) in the "img" directory - done!
Adding a custom book cover
For the mapping of the cover in your Relto to be correct, you have to use exactly the right positions of the elements that make up a book: The cover has to have a size of 128x292 pixel, with the top left corner being at 22,105 and the bottom right at 150,397. The full size of the picture always has to be 512x512 pixel, and it has to be saved as jpg file. Of course, it is always a good idea to have a look at other covers and use them as template. Rainforce created the following test cover which shows the parts of the images used for spine and front. It also contains the top and bottom side, which usually is not changed - but you can do so, if you wish. Click the image to enlarge it.
The 4px part they BOTH share is really strange, and don't forget about the fact that the sides of the spine are "leaning" (load this image as cover to see for yourself)
To have a book show your cover, put the following line into the part of the ULMServerLinkBook.inf file which sets your book (the best place is right after "[Book <nr>]"):
cover:MyAgeName
This will load the cover from CoverImage_MyAgeName.jpg.