WARNING: this repo is not maintained anymore. the new IkaEasy (v3) moved to a private repo.

In this version, all the extension code is completely rewritten, from the extension core to each function separately. Many bugs of the old version are fixed, HUD and UI improved, some new features were added IkaEasy v3 is available at a new address.

IkaEasy

Extension stable on version 0.6.2.

IkaEasy - extension for chrome browser that add many useful features to ikariam. Make your ikariam really easier!

Quick start
Community
Features
Supported languages
Structure
Adding new script
How it works
How script works
Adding script
Adding images
Adding translation
Copyright and license
Building & minifying

Quick start

If you're using chrome - install extension and enjoy!

Community

Keep track of development and community news.

Like our Facebook page.
Follow us on VK.com.

Features:

Building levels (green circle - enough resources to update, red - not enough. When mouseover - how much resources you need to upgare)
City levels and there action points (on island)
Alliance and score of player right on the island
Movements tabs in military advisor (you can choose what type of movements you want too see)
Movements arrival date in military advisor
Movements pictures of units (without clicking on search icon) in military advisor
Highlighing movement when mouseover
Making links and images active in diplomacy advisor
Sending message with Ctrl+enter
Alliance members tab in diplomacy advisor
Intergration with ikalogs (save battle log. Much easier publish your battle with it)
Gold per hour (on all screens)
Resources per hour (on all screens)
How much days left with wine
Send half\all units
"Transport" button moved upper in port
Marker (can mark cities of another alliances with other color)

Supported languages:

Croatian
English
German
Hebrew (modern)
Polish
Russian
Turkish

Structure:

Main files and folders:

IkaEasy/
├── css/
│   └── ikaeasy.css
├── icon/
├── images/
├── inner/
│   └── ikaeasy.js
├── langs/
├── page/
│   ├── __common.js
│   ├── attack.js
│   ├── city.js
│   ├── diplomacyAdvisor.js
│   ├── finances.js
│   ├── generalAttacksToAlly.js
│   ├── island.js
│   ├── militaryAdvisor.js
│   ├── militaryAdvisorReportView.js
│   ├── options.js
│   ├── pirateFortess.js
│   ├── resource.js
│   ├── sendIKMessage.js
│   ├── tavern.js
│   ├── topLists.js
│   ├── townHall.js
│   ├── transport.js
│   └── units.js
└── zJS/
│   ├── db.js
│   ├── lng.js
│   ├── navigation.js
│   ├── utils.js
│   ├── var.js
├── background.js
├── hotkeysPlugin.js
├── ikalogs.js
├── init.js
├── jquery.min.js
├── json.js
└── manifest.json

Adding new script

Create new file with custom name in directory page.

Default script template:

    if (typeof zJS == "undefined") {
        zJS = {};
    }

    if (typeof zJS.Page == "undefined") {
        zJS.Page = {};
    }

    zJS.Page.TEMPLATE_ID = {
        dont_refresh : false,

        init : function() {

        },

        refresh : function() {

        }
    };

zJS.Page.TEMPLATE_ID - instead TEMPLATE_ID - value of variable ikariam.templateView.id or ikariam.backgroundView.id. When this variables changes - script will be executed.

And finally add this file to manifest.json, to the end of the long line.

How it works

All scripts, that must be executed on pages are located in directory page.

Script __common.js executing on all pages.

All other pages call by changes values of ikariam.templateView.id or ikariam.backgroundView.id.

How script works

Value dont_refresh define if script must be reinitialize when page refreshed (by ikariam).

Function init calling when page execute.

Function refresh by refreshing pages (e.g city change, or by timeout).

Adding script

When adding (deleting, moving, renaming) script files, you must update information about it in manifest.json

Adding images

When adding (deleting, moving, renaming) images in directory image, you must update information about it in manifest.json

Adding translation

Files for internationalization are located here. To add a new language, create a new file in that directory.

The language has to be referenced in the /zJS/lng.js file and /manifest.json file to be picked up.

Note: The name of the file should be the two-letters ISO-639-1 language code.

Building and minifying

master is the main folder where all the file sources in readable view. dist is the folder after minifying & concating. The content of this folder goes to releasing updated in chrome web store.

Use grunt to minify, concat & etc (already configured. Just use grunt command in the root of the project).

vltansky / IkaEasy

readme