punkfuncgames/input-module

InputModule Reference

Package: com.punkfuncgames.input | Define: PUNKFUNC_INPUT Location: Packages/com.punkfuncgames.input/Runtime/PunkFuncGames.Input/ Namespace: PunkFuncGames.Input

IInputService

Continuous Inputs (ReactiveProperty):

• ReadOnlyReactiveProperty<Vector2> Movement — WASD / Left Stick
• ReadOnlyReactiveProperty<Vector2> Look — Mouse delta / Right Stick
• ReadOnlyReactiveProperty<Vector2> MousePosition — Screen space
• ReadOnlyReactiveProperty<bool> IsPrimaryHeld — LMB / Gamepad A held
• ReadOnlyReactiveProperty<bool> IsSecondaryHeld — RMB / Gamepad B held

Event Observables:

• Observable<Unit> OnPrimaryAction — Primary pressed
• Observable<Unit> OnSecondaryAction — Secondary pressed
• Observable<Unit> OnInteract — Interact pressed
• Observable<Unit> OnPause — Pause pressed (always fires, ignores enabled state)
• Observable<Unit> OnCancel — Cancel pressed (UI map)

Control:

• bool IsEnabled / SetEnabled(bool) — globally enable/disable (resets values when disabled)
• string CurrentActionMap / SwitchActionMap(string) — switch "Player" or "UI" maps
• Vibrate(float lowFreq, float highFreq, float duration) — gamepad haptics with auto-reset

Implementation: InputService

Constructor dependency: InputActionAsset (required, throws if null)

• Finds "Player" and "UI" action maps from asset
• Subscribes to: Move, Look, PrimaryAction, SecondaryAction, Interact, Pause (Player map) + Cancel (UI map)
• Mouse position tracked via Observable.EveryUpdate()
• Pause always fires regardless of IsEnabled state
• All subscriptions use CompositeDisposable for cleanup

Installer

InputInstaller.Install(builder, inputActionAsset);
// Registers: InputService (Singleton) as IInputService, with InputActionAsset parameter

Usage Pattern

public sealed class PlayerMovement : ITickable, IDisposable
{
    private readonly IInputService _input;
    private readonly CompositeDisposable _disposables = new();

    public PlayerMovement(IInputService input) => _input = input;

    public void Tick()
    {
        Vector2 move = _input.Movement.CurrentValue;
        // Apply movement...
    }
}

// Subscribe to events
_input.OnPrimaryAction
    .Subscribe(_ => Attack())
    .AddTo(_disposables);

_input.OnPause
    .Subscribe(_ => _gameState.ChangeState(GameState.Paused))
    .AddTo(_disposables);

// Switch to UI input during menus
_input.SwitchActionMap("UI");