recanalyst/recanalyst

Analyzes Age of Empires 2 recorded game files.

Thursday, October 12, 2017
by goto-bus-stop
Repository
11 Watchers
26 Stars
97 Installations

PHP
0 Dependents
0 Suggesters
8 Forks
25 Open issues
20 Versions
8 % Grown

The README.md

RecAnalyst

, _(*1)

RecAnalyst is a PHP package for analyzing Age of Empires II recorded games., _(*2)

It supports recorded game files from:, _(*3)

The Age of Kings
The Conquerors
UserPatch
Forgotten Empires
HD Editions (optionally with expansions)

And reads data such as:, _(*4)

Game settings
Players
Chat messages
Research and Age Advancing times
Map data (terrain, elevation)
Initial units
Achievements (UserPatch only)
Tributes

License - Credits - Contributing - Requirements - Installation - Configuration - Usage Examples - API Documentation - Limitations, _(*5)

$rec = new \RecAnalyst\RecordedGame('recorded_game.mgx2');
$rec->mapImage()->save('minimap.png');
foreach ($rec->players() as $player) {
    printf("%s (%s)", $player->name, $player->civName());
}

License

GPL-3. See COPYING., _(*6)

Credits

Originally forked from Biegleux's work:
v2.1.0 © 2007-2010 biegleux <biegleux@gmail.com>
Original project homepage
Original project documentation, _(*7)

Contributing

RecAnalyst is looking for contributors. Please see the Issues List for bugs or missing features and help implement them by opening a PR!, _(*9)

RecAnalyst is an OPEN Open Source Project:, _(*10)

Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project., _(*11)

See the Contributing Guide for more., _(*12)

Requirements

RecAnalyst works with PHP 5.6+ and PHP 7. The Imagick or GD extensions need to be installed to generate map images., _(*13)

Installation

With Composer:, _(*14)

composer require recanalyst/recanalyst

Configuration

RecAnalyst ships with translations and image files for researches and civilizations., _(*15)

If you're using RecAnalyst with Laravel, scroll down to learn about Laravel integration., _(*16)

RecAnalyst contains a basic Translator class for standalone use. By default, RecAnalyst uses the English language files from Age of Empires II: HD Edition., _(*17)

RecAnalyst contains icons for civilizations, units and researches in the resources/images folder. If you're using RecAnalyst standalone, and want to use the icons, you can copy that folder into your own project. You can then refer to the different categories of icons in the following ways:, _(*18)

Category	URL
Civilizations	`'/path/to/resources/images/civs/'.$colorId.'/'.$civId.'.png'`
Researches	`'/path/to/resources/images/researches/'.$researchId.'.png'`

Laravel

Add the RecAnalyst service provider to your config/app.php:, _(*19)

'providers' => [
    RecAnalyst\Laravel\ServiceProvider::class,
],

RecAnalyst will automatically pick up the appropriate translations for your Laravel app configuration., _(*20)

To copy the civilization and research icons to your public folder:, _(*21)

php artisan vendor:publish --tag=public

You can then refer to the different categories of icons in the following ways:, _(*22)

Category	URL
Civilizations	`public_path('vendor/recanalyst/civs/'.$colorId.'/'.$civId.'.png')`
Researches	`public_path('vendor/recanalyst/researches/'.$researchId.'.png')`

API Documentation

To get started, the Usage Examples might be helpful., _(*23)

Full API documentation is available at https://goto-bus-stop.github.io/recanalyst/doc/v4.2.0., _(*24)

Limitations

These are some things to take into account when writing your own applications with RecAnalyst:, _(*25)

Achievements data is only available in multiplayer UserPatch 1.4 (.mgz) games. It isn't saved in single player recordings nor in any other game version.
RecAnalyst cannot be used to find the state of the recorded game at any point except the very start. This is because AoC stores a list of actions, so to reconstruct the game state at a given point, the game has to be simulated exactly. See #1.
Rarely, Age of Empires fails to save Resign actions just before the end of the game. In those cases, RecAnalyst cannot determine the resignTime property for players. See #35.

The Versions

12/10 2017

dev-feature/actions

dev-feature/actions http://idlebeaver.ninja/recanalyst

Analyzes Age of Empires 2 recorded game files.

library recanalyst

Analyzes Age of Empires 2 recorded game files.

recanalyst/recanalyst

The README.md

RecAnalyst

License

Credits

Contributing

Requirements

Installation

Configuration

Laravel

API Documentation

Limitations

The Versions

dev-feature/actions

The Requires

The Development Requires

by biegleux

by Idle Beaver

dev-master

The Requires

The Development Requires

by biegleux

by Idle Beaver

dev-feature/up15

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.2.0

The Requires

The Development Requires

by biegleux

by Idle Beaver

dev-feature/rise-of-the-rajas

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.1.3

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.1.2

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.1.1

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.1.0

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.0.4

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.0.3

The Requires

The Development Requires

by biegleux

by Idle Beaver

4.0.2

The Requires

The Development Requires

by biegleux

by Idle Beaver

dev-feature/4.8

The Requires

The Development Requires

by biegleux

by Idle Beaver