Community userscript: Auto Expedition for Tampermonkey

[ssps6210]

Hi! I built a Tampermonkey userscript that automatically fills expedition slots on any OGameX server — thought the community might find it useful.

Repo: https://github.com/ssps6210/ogamex-auto-expedition

What it does

• Checks expedition slots every 30 minutes via /fleet
• Automatically sends fleets to position 16 for every open slot
• Handles CSRF token refresh from each API response so it stays valid through long sessions
• Small overlay widget (bottom-right) with live slot count, countdown timer, and ON/OFF toggle — no page reload needed

How it works under the hood

It uses two existing OGameX endpoints:

• GET /fleet — parses expedition slot counts from the rendered HTML
• POST /ajax/fleet/dispatch/send-fleet — sends the fleet with mission: 15 (expedition)

No modifications to the server are needed — it runs entirely in the browser via Tampermonkey/Greasemonkey.

Question for @lanedirt

Would you be open to a userscripts/ or community-tools/ folder in the repo, or a "Community Tools" section in the README that links to scripts like this? Happy to open a PR if that fits the project direction.

Also flagging one thing I noticed while building this: the /fleet page does not currently expose expedition slot counts as JSON — they are only available by parsing the rendered HTML. If an /api/fleet/slots or similar endpoint ever gets added, scripts like this would be much more robust. Happy to open a separate issue for that if useful.

Thanks for building OGameX — great project! 🚀

[cest-pas-faux]

"Hey guys, claude wrote a cheat for me, though I'd like to share it in the official game repo"

[ssps6210]

Fair enough. Just wanted to share it openly and discuss openly. Happy to remove it if the team decides it's not appropriate for the repo.

[lanedirt]

Hi @ssps6210,

Thanks for sharing this. Community tools or modules won’t be included of the official repo itself, but there is already a related projects section in the README with links to projects related to OGameX.

I’m generally fine with automation scripts since people can do what they want on their own/private servers. For the public cloud-hosted main/release servers though, this kind of automation is a bit more questionable from a gameplay perspective.

Let's keep this discussion open for a bit and see what the broader community feedback is around linking automation tools like this in the OGameX related projects section.

[ssps6210]

Thanks for the thoughtful response @lanedirt! Totally understand keeping it out of the main repo. A spot in the Related Projects section would be great if the community is on board.

Regarding the public server concern — fair point. The script does respect the existing API limits and slot caps, so it's more of a convenience tool than an unfair advantage, but I understand if that's still not ideal for competitive play.

The reason I shared it openly rather than keeping it to myself is that I genuinely wanted it to be useful to other players. The motivation behind it is simple — repeatedly clicking through the same fleet dispatch actions drains player enthusiasm over time, and I think reducing that friction helps people enjoy the game more.

Happy to wait for community feedback!