Repository navigation
EN Index By Symptom
Français · Index · Generated from the published pages
- A CI job failed on my pull request → CI explained
- A connector is down: what happens to the game? → Bridge and connector troubleshooting
- An object is visible but the hero cannot reach it → Something is visible but unreachable
- An update does not show → Player troubleshooting
- Can I roll back my game to an earlier version? → Sub-path, cache and service worker, incomplete deploys, going back
- Cannot find package 'playwright' when I run doctor → Install troubleshooting
- doctor fails in a created project → Install troubleshooting
- doctor says something is missing on my machine → doctor: checking your machine
- How do I cut a generated sprite sheet into images? → Images: prompts, cutting sheets, transparency, scale
- How do I get the image prompts for my game? → Images: prompts, cutting sheets, transparency, scale
- I get a 423 error in the hosted Studio → Write refused on the hosted Studio: span locked (423)
- I get a 503 on Clever Cloud → Clever Cloud troubleshooting
- My changes are not answered yet, are they lost? → Recovering after a lost lease, a disconnection or a stale preview
- My character stops before reaching an object → Something is visible but unreachable
- My edit was refused with 422 in the Studio → Studio troubleshooting
- My game works locally but not under a sub-path → Sub-path, cache and service worker, incomplete deploys, going back
- My lease ran out and someone took my room → Recovering after a lost lease, a disconnection or a stale preview
- My new image does not show in the game → Images: prompts, cutting sheets, transparency, scale
- My save will not load → Player troubleshooting
- npm install answers 404 for quest-n-click → Install troubleshooting
- npm run doctor reports a missing tool → doctor: checking your machine
- Players still see the old version after I deployed → Sub-path, cache and service worker, incomplete deploys, going back
- Safari does not keep the session cookie → Clever Cloud troubleshooting
- Screenshot unavailable: Playwright is not installed → Studio troubleshooting
- Tapping a thing does nothing → Something is visible but unreachable
- The Bridge answers 409 → Bridge and connector troubleshooting
- The Bridge answers 503 → Bridge and connector troubleshooting
- The Bridge received the same event twice → Bridge and connector troubleshooting
- The daily backup did not run → Clever Cloud troubleshooting
- The game is incomplete offline → Player troubleshooting
- The game was updated but I still see the old version → Player troubleshooting
- The Studio answers 403 cross-origin Studio request refused → Studio troubleshooting
- The Studio says Reconnecting, what do I do? → Recovering after a lost lease, a disconnection or a stale preview
- The Studio says Studio token required (401) → Studio troubleshooting
- The Studio says the file changed since I read it → Write refused on the hosted Studio: stale base revision (409)
- The worker refuses jobs with 403 the job has expired → Clever Cloud troubleshooting
- The worker, PostgreSQL or Cellar is down → Worker, PostgreSQL or Cellar down
- There is no sound in the game → Player troubleshooting
- Undo is refused: the file changed since → Studio troubleshooting
- What does doctor check? → doctor: checking your machine
- What does the full-ci label do? → CI explained
- What happens to the Studio when the worker is down? → Worker, PostgreSQL or Cellar down
- What happens when Cellar is unreachable? → Worker, PostgreSQL or Cellar down
- Which background colour should my sprite sheets use? → Images: prompts, cutting sheets, transparency, scale
- Why did a CI job say not needed by the plan? → CI explained
- Why does the game view show an older revision? → Recovering after a lost lease, a disconnection or a stale preview
- Why is my save refused with 409? → Write refused on the hosted Studio: stale base revision (409)
- Why is my save refused with 423? → Write refused on the hosted Studio: span locked (423)
Generated publication · publication générée — current documentation · documentation courante: quest'n'click 4.5.3 r1, documentation revision · révision de la documentation b061c4ae6fbeb0be47a11ba8a442ba7e23ecb0a1.
Latest documentation · dernière documentation: https://quest-n-click.cleverapps.io/docs · https://quest-n-click.cleverapps.io/fr/docs; earlier versions · versions précédentes: each release's quest-n-click-docs-<version>.tar.gz · l'archive quest-n-click-docs-<version>.tar.gz de chaque release, https://github.com/Quest-n-Click/quest-n-click/releases
An edit made in this wiki is overwritten at the next publication · une modification faite dans ce wiki est écrasée à la publication suivante.
Edit the source · Modifier la source · Report an error · Signaler une erreur
Index (6)
Start (6)
Play (9)
Install (18)
- Requirements
- Install from the release archive
- Install from npm
- Install from the repository to work on the engine
- doctor: checking your machine
- Image toolchain
- Audio toolchain: ffmpeg, fluidsynth, Furnace, uv
- Upgrade
- Upgrade notes: 4.5
- Upgrade notes: 4.4
- Upgrade notes: 4.3
- Upgrade notes: 4.2
- Upgrade notes: 4.1
- Upgrade notes: v3
- Upgrade notes: v2 to v3
- Coming from web-scumm
- Package reference
- Install troubleshooting
Create a game (55)
- Your first game
- Layout of a created project and of the engine repository
- The working loop
- Content principles and the identity contract
- Rooms
- Geometry: placement, walk zones, masks, layers, camera
- Something is visible but unreachable
- Reactions
- Game commands
- Conditions
- Flags, variables and events: which to use
- Custom code
- Characters
- Items and inventory
- World map
- Dialogues
- Scripts and events
- Moving characters: patrols and walks
- Exits
- Chapters and objectives
- State and saves: persistent or temporary, renaming an id, migrations
- Staging: wide rooms and animations
- The stage: lights, particles, floors
- Skin and fonts
- Title and credits
- Heroes: several characters and hero choice
- Built-in minigames
- A custom minigame
- Translations
- Music in stems
- Sound effects
- Voices: per language and per hero
- Images: prompts, cutting sheets, transparency, scale
- Asset provenance
- The storyboard, source of truth
- Puzzle design
- Classic mechanics
- Review pages
- DSL reference
- Checking your game
- What the solver proves
- Solver options
- Playtests
- Remix
- Speedrun for authors
- The sealed ending
- Production template
- Example games
- Working with an AI
- Build and release a game
- Publish on GitHub Pages
- The static game on Clever Cloud
- Other static hosts
- Sub-path, cache and service worker, incomplete deploys, going back
- Testing on a phone over the LAN
Local Studio (24)
- The local Studio: overview and launch
- Edit a room
- Placement and stage
- Preview, apply, undo
- Storyboard
- Assets and cutting
- Check: validator, solver, critical path, heat, health, coverage
- Before and after captures
- Semantic diff
- Play and replay a session
- Rule explainer
- Language and objectives
- Voices and the heroes × languages matrix
- Map
- Notes
- Remix in the Studio
- Music
- The Assistant: bring your own key
- Demo mode and studio-apply
- Local and LAN security
- Studio API
- Local MCP: setting up each client
- MCP tools
- Studio troubleshooting
Team Studio (21)
- What runs where
- Concepts: revision, transaction, span, lease, preview, build
- Starting as an invited dev
- Working together day to day
- Roles and actions: the full matrix
- Invitations
- Managing members
- Write refused on the hosted Studio: stale base revision (409)
- Write refused on the hosted Studio: span locked (423)
- Recovering after a lost lease, a disconnection or a stale preview
- Comments
- Map and semantic diff
- Publishing builds
- Remote MCP
- The game in Git
- Upgrading the engine of a hosted game
- Hosted assets
- The server's command line
- Health and metrics routes
- Trying it locally with compose.yml
- Known limits
Clever Cloud (23)
- Clever Cloud: overview, cost and prerequisites
- Apps and add-ons
- Domains and TLS
- Keycloak
- Generic OIDC and GitLab
- Configuration
- First deployment
- Backups
- RPO and RTO
- Restore the Studio on a fresh installation
- Redeploys
- Upgrading the server and checking state after a migration
- Limits of going back
- Monitoring
- Security
- Rotating keys
- Recovering admin access
- Changing domain or OIDC provider
- Worker, PostgreSQL or Cellar down
- Exporting the game and leaving the installation
- Retention
- Clever Cloud troubleshooting
- Costs and teardown
Reality Bridge and connectors (16)
- The Reality Bridge: what it is
- Quick start
- Guarantees
- Install and run the Bridge
- Backup and restore
- Several tenants
- Signals and the manifest
- The Bridge's command line
- Connectors overview
- Email connector
- Telnet connector
- SSH connector
- Open Badges connector
- The connector SDK
- Security: Biscuit and signatures
- Bridge and connector troubleshooting
Contribute (25)
- Welcome
- Developer setup
- The dev loop
- Before a pull request
- Conventions
- Writing documentation
- Architecture
- Code tour
- Import boundaries
- Which tests run when
- Mutation testing
- The coverage ratchet
- The quality baseline
- CI explained
- Field passes
- Benchmarks
- Releasing
- npm packages
- Decisions and ADRs
- Governance
- Bot pull requests
- Contributing with AI agents
- Security policy
- Code of conduct
- Licences and credits