A3DGE 1.0

Introduction

The Amateur 3D Game Engine is a simple 3D game
engine written in Object Pascal.

This version is based in the original engine I wrote for my 2nd PGD CHallenge

back in 2012. Such engine was written in about one single week and was pretty
buggy because the hurry and also because Allegro.pas 5 was in a very early
development state in that moment.

The engine goal is to be simpler than other engines. That means that it wonn't
capable of some advanced stuff and would lack some tools but in return it is
very easy to learn and use. BTW current version is an early release and
there are plans to add a few more stuff in the future. So it will never beat
Unreal Engine but I hope it will became a nice engine to create games easily.

If you're looking for a full fledged 3D game engine written in Object Pascal you
should try the Castle Game Engine.

License

A3DGE is released under zlib/png license. Read it in file LICENSE.txt.

Installation

Before to start using A3DGE you'll need two things:

• The Allegro library.
• A Pascal compiler.
• Optionally but quite recommended if you're not using Delphi, the Lazarus IDE.

Allegro library

On Linux operating systems, just install package liballegro5-dev. That should
do the trick.

On Windows (and also Linux if you want) go to the Allegro's downloading page and follow their explanations.

Pascal compiler and IDE

A3DGE has been designed to be used with the FreePascal compiler although I'm trying to make it work with Delphi too but right now I can't
guarantee that it is compatible right now.

I recommend you to install Lazarus IDE as it
includes FPC. It's included in most Linux repositories, and you can download it
for both Windows and Linux from its download page.

Compile examples and tool

Using Lazarus IDE

There are project files for tools and examples. Just open them with Lazarus and
compile. They're configured for Debug but there are also a Release mode.

From console

First execute fix.cmd on Windows or fix.sh on Linux and follow on-screen
instructions. Then execute make on both Windows and Linux.

You can change the makefile to change between Debug and Release modes.

How to use

You have detailed documentation of the engine at docs/engine/ directory.

Note that A3DGE is Allegro based so know how it works will help a lot.

Contact information

The project page is at http://sf.net/p/a3dge/.

Also I (and other) visit these forums quite often:

Pascal Game Development (AKA "PGD")
PGD Telegram Chat
Lazarus games

If you're a Discord user, here you have a couple of servers:
- Athena's pad (channel about game developing with Delphi):
https://discordapp.com/channels/568517662271864852/
- Unnoficial Free Pascal:
https://discordapp.com/channels/570025060312547359/