Arena 3D SDK
By Malcolm Smith
Open Source
[Important Note!] The only creation that you can currently distribute for Arena 3D are LEVELS. Distributing a modified player file is not allowed. Of course, this will change if and when I support multiple player files.
[Note #1] Note that everything is referenced in this file for the TI-89. For example, extensions are .89z and .89y. If you have a TI-92+ or Voyage 200, use the .9xz and .9xy files from the [bin92p] folder.
[Note #2] To test something in Arena 3D, you must send the following files to your calculator:
a3dgfx1.89y
a3dgfx2.89y
a3dgfx3.89y
arena.89y
arena.89z
fatlib.89y
LEVEL CREATION
You have two options when creating levels. You can either create them on the computer and export them, or create them directly on the calculator.
To create levels on the calculator:
Send a3dedit.89z, a3dedit.89y, and a3dsets.89z to your calculator. If you wish to test levels in the actual game, see Note #2 on what to send to your calculator.
Run arena\a3dedit(). The keys are
displayed in the program, so you shouldn't have many troubles creating a
level. If you don't enter level dimensions, or one is a 0, the program exits.
Just a small note: Each tile is 16x16 pixels. Each tile represents what you
would see if you were looking directly at the wall in a 3D environment, NOT a
top-over view.
Tile Summary:
DM |
![]() [Empty][ChainFence] [Metal] [Crate] [WhiteWall] [Wood] [Office][Office&Pic][Office&Door] |
CTF |
![]() [GrayFlag][WhiteFlag][GrayBase][WhiteBase][Empty][ChainFence] [Metal] [Crate] [WhiteWall] [Wood] [Office][Office&Pic][Office&Door] In CTF, you MUST have the following things in your map:
Design note: You should designate the white base by using light tiles, such as WhiteWall, Metal, and Crate. You should designate the gray base by using dark tiles, such as Office, Office&Pic, and Office&Door. You can designate 'middle areas' by using the Wood or ChainFence tiles. |
Once you save your level, it should work with Arena 3D.
If you want to make a level set, and you've made more than one level, run arena\a3dsets(). It should also be self-explanatory. You enter the number of map sets you want to combine, then the desired final set name, and then you choose the level sets to import. You can even combine a pre-existing multi-level set with a new single level to make a new set.
To create levels on the computer:
This is a bit more complicated than creating levels on the calculator, but it's easier once you get it started.
First, you need to get Tile Studio, a free program. To run Tile Studio, you will need a PC with Windows (any version) with HiColor or TrueColor display (Tile Studio cannot be used with 256-color display). Tile Studio works best on a desktop of at least 1024x768. If you have only 800x600 (or less), be sure to maximize the window when you start (so you also see the Tile Set panel and the status line). Download TS.ZIP (1.7 Mb), unzip it and start SETUP.EXE. To unzip the file, use an extraction program like WinZip.
Install Tile Studio to the default location.
Open the [levels] folder in this SDK.
Run [run1st.bat].
For ease of use, I suggest running [levels\associate.reg] so that double-clicking TSP files will open them in Tile Studio. Just double-click that file, and press OK.
Open [Arena3D.tsp].
Click the
icon to
load the map view.
Then, you can see the TileMap, plus whatever maps that I have created.
To create your own maps, open [User.tsp]
and click the
icon to
load the map view.
Choose File>>New Map (or press Ctrl-M).
SAVE YOUR PROJECT! (Ctrl-S), or File >> Save.
Enter the map name, and the desired dimensions.
Use the tiles at the bottom of the
screen to create your map.
Tile Summary:
DM and CTF |
![]() [ChainFence] [Metal] [Crate] [WhiteWall] [Wood] [Office][Office&Pic][Office&Door][GrayBase][WhiteBase][GrayFlag][WhiteFlag] ---------------------------DM and CTF tiles----------------------------//////////CTF ONLY tiles\\\\\\\\\\ Do not use the tile marked "DO NOT USE". |
CTF Design Info | In CTF, you MUST have the following things in your
map:
Design note: You should designate the white base by using light tiles, such as WhiteWall, Metal, and Crate. You should designate the gray base by using dark tiles, such as Office, Office&Pic, and Office&Door. You can designate 'middle areas' by using the Wood or ChainFence tiles. |
(Repeat steps 10-12 as necessary, to make as many maps as you want.)
Choose Code>>Generate Code (or press F10).
SAVE YOUR PROJECT! (Ctrl-S), or File >> Save.
Close Tile Studio.
Run [a3dlvlmake.exe]. If you are building off of the Arena3D project, the filename is 'data.txt'.
Enter the name of the data text
file. It must follow the following format:
output_filename.bin
Title for Map #1
Author for Map #1
Game Mode for Map #1
Background for Map #1
Title for Map #2
Author for Map #2
Game Mode for Map #1
Background for Map #2
etc.
'Background' is based on [src/bg.txt]. To use a background, type the
appropriate string without quotes. For example, typing
BlackFloor_DarkGraySky
will choose that background. These strings also correspond to the background
filenames in [GFX/1/bg] if you wish to preview. The upper half of the image
will appear as a sky while the lower half will appear as a floor.
For an example, see data.txt. The '.bin' must remain.
Your level files should then be created, and moved up to the TI-89 and TI-92+ bin directories.
----
To convert from calculator files:
Receive a map pack to the PC.
Run tools/ttstrip.exe on it, to make an .ALEV file.
Example:
ttstrip a3dmaps.89y a3dmaps.alev
Run alev2ts.exe, and type the file name (without .alev).
Create a new map in Tile Studio.
Choose Map>>Import Map, 8-bit 1 based, and choose the file.
Switch to another map and switch back.
PLAYER CREATION
Not yet applicable.