Skip to content

About

Web Interface for Conquer v4 https://github.com/vejeta/conquer

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Conquer Web

Conquer is a multiplayer strategy game from Usenet, 1987: a fantasy world, nations, armies, one turn at a time. Conquer Web runs it in a Docker container, shows its terminal in the browser (ttyd) behind Apache with HTTPS, and adds what a public server needs: a home page with the live game state, a practice game that runs in the visitor's browser, player accounts with requests approved by the administrator, turn updates on a schedule, seasons with a hall of fame, backups and notifications.

Play now

Server What is there
conquer.vejeta.com The live game, run by the author of this project: a shared world with scheduled turns. Try it with no account (a practice world in your browser); to join, ask for your seat on the home page and the administrator approves it. In English, Spanish, German, Portuguese, Polish, Russian and Chinese.

Running your own server? Open a pull request to add it here.

Conquer trailer: Usenet, 1987, a strategy game of epic fantasy Found your nation: the game's own nation builder Your first turn: the main screen of your kingdom
Trailer
40 seconds: what Conquer is
Found your nation
the game's own builder, step by step
Your first turn
the narrated tutorial

The videos are narrated in all seven languages, with captions: the site plays each visitor's own (web/tutorial/<video>.<language>.mp4, made by tools/tutorial/video.py).

How a player joins

  1. Ask for a seat on the home page (I want to play, /signup.html): an account name and a password (no email is asked, none is kept). With an invite code from the administrator the seat is approved at once.
  2. Wait for the administrator, who approves the request at /admin/.
  3. Press Play now and sign in with that account: the terminal menu has the game's nation builder found your nation (at any turn).
  4. Play: option 1 of the menu, then your nation password. Your orders are resolved at the next turn update (the home page shows the schedule in your own time zone).
  5. Learn at any time: the practice world at /try/ (no account), the tutorial, the Coach button above the game and the player's guide (/guide.html).

Quick start (local)

For development, on your own machine (Docker and docker-compose; Apache runs in a container, with a self-signed certificate):

./setup-environment.sh     # choose 1, Local development
./start-local.sh           # https://conquer.local (accept the certificate warning)

The administrator's web account is made from TTYD_USERNAME/TTYD_PASSWORD in config/local.env on the first start. Then ./logs.sh, ./health-check.sh, ./rebuild.sh --quick (after changing config/local.env) and ./stop.sh manage it, and ./manage-players.sh, ./run-turn.sh and ./add-nation.sh work as on a server.

Administrator's guide

Running a public server (Debian VPS with Apache and Docker):

  • DEPLOYMENT.md is the runbook: first install, updates, every setting, the Apache virtual host, email notifications, players and requests, seasons, backups, the god password and troubleshooting.
  • QUICK-REFERENCE.md is one screen of the commands an administrator types every day.
  • Who is an administrator: only an account marked * in data/lib/.players, set on the server with sudo ./manage-players.sh assign NAME --admin (or add NAME --admin), or at /admin/ by an existing administrator. sudo ./manage-players.sh list shows them. Visiting a page never makes anyone one.
  • SECURITY.md covers hardening (fail2ban, rate limits, headers).

Donations

Conquer is a hobby project and the game is free, with no ads. If you want to help pay for the servers you can give through Liberapay: liberapay.com/Conquer. The site shows a small "Support the servers" link in the footers of the home page and the Hall (never inside the Android app). The address lives in one place, DONATE_URL in web/site.js; to change it edit that line (and this section). Donations are voluntary and give nothing in return; Liberapay is a separate controller for its own data and we receive no payment data.

Design system

Every page takes its colours, fonts and spacing from one stylesheet, web/theme.css: green phosphor over the mountains, with a phosphor per race (data-race on <html>: human, elf, dwarf, orc, chosen in the game's options or read from the nation's own screen by web/race.js) and parchment (data-theme="parchment") for the long reading pages. web/design.html is the living style guide (linked from every footer as "Design"): open it to see every component. The game screen's frames are raster artefacts baked by python3 tools/arch/bake.py from the shapes in tools/arch/src; the map texture at the page edges comes from python3 tools/hero/build-bg.py. Pages add layout only, never colours: a browser test fails on any colour literal in a page.

Documentation

Where What
DEPLOYMENT.md, QUICK-REFERENCE.md, SECURITY.md Running a server
/guide.html on the site (web/guide.html) The player's guide: history, workflow, advice, tournament formats
tests/README.md The tests and how CI runs them
web/i18n/README.md, conquer/i18n/README.md Adding a language (pages, terminal menu)
tools/tutorial/README.md, tools/hero/README.md The tutorial and videos; the home page map
wasm/README.md The practice game in WebAssembly
conquer/patches/README.md Fixes applied to the game engine at build time

Project layout

conquer/       game image: Dockerfile, engine patches, default world, menu and turn scripts, sign-up service (gate), translations
web/           the site: home page, guide, tutorial, sign-up, /admin/, game page, /try/ (WebAssembly)
vps/           Apache virtual host template and systemd unit for a VPS
apache/        Apache container of the local setup
config/        environment templates (production.env, local.env, backup.env)
tools/ wasm/   tutorial and video builders, check-i18n.py, WebAssembly build
tests/         pytest suites (see tests/README.md)
*.sh           administration scripts (see QUICK-REFERENCE.md)
data/          live world, accounts, backups and practice worlds (created at run time, not in git)

Contributing

Fork, make a branch, run the checks, open a pull request:

shellcheck -S warning -x -P conquer/scripts ./*.sh conquer/scripts/*.sh conquer/i18n/*.sh
python3 tools/check-i18n.py
python3 -m pytest -m "not browser and not game"

License

GPL v3 or later; see LICENSE.md. The game is Conquer, with thanks to ttyd, Docker and Let's Encrypt.

About

Web Interface for Conquer v4 https://github.com/vejeta/conquer

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages