Reference: Client Archives

EarthEternal.car

Contains all client scripting, which performs all client/server interaction, defines and display UI elements and panels, visual effect scripts, handles user input, etc. Also contains some core image resources.

All scripts are written and compiled using the Squirrel scripting language.

Refer to http://www.squirrel-lang.org/ for downloading the compiler or language reference. Squirrel version 2.x stable appears to work correctly with the game. Squirrel 3.x has not been tested. Also note that Squirrel Standard Libraries are an extra component to Squirrel, and don't appear to have been enabled in the client. You can test them to be sure, but don't be surprised if the code doesn't work.

Notable files in this archive:

Connection.nut : Most client/server information handling.

InputCommands.nut : Defines custom /commands and what they do. If a command is not handled by this class, it is sent to the server as a generic query.

Globals.nut & Constants.nut & ServerConstants.nut : Contains some global variables and tables. Some of the data in these tables have been coded into the server. If any of these globals are modified in the server then the corresponding globals in the client should be updated to match, and vice versa.

Catalogs.car

Contains several global resource lists.

Notable Files in this archive:

Abilities.cnut : A table of all abilities. The client uses this table for all information present in the ability screen. Also controls how abilities are performed client side (casting time, visual effects, etc). All changes made to this file should be reflected in the server, and vice versa. See AbilityTable.txt for the server-side ability list.

AssetDependencies.cnut : Associates CAR assets with a list of other CAR resources that must be loaded first. This allows decorative scenery to be re-used in other collective types like CL, Dng, or similar components.

Attachable.cnut : Defines character attachable entities and optionally maps to the archive that contains them. Attachables include helmets, weapons, etc. This is distinct from clothing, which conforms to the underlying model.

Clothing.cnut : Defines a list of clothing assets that may be used to decorate player models.

Components.cnut : A list of all prop objects, associating prop names with the media archives that that contain them. New props will need to be added to this list before they can be placed. Note that each component must have a corresponding .csm.xml file within the CAR archive.

Creatures.cnut : A list of all creature models.

Media.cnut : A list of all CAR files. The associated file sizes aren't really important. The Download All feature will include all files in this archive, plus some from TerrainPages.cnut.

MediaExpectations.cnut : Version 0.8.9 (Ikimonogatari/EER) only. Contains checksums for each CAR asset. If the downloaded CAR does not match the checksum in this list, the client will fail with a checksum error. This file can be safely deleted to avoid download problems.

TerrainPages.cnut : Defines a list of terrain page files that exist for loading.

Catalogs.car Extensions

Planet Forever mods use additional script files ending with the Ex suffix to merge additional entries into their respective catalogs without having to disassemble or compile the original lists. This helps portability between client versions.

AssetDependenciesEx.cnut
CreaturesEx.cnut
MediaEx.cnut
AttachableEx.cnut
ComponentsEx.cnut

Effects.car

Contains particle effects and their associated graphics and Ogre engine scripts.

Environments.car

Contains environment skybox effects and their associated scripts and graphics. Scripts help define lighting and music tracks for particular environments.