Controls & Keybindings

// Movement controls from src/controls.ts:46
commands: {
  movement: {
    forward: ['KeyW'],
    back: ['KeyS'],
    left: ['KeyA'],
    right: ['KeyD'],
    jump: ['Space', 'A'],
    sneak: ['ShiftLeft', 'Down'],
    sprint: ['ControlLeft', 'Left Stick'],
  }
}

// Mouse controls from src/controls.ts:826
addEventListener('mousedown', async (e) => {
  if (!isInRealGameSession()) return
  void pointerLock.requestPointerLock()
  
  // Middle click - pick block
  if (e.button === 1) {
    await selectItem()
  }
})

// Screenshot functionality from src/controls.ts:871
window.addEventListener('keydown', (e) => {
  if (e.code !== 'F2' || e.repeat || !isGameActive(true)) return
  e.preventDefault()
  
  const canvas = document.getElementById('viewer-canvas') as HTMLCanvasElement
  const link = document.createElement('a')
  link.href = canvas.toDataURL('image/png')
  const date = new Date()
  link.download = `screenshot ${date.toLocaleString()}.png`
  link.click()
})

// Raw input support from TECH.md:56
// requestPointerLock({ unadjustedMovement: true }) API
// Disables system mouse acceleration (important for Mac users)

// Keyboard rotation from src/controls.ts:225
const cameraRotationControls = {
  movements: {
    left: { movementX: -0.5, movementY: 0 },
    right: { movementX: 0.5, movementY: 0 },
    up: { movementX: 0, movementY: -0.5 },
    down: { movementX: 0, movementY: 0.5 }
  },
  config: {
    speed: 1, // movement per interval
    interval: 5 // ms between movements
  }
}

// Perspective switching from src/controls.ts:388
case 'general.togglePerspective':
  if (pressed) {
    const currentPerspective = playerState.reactive.perspective
    switch (currentPerspective) {
      case 'first_person':
        playerState.reactive.perspective = 'third_person_back'
        break
      case 'third_person_back':
        playerState.reactive.perspective = 'third_person_front'
        break
      case 'third_person_front':
        playerState.reactive.perspective = 'first_person'
        break
    }
  }
  break

// Gamepad configuration from src/controls.ts:44
commands: {
  movement: {
    forward: ['KeyW'],
    back: ['KeyS'],
    left: ['KeyA'],
    right: ['KeyD'],
    jump: ['Space', 'A'], // Keyboard, Gamepad
    sneak: ['ShiftLeft', 'Down'],
    toggleSneakOrDown: [null, 'Right Stick'],
    sprint: ['ControlLeft', 'Left Stick'],
  },
  general: {
    inventory: ['KeyE', 'X'],
    drop: ['KeyQ', 'B'],
    attackDestroy: [null, 'Right Trigger'],
    interactPlace: [null, 'Left Trigger'],
    nextHotbarSlot: [null, 'Right Bumper'],
    prevHotbarSlot: [null, 'Left Bumper'],
  }
}

// F3 keybinds from src/controls.ts:628
export const f3Keybinds = [
  {
    key: 'KeyA',
    action() {
      // Reload all chunks
      worldView.unloadChunk(/* all chunks */)
      void reloadChunks()
    },
    mobileTitle: 'Reload chunks',
  },
  {
    key: 'KeyG',
    action() {
      options.showChunkBorders = !options.showChunkBorders
    },
    mobileTitle: 'Toggle chunk borders',
  },
  {
    key: 'F4',
    async action() {
      // Cycle through game modes
      let nextGameMode: GameMode
      switch (bot.game.gameMode) {
        case 'creative': nextGameMode = 'survival'; break
        case 'survival': nextGameMode = 'adventure'; break
        case 'adventure': nextGameMode = 'spectator'; break
        case 'spectator': nextGameMode = 'creative'; break
      }
      bot.chat(`/gamemode ${nextGameMode}`)
    },
    mobileTitle: 'Cycle Game Mode'
  },
]

// Keybindings storage from src/controls.ts:35
export const customKeymaps = proxy(appStorage.keybindings)
subscribe(customKeymaps, () => {
  appStorage.keybindings = customKeymaps
})

// Update bindings dynamically
export function updateBinds(commands: any) {
  for (const [group, actions] of Object.entries(commands)) {
    contro.userConfig![group] = Object.fromEntries(
      Object.entries(actions).map(([key, value]) => {
        return [key, {
          keys: value?.keys ?? undefined,
          gamepad: value?.gamepad ?? undefined,
        }]
      })
    )
  }
}

// From TECH.md:58
// navigator.keyboard.getLayoutMap()
// To display the right keyboard symbol for the key keybinding
// on different keyboard layouts (e.g. QWERTY vs AZERTY)

// Flying toggle from src/controls.ts:797
const toggleFly = (newState = !isFlying(), sendAbilities?: boolean) => {
  if (!bot.entity.canFly) return
  
  if (newState) {
    bot._client.write('abilities', { flags: 2 })
    (bot.entity as any).flying = true
  } else {
    bot._client.write('abilities', { flags: 0 })
    (bot.entity as any).flying = false
  }
}

// View all control options
options

// Modify control settings
options.rawInput = true
options.mouseSensitivity = 1.5
options.autoFullscreen = true

// View current controller state
contro.pressedKeys // Currently pressed keys
contro.userConfig // Current keybinding configuration