Guild of Writers

Latest revision as of 19:38, 27 May 2020

A Shell if an individual component of the Age of Ahra Pahts. To setup a Shell, read the tutorial on getting started.

Submitting a Shell

Once your Shell is ready, you can submit it to be integrated into Ahra Pahts.

Conventions

Your Shell must respect all these conventions:

• All objects in your Shell are on your Shell's page. For example, if your Shell number is 111, then each object should have the following property: string page_num = 111.
• Nothing in your Shell can be over 60 feet (or Blender units) tall.
• All geometry objects are named beginning with either sXXX or XXX, where XXX is your 3-digit Shell/Page number. For example, the name of an object in Shell 111 would begin with s111 or 111.
• All materials and meshes are named beginning with either sXXX or XXX.
• All texture files are named beginning with either sXXX or XXX.
• All colliders, regions, softvolumes, soundemitters, seekpoints, etc. are named beginning with either sXXX or XXX.
• All objects are within the bounds of your Shell walls (the walls are on the layer 4 of your Shell's Blend file).
• All Python script files are named beginning with sXXX, and all classes within the scripts are named beginning with sXXX.
  • If you have any global variables, declare them within a Python file named sXXXGlobals.py. This will put them in the sXXXGlobals namespace.
  • If your Python classes are subclasses of ptModifier, then set self.id equal to 189XXXN, where N is a number from 0 to 9 - this depends on how many ptModifier subclasses you have.
• All objects defined using AlcScript are named beginning with either sXXX or XXX.
• All sound objects are named beginning with either sXXX or XXX (the ability to rename sound objects might become available in the near future).
• All sound files are distributed in .ogg format and named beginning with "pahts", the 3 digit shell number, an underscore, and a name, e.g. pahts111_ambient.ogg.

Submission

Once you're certain your Shell meets all the requirements, follow these steps to submit it:

• Export and test your shell.
• Put the following files into a directory named after your shell:
  • the Pahts_District_sxxx.prp file,
  • all compiled Python files (e.g. sxxx*.pyc),
  • any SDL files,
  • any OGG files.
• Zip up the directory, then submit them to Robert The Rebuilder or Aloys.

Sign Up Table

If you want to start editing your very own Shell, find an empty and unreserved Shell and follow the instructions in the Getting Started guide.

Static Pages

Some Shells contain scene objects (e.g. wavesets, linking points) that cannot be dynamically loaded. Consequently, those objects must be placed in a Page that is loaded at the start upon linking into the Age. If you need one of these static pages, add your name to the table below. Then follow these instructions to create a static Page.