OGame is a browser-based, money-management and space-war themed massively multiplayer online browser game with over two million accounts.
This lib is supposed to help write scripts and bots for your needs.
it supports ogame_version: 7.2.1
version 13
pip install ogame
update
pip uninstall ogame pip install ogame
dont want to wait for new updates download direct from the develop branch
pip install git+https://github.com/alaingilbert/pyogame.git@develop
from ogame import OGame from ogame.constants import destination, coordinates, ships, mission, speed, buildings, status empire = OGame(UNI, USER, PASSWORD) #optional empire = OGame(UNI, USER, PASSWORD, user_agent='NCSA_Mosaic/2.0 (Windows 3.1)', proxy='https://proxy.com:port')
Want to use it with tor?
This is a command that will try to run all functions with parameters. I suggest creating your own testing model. empire.test()
empire.attacked() returns bool
empire.neutral() returns bool
empire.speed() returns class empire.speed().universe empire.speed().fleet
empire.planet_ids() returns list
empire.id_by_planet_name('name') returns int
empire.planet_names() returns list
empire.moon_ids() returns list empire.moon_names() returns list **keep in mind to prefer planets id's moon id dont works on every function**
coordinates have the format [galaxy, system, position, destination]
destination is referred to planet moon or debris on that coordinate planet=1 debris=2 moon=3
for example [1,200,16,3] = galaxy=1, system=200, position=16, destination=3 for moon
with from ogame.constants import destination the process is much more readable.
when you dont give it an destination it will default to planet
returns list
from ogame.constants import coordinates, destination
pos = coordinates(galaxy=1,
system=2,
position=12,
dest=destination.debris)
coordinates(1, 2, 12, destination.moon)
coordinates(1, 2, 12, destination.debris)
coordinates(1, 2, 12, destination.planet) or coordinates(1, 2, 12)works with planet's and moon's
empire.celestial_coordinates(id) returns list
resources have the format [metal, crystal, deuterium] darkmatter & energy are irrelevant, because you cant transport these. It is used for transport and market functions from ogame.constants import resources res = resources(metal=1, crystal=2, deuterium=3) [1, 2, 3]
empire.resources(id) returns class(object) res = empire.resources(id) res.resources returns resources res.day_production returns resources res.darkmatter returns int res.energy returns int res.metal returns int res.crystal returns int res.deuterium returns int
empire.supply(id) returns class(object) sup = empire.supply(id) sup.metal_mine.level returns int sup.metal_mine.is_possible returns bool (possible to build) sup.metal_mine.in_construction returns bool sup.metal_mine.cost returns resources sup.crystal_mine sup.deuterium_mine sup.solar_plant sup.fusion_plant sup.metal_storage sup.crystal_storage sup.deuterium_storage returns class(object)
empire.facilities(id) returns class(object) fac = empire.facilities(id) fac.robotics_factory.level returns int fac.robotics_factory.is_possible returns bool (possible to build) fac.robotics_factory.in_construction returns bool fac.robotics_factory.cost returns resources fac.shipyard fac.research_laboratory fac.alliance_depot fac.missile_silo fac.nanite_factory fac.terraformer fac.repair_dock
empire.moon_facilities(id) returns class(object) fac = empire.moon_facilities(id) fac.robotics_factory.level returns int fac.robotics_factory.is_possible returns bool (possible to build) fac.robotics_factory.in_construction returns bool fac.robotics_factory.cost returns resources fac.shipyard fac.moon_base fac.sensor_phalanx fac.jump_gate
Use this function to get all offerings from the market. resourses will be returned in the resourse's format ships will be returned in the ship's format
for bid in empire.marketplace(id, page_nr):
if bid.is_ships:
print(bid.id, bid.offer, bid.price)
print(ships.ship_name(bid.offer), ships.ship_amount(bid.offer))
if bid.is_resources:
print(bid.id, bid.offer, bid.price)
print(bid.is_possible)
>>>1234 (204, '508', 'shipyard') [0, '1500000', 0]
>>>light_fighter 508
>>>True
>>>1235 ['10000000', 0, 0] [0, '8000000', 0]
>>>Falseempire.buy_marketplace(bid.id, id) returns bool
you can sell resources and ships. Note that you can sell one ship or one resources at at time. run a for loop if you wanna stack offerings. If the Market accepts your offer depends on your price and availability on your id_planet range cant be 0
empire.submit_marketplace(offer,
price,
id,
range) returns bool
empire.submit_marketplace(offer=resources(metal=100),
price=resources(crystal=50),
id=id,
range=10)
empire.submit_marketplace(offer=ships.large_transporter(10),
price=resources(crystal=96000),
id=id,
range=10)
it will collect all your orders at once that are not collected yet buy & sell orders
empire.collect_marketplace() returns None (Ogame doesnt return a json return message anymore)
empire.traider(id) returns Exception("function not implemented yet PLS contribute")
empire.research() returns class(object) res = empire.research() res.energy res.laser res.ion res.hyperspace res.plasma res.combustion_drive res.impulse_drive res.hyperspace_drive res.espionage res.computer res.astrophysics res.research_network res.graviton res.weapons res.shielding res.armor
empire.ships(id) returns class(object) shi = empire.ships(id) shi.light_fighter shi.heavy_fighter shi.cruiser shi.battleship shi.interceptor shi.bomber shi.destroyer shi.deathstar shi.reaper shi.explorer shi.small_transporter shi.large_transporter shi.colonyShip shi.recycler shi.espionage_probe shi.solarSatellite shi.crawler
empire.defences(id) returns class(object) def = empire.defences(id) def.rocket_launcher def.laser_cannon_light def.laser_cannon_heavy def.gauss_cannon def.ion_cannon def.plasma_cannon def.shield_dome_small def.shield_dome_large def.missile_interceptor def.missile_interplanetary
empire.galaxy(coordinates) returns list of class(object)
for planet in empire.galaxy(coordinates(randint(1,6), randint(1,499))):
print(planet.list)
print(planet.name, planet.position, planet.player, planet.player_id, planet.status, planet.moon)
if status.inactive in planet.status:
#Farm Inactiveempire.ally() returns string
empire.officers() returns Exception("function not implemented yet PLS contribute")
empire.shop() returns Exception("function not implemented yet PLS contribute")
empire.fleet() returns list of class(object)
for fleet in empire.fleet():
if fleet.mission == mission.expedition:
print(fleet.list)
print(fleet.id, fleet.mission, fleet.returns, fleet.arrival, fleet.origin, fleet.destination)empire.phalanx(coordinates, id) returns list of class(object)
for fleet in empire.phalanx(moon_id, coordinates(2, 410, 7)):
if fleet.mission == mission.expedition:
print(fleet.list)
print(fleet.id, fleet.mission, fleet.returns, fleet.arrival, fleet.origin, fleet.destination)empire.spyreports() returns list of class(object)
for spyreport in empire.spyreports():
print(spyreport.id, spyreport.time, spyreport.coordinates,
spyreport.resources, spyreport.technology, spyreport.list)
# you need to check bacause somtimes spymissions fail
if buildings.metal_mine in spyreports.technology:
print(spyreport.technology[buildings.metal_mine])from ogame.constants import coordinates, ships, mission, speed
empire.send_fleet(mission=mission.expedition,
id=id,
where=coordinates(1, 12, 16),
ships=[ships.small_transporter(1), ships.bomber(1)],
resources=[0, 0, 0], # optional default no resources
speed=speed.max, # optional default speed.max
holdingtime=2) # optional default 0 will be needed by expeditions
returns bool
empire.send_message(player_id, msg) returns bool
Buildings
from ogame.constants import buildings
empire.build(what=buildings.alliance_depot,
id=id)
buildings.metal_mine
buildings.crystal_mine
buildings.deuterium_mine
buildings.solar_plant
buildings.fusion_plant
buildings.solar_satellite(int)
buildings.crawler(int)
buildings.metal_storage
buildings.crystal_storage
buildings.deuterium_storage
buildings.robotics_factory
buildings.shipyard
buildings.research_laboratory
buildings.alliance_depot
buildings.missile_silo
buildings.nanite_factory
buildings.terraformer
buildings.repair_dock
empire.build(what=buildings.rocket_launcher(10),
id=id)
buildings.rocket_launcher(int)
buildings.laser_cannon_light(int)
buildings.laser_cannon_heavy(int)
buildings.gauss_cannon(int)
buildings.ion_cannon(int)
buildings.plasma_cannon(int)
buildings.shield_dome_small(int)
buildings.shield_dome_large(int)
buildings.missile_interceptor(int)
buildings.missile_interplanetary(int)
buildings.moon_base
buildings.sensor_phalanx
buildings.jump_gateShips
from ogame.constants import ships
empire.build(what=ships.bomber(10),
id=id)
ships.light_fighter(int)
ships.heavy_fighter(int)
ships.cruiser(int)
ships.battleship(int)
ships.interceptor(int)
ships.bomber(int)
ships.destroyer(int)
ships.deathstar(int)
ships.reaper(int)
ships.explorer(int)
ships.small_transporter(int)
ships.large_transporter(int)
ships.colonyShip(int)
ships.recycler(int)
ships.espionage_probe(int)
returns None
from ogame.constants import research
empire.do_research(research=research.energy, id=id)
research.energy
research.laser
research.ion
research.hyperspace
research.plasma
research.combustion_drive
research.impulse_drive
research.hyperspace_drive
research.espionage
research.computer
research.astrophysics
research.research_network
research.graviton
research.weapons
research.shielding
research.armor
returns None
this will collect your rubble field at the planet id.
empire.collect_rubble_field(id) returns None
empire.is_logged_in() returns Bool
empire.relogin() returns Bool
switch universes with the same login
empire.relogin('UNI')
empire.logout() returns Bool