Skip to content

Super Vibecode Expansion and Game Github Crawl/Sync for OpenFront.wiki - #4

Draft
AntiProverb wants to merge 8 commits into
openfrontio:mainfrom
AntiProverb:main
Draft

AntiProverb wants to merge 8 commits into
openfrontio:mainfrom
AntiProverb:main

Conversation

@AntiProverb

@AntiProverb AntiProverb commented Sep 12, 2026

Copy link
Copy Markdown

Title. Rough vibecode draft. Based on my suggestion in the OpenFront Wiki Project Discord.

AI says this:

Summary
This PR expands the OpenFront Wiki into a source-backed, player-focused documentation site that stays synchronized with the live OpenFrontIO codebase.

Documentation and navigation

  • Added a structured documentation architecture with categories for:
  1. Getting Started
  2. Game Database
  3. Advanced Mechanics
  4. Economy & Logistics
  5. Nuclear Systems
  6. Combat & Diplomacy
  7. Maps & Terrain
  8. Development
  9. Esports and community content
  • Added reference hubs for units, buildings, economy, nuclear systems, Doomsday Clock, controls, game settings, maps, combat, team assignment, alliance requests, match statistics, player state, movement, railroads, terrain, and development.
  • Added related-reading links to article pages so readers can move naturally between connected mechanics.
  • Prioritized player-facing Game Wiki content, exploration, and practical guides above technical source/audit material in the sidebar and homepage.

Source-backed accuracy

  • Added pinned OpenFrontIO source references to game articles.
  • Added current source-value tables for costs, construction times, cooldowns, ranges, health, nuclear values, and Doomsday Clock settings.
  • Added an equation reference covering:
  1. Attack stack sizing
  2. Boat attack sizing
  3. Troop capacity
  4. Troop regeneration
  5. Defender-to-attack-stack ratio
  6. Doomsday territory deadlines
  7. Removed stale imported warning boxes, stub labels, and generic factual-accuracy warnings from the player-facing rendered pages.
  • Added a source-tree audit covering game, configuration, schema, client, server, and map-generator files.

Practical player guides (NOT GREAT)

  • Added expanded guides for:
  1. Early game
  2. Attacking effectively
  3. Defense and recovery
  4. Economy and logistics
  5. Nuclear defense
    The guides include worked examples and practical advice based on current game code. In particular, the regeneration guidance verifies that human regeneration generally peaks around 42% of troop capacity, with a practical recovery band around 35–50%.

Map coverage and visuals
Added missing live maps discovered through the OpenFrontIO source audit.
Added previews and descriptions to existing map pages.
Added upstream preview images for newly discovered maps.
Added live map profile charts showing:

  • Default nation count
  • FFA frequency
  • Team frequency
    The automatic refresh process now updates the map catalog and downloads newly added map previews.

Automatic updates

  • Added a scheduled GitHub Action that checks OpenFrontIO hourly.
  • The workflow refreshes:
  1. Pinned source revisions
  2. Current game values
  3. Map metadata
  4. Missing map detection
  5. Source-tree coverage
    -It runs the static build and tests, then opens a reviewable PR instead of deploying unreviewed changes directly.

Validation

  • Static Astro build passes.
  • Focused regression tests pass.
  • Generated routes and map pages were verified.
  • Editor diagnostics are clean.
  • The working tree is clean after publication.

Note
The wiki content remains a combination of source-backed mechanics, community strategy, historical update material, and Liquipedia esports data. Current mechanics are linked to the live source revision, while historical and community content is kept as contextual documentation rather than presented as guaranteed current game behavior.

@AntiProverb
AntiProverb marked this pull request as draft September 12, 2026 05:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant