Skip to main content

Virtual Gamepad (VPad V1 / V2)

For Retro Player systems (NES, SNES, Mega Drive, GBA, PSX, NDS, MAME, etc.), DOSGamePlayer uses a radial gamepad overlay — circular touch controls placed on the left (D-pad) and right (action buttons) edges of the screen. There are two versions:

  • VPad V1 — the original drag-and-drop layout editor based on the Lemuroid engine
  • VPad V2 — a newer presets-based editor with more layout options

Each game can use either; you pick from the Game Detail page.

TODO: VPad V1 and V2 side by side

Open the VPad editor

  1. Open the game's Game Detail page.
  2. Tap Edit VPad.
  3. Choose V1 or V2 at the top of the editor.

VPad V1

The classic editor. Each button is a draggable knob on the screen.

ActionHow
Move a buttonDrag the knob to a new position
Resize a buttonPinch or use the size slider
Change colorTap the button → color picker
Change opacityTap the button → opacity slider
Add a buttonLong-press an empty area
Delete a buttonLong-press the button → confirm

V1 is best when you want full control over every position.

VPad V2

A presets-based editor. The screen is divided into regions and you place clusters of buttons (D-pad cluster, ABXY cluster, shoulder cluster, etc.) into those regions.

ActionHow
Pick a presetTap Preset → choose from the curated list (e.g., NES classic, SNES fighter, PSX dual-stick)
Add a clusterTap a region → add a cluster
Adjust cluster sizeDrag the corner handles
Adjust button gapOpen cluster settings → spacing
Adjust transparencyCluster settings → transparency

V2 is best when you want a clean, balanced layout fast without micro-adjusting every button.

Per-game vs global

By default, every game uses the default VPad for its system (defined globally). The moment you edit and save a layout from a game's Edit VPad screen, that game gets its own copy. Other games are unaffected.

To set the default for all NES games (say), edit it once from any NES game and tap Save as default in the editor.

Hiding the VPad

The VPad shows automatically unless you have a physical gamepad connected. To force-hide:

  • In-Game Menu → Settings → Hide overlay (when available)
  • Or reduce the cluster opacity to 0 in the editor (the touch zones still work, but visually invisible)

Haptic feedback

Each button vibrates by default when tapped. Strength is set in Input Controls.

Tilt input

Some games support tilt as an additional axis. Enable from the in-game core options where available.