Secondly, this guide was written as if you knew little/next to nothing about editing a text file/configuring a GreaseMonkey script.
This guide is for 2 kinds of people. The end-user and an Alliance co-ordinator.
End-user - Is the person who just wants to install the script themselves and forget about it there-after, until another alliance is added.
Allliance co-ordinator - Is the person in your alliance who maintains a list of all the alliances you are associated with. Who may also be required to watch other alliance's lists to make sure there are no miscommunications later.
I wont bore you with drivel.. Let's get into configuring the script for you to use.
In this guide I'll be using an example alliance called 'Nublets Ahoy' with an Alliance tag of '-N A-'.
As far as I know there is no such alliance as I pulled the name out of the air.
For the guide we'll also give a few example alliances.. 'Corsairs', with a tag of 'CoR' and 'Paladins Gold', with a tag of '- PG'.
Along with an Enemy Alliance of the name 'Pawners', 'PWNRS'.
And lastly, let's assume this is all on the server s1.ikariam.org
Let's get ready to rumble!
Step 1. Remove GBoz's alliance information already in the script.
Right click on the monkey in the bottom right hand corner of your Firefox window and select 'Manage User Scripts....'.
Should now see a window pop up with a title of 'Manage User Scripts'.
In the list of Scripts, select 'The Corsairs Tools' and click in the lower left part of the window 'Edit'. If you get a window asking you to choose an editor.. Choose your favourite one, OR just use Notepad (if you're on a win*cough*dows system that is). I personally use a reall great developer's one called UltraEdit.
With any luck, you're greeted with your chosen Text editor and it's listing the contents of a file called 'the_corsairs_tools.user.js'.
Scroll down till you see the line
hold shift and scroll down till the lastthe_corsairs_tools.user.js wrote:case 's4.ikariam.org':
Just above the last close curl bracket '}'.the_corsairs_tools.user.js wrote:break;
You should now have highlited all of the existing data. Tap your backspace key.
Step 2. Adding your own infomation.
Ok.. Now click the select all just bellow, and then CTRL+C (On Win/Linux machines) Apple+C on Mac's.
- Code: Select all
default:
alliancefullnm='Some Alliance Name';
alliancenm='SOMEA';
alliance=[
['No Alliance', NoAlliance ],
[alliancenm, Alliance ],
['ALLY', Allies ],
['ENEMY', Enemies ],
];
chaturl='.;
forumurl='.';
forumurlnew='.';
break;
case: 's1.ikariam.org':
alliancefullnm='Some Alliance Name';
alliancenm='SOMEA';
alliance=[
['No Alliance', NoAlliance ],
[alliancenm, Alliance ],
['ALLY', Allies ],
['ENEMY', Enemies ],
];
chaturl='.;
forumurl='.';
forumurlnew='.';
break;
Change to your Text Editor window and Paste, either Right Click, select Paste, or CTRL+V/Apple+V.
Now.. If your server is different from s1.ikariam.org, change the one listed. Also change 'Some Alliance Name' to your alliance's full name and continue with your alliance Tag replacing 'SOMEA'.
alliancefullnm is just used in the Corsair Menu system, the one in the upper right hand corner.
Once you've done that.. You only need to add your alliance(s).
This is the easy bit... Each entry needs to on one line by itself and end in a comma ','
Using the one's suggested above it should end up looking something like
- Code: Select all
case: 's1.ikariam.org':
alliancefullnm='Nublets Ahoy';
alliancenm='-N A-';
alliance=[
['No Alliance', NoAlliance ],
[alliancenm, Alliance ],
['CoR', Allies ],
['- PG', Allies ],
['PWNRS', Enemies ],
];
chaturl='.;
forumurl='.';
forumurlnew='.';
break;
Step 3. Testing it out.
Go back to Firefox and click on 'Show Island'. Should now be shown a new view with allies/enemies in colour'd name box's as well as the owner's name beneath.
If you don't see anything, then likely is you've not closed off a bracket or added a comma in the right place.. in Firefox, click 'Tools' then, 'Error Console' or CTRL+SHIFT+J on Win machines, (unsure what it is on Mac's atm). And scroll down to the end of the list there.. It should tell you which line of which file.. Otherwise it'll say something to the effect of, 'undefined variable' blah.. with blah probably being a typo somewhere in your alliance list.
If you're a End user, you should be set and wont need to add anymore information unless you play on other servers, in which case, just copy/paste the example above changing all the required information.
If you're the Alliance Co-ordinator, then you will only need to upload this single file to webspace somewhere and post in an Alliance Message (possibly ingame) with the URL to the .user.js file. IT is important the filename includes .user.js so it is automaticly redirected to GreaseMonkey scirpt installer.
If you have any questions, feel free to start a new thread asking for some help and, time willing, I'll be able to assist you, or GBoz may before me.
