/** Voir description des fonctions côté PHP **/
//////////////////////////// BASE fonctions : //////////////////////////////////
/** @return array('M','C','D','NRJ'), default is 0 */
function ogame_arrayRessource($metal, $cristal, $deut, $NRJ = 0);
function ogame_getElementNames();
function ogame_isElement(nom);
function ogame_findPlanetPosition(coordinates);
function ogame_findCoordinates(string_coord);   /** return array('g','s','p') of int, default is 0 */

////////////////////////// PRODUCTION fonctions : //////////////////////////////
function ogame_productionPosition(position);
function ogame_productionForeuseMax(mine_M, mine_C, mine_D, user_data);
function ogame_productionForeuseBonus(user_building, user_data); /** return array('bonus','nb_FOR_maxed') bonus=foreuse bonus coefficient ; nb_FOR_maxed=limit nb if too much */
/** @brief Calculates building/sat/for or base production and consumption.
 *  
 *  @param[in] string $building        The wanted building/sat/for ('base','M','C','D','CES','CEF','SAT','FOR')
 *  @param[in] array  $user_building   Planet info ('M','C','D','CES','CEF','SAT','FOR','temperature_max','coordinates') 0 as default value
 *  @param[in] array  $user_technology Techno info ('NRJ') 0 as default value
 *  @param[in] array  $user_data       User info for FOR only (array('user_class'=>'COL'/...,'off_geologue' or 'off_full')
 *  @param[in] array  $server_config   Ogame universe info ('speed_uni',(bool)'final_calcul') / final_calcul permet de déterminer si les valeurs retournées seront manipulées avec les % de production ressources, et donc sans arrondi.
 *  @return array('M','C','D','NRJ') of production
*/
function ogame_productionBuilding(building, user_building=null, user_technology=null, user_data=null, server_config=null);
/** @brief Calculates planet production and consumption.
 *  
 *  @param[in] array $user_building   Planet info ('M','C','D','CES','CEF','SAT','FOR','temperature_max','coordinates','M_percentage','C_percentage','D_percentage','CES_percentage','CEF_percentage','Sat_percentage','FOR_percentage',array 'booster_tab') 0 as default value
 *  @param[in] array $user_technology Techno info ('NRJ','Plasma') 
 *  @param[in] array $user_data       User info ('user_class'=>'COL'/...,'off_commandant','off_amiral','off_ingenieur','off_geologue', or 'off_full')
 *  @param[in] array $server_config   Ogame universe info ('speed_uni')
 *  @return array('prod_reel, // (array ress) Production réel en prenant en compte le ratio (M/C/D ressources, NRJ prod moins la conso)
 *      'prod_theorique',     // (array ress) Producton théorique M/C/D (ratio=1, 100%)
 *      'ratio',              // (float) le ratio de production NRJ (prod_E / conso_E)
 *      'conso_E','prod_E',   // (float) Production NRJ prod_E > 0, conso_E < 0
 *      'prod_CES','prod_CEF','prod_SAT', // (array ress) production énergie de chaque unité ('D' de prod_CEF contient la conso en deut de la CEF)
 *      'prod_FOR',           // (array ress) production M/C/D et conso NRJ
 *      'prod_M','prod_C','prod_D','prod_base', // (array ress) Production ressources de chaque mine (M/C/D) et leur conso (NRJ)
 *      'prod_booster','prod_off','prod_Plasma','prod_classe',   // (array ress) Production des bonus
 *      'M','C','D','NRJ', =>héritage du type ressource pour les valeurs retournées.
 *      'nb_FOR_maxed',       // (int) Nombre max de foreuse utilisées
 *      ) à part ratio/conso_E/prod_E (float) les autres sont array('M','C','D','NRJ')
 */
function ogame_productionPlanet(user_building, user_technology=null, user_data=null, server_config=null);

//////////////////////////// FLOTTE fonctions : ////////////////////////////////
/** return array('vitesse','fret','conso',(bool)'civil') */
function ogame_arraySubDetail(vitesse=0, fret=0, conso=0, civil=true);
/** @brief Return fleet moving details of Ogame vso.
 *  @param[in] string name The name as in Database, all for all element
 *  @return array('vitesse','fret','conso',(bool)'civil')
 */
function ogame_fleetSubDetailsBase(name = 'all');
/** @brief Calculates technical data of a fleet or defence.
 *  @return array('nom','vitesse','fret','conso',(bool)'civil') of the wanted fleet.
 */
function ogame_fleetSubDetails(name, user_techno = null, classe = 'none');
function ogame_fleetConsoStatio(conso, hour);
function ogame_fleetSlowestSpeed(fleet, user_techno=null, classe='none');
function ogame_fleetDistance(a, b, user_techno=null, classe='none', server_config=null);
function ogame_fleetSend(coord_from, coord_to, fleet, speed_per=100, user_techno=null, classe='none', server_config=null, type='', hour_mission=0);

//////////////////////////// COUT fonctions : //////////////////////////////////
function ogame_elementCoutBase(name = 'all');