MonoGame.InputManager

KO | EN

gitlite — search

#ai #typescript #llm #go #android #linux #docker #nodejs #java #awesome #cli #awesome-list #mcp #open-source

MonoGame.InputManager

(★ 21)

An easy-to-use input manager for MonoGame

MonoGame.InputManager 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MonoGame-InputManager
An easy-to-use inputmanager for MonoGame

___                   _   __  __                                   
	|_ _|_ __  _ __  _   _| |_|  \/  | __ _ _ __   __ _  __ _  ___ _ __ 
	 | || '_ \| '_ \| | | | __| |\/| |/ _` | '_ \ / _` |/ _` |/ _ \ '__|
	 | || | | | |_) | |_| | |_| |  | | (_| | | | | (_| | (_| |  __/ |   
	|___|_| |_| .__/ \__,_|\__|_|  |_|\__,_|_| |_|\__,_|\__, |\___|_|   
		  |_|                                       |___/           
          
		      _=====_                               _=====_
	             / _____ \                             / _____ \
		   +.-'_____'-.---------------------------.-'_____'-.+
		  /   |     |  '.           _           .'  |  _  |   \
		 / ___| /|\ |___ \       ,'" "',       / ___| (_) |___ \
		/ |      '      | ;      | A1r |      ; | _         _ | ;
		| | <--     --> | |  __  '.___.'  __  | |(_)       (_)| |
		| |___   .   ___| ; |__|         |__> ; |___   _   ___| ;
		|\    | \|/ |    /  _              _   \    | (_) |    /|
		| \   |_____|  .','" "',        ,'" "', '.  |_____|  .' |
		|  '-.______.-' /       \      /       \  '-._____.-'   |
		|               |       |------|       |                |
		|              /\       /      \       /\               |
		|             /  '.___.'        '.___.'  \              |
		|            /                            \             |
		 \          /                              \           /
		  \________/                                \_________/

- [Goals](#goals)
- [Install](#install)
- [Methods](#goals)
- [Usage](#usage)
- [More Info](#moreinfo)
- [Local Multiplayer](#localmp)
- [Handling player selection](#selectmp)
- [Porting](#porting)
- [Enums](#enums)

## <a name="goals">Goals

- Controller first inputmanager
- Customization options
- Easy to port
- Seamless multiplayer

## <a name="install">Install
1. Copy `InputManager.cs` into your MonoGame project
2. ????
3. PROFIT!

## <a name="methods">Methods

**General methods**  
These methods are also used for mapped keyboards or a mapped mouse.

bool IsPressed(Input input)
	bool IsPressed(Input input, int index)
    bool IsHeld(Input input)
    bool IsHeld(Input input, int index)
    bool JustPressed(Input input)
	bool JustPressed(Input input, int index)
	bool JustReleased(Input input)
	bool JustReleased(Input input, int index)
	bool SomethingDown()
	bool SomethingDown(int index)
    float GetRaw(Input input)
	float GetRaw(Input input, int index)
    bool SetGamepadVibration(int index, float left, float right)
    GamePadCapabilities GetCapabilities(int index)
    void AddKeyboardPlayer(Dictionary<Input, Keys> map)
    void AddMousePlayer(Dictionary<Input, MouseInput> map)    
    bool AllPlayersConnected()
    int GetPlayerCount()
    void SetUsablePlayers(int[] playerIds)
    
**Gamepad methods**

bool IsPressed(Buttons button)
    bool IsHeld(Buttons button)
    bool JustPressed(Buttons button)
    bool JustReleased(Buttons button)

**Keyboard methods**

bool IsPressed(Keys key)
    bool IsHeld(Keys key)
    bool JustPressed(Keys key)
    bool JustReleased(Keys key)
    
**Mouse methods**

bool IsPressed(MouseInput input)
    bool IsHeld(MouseInput input)
    bool JustPressed(MouseInput input)
    bool JustReleased(MouseInput input)
    Point GetMousePosition()
    int GetMouseScroll()
 
**MonoGameComponent**

public void Update()

## <a name="props">Properties

**States**  
These properties can be used for getting the raw values from the MonoGame states

KeyboardState currentKeyboardState;
    KeyboardState previousKeyboardState;
    MouseState currentMouseState;
    MouseState previousMouseState;

**Deadzones**

![Axial deadzone](http://www.third-helix.com/images/2013/04/axial-deadzone.jpg)

float DeadzoneSticks = 0.25f;
    float DeadzoneTriggers = 0.25f;

Inputmanager will try to find connected controllers based on this variable.

int PlayerCount = 1;

## <a name="usage">Usage

// MonoGame class
    public class Peace : Game
    {
        InputManager iM;

public Peace()
        {
            // Construct a new inputmanager to use it in the Update function.
            iM = new InputManager(this);
        }

protected override void Initialize()
        {
            // Register GameComponent or call `iM.Update(gameTime)` in the Game's Update function
            this.Components.Add(iM);
        }

protected override void Update(GameTime gameTime)
        {
            // Setting up the right values
            var acceleration = 1.337f;
            var pos = new Vector2(x, y);
            // Check for an Input and handle it accordingly
            if (iM.IsPressed(Input.Home))
                Exit();
				
            // Accelerate based on user input
            if (iM.IsPressed(Input.Right))
                pos.X += acceleration;
				
            if (iM.IsPressed(Input.Left))
                pos.X -= acceleration;
				
            if (iM.IsPressed(Input.Up))
                pos.Y -= acceleration;
				
            if (iM.IsPressed(Input.Down))
                pos.Y += acceleration;
        }
    }

## <a name="moreinfo">More info

### <a name="localmp">Local Multiplayer

To implement multiple keyboard/controller players you can do something like this:

public class Peace : Game
    {
        // Simple player with actions
        struct myPlayer
        {
            public Input Run;
            public Input Jump;
        }
        myPlayer[] myPlayerArray;

// In multiplayer initialisation code
        public Peace()
        {
        	iM = new InputManager(this)
        	{
        		PlayerCount = 2
        	};
        	// Set up an simple player array with remappable input actions.
        	myPlayerArray = new myPlayer[]
        	{
        		new myPlayer() { Run = Input.FaceButtonLeft, Jump = Input.FaceButtonDown }
        		new myPlayer() { Run = Input.FaceButtonLeft, Jump = Input.FaceButtonDown }
        	};
        
        }
        // In Update code
        protected override void Update(GameTime gameTime)
        {
        	// Check if the number of available players has changed. You can handle it your way.
        	if (!iM.AllPlayersConnected())
                // Please connect controller

for (int i = 0; i < myPlayerArray.Length; i++)
            {
                var player = myPlayerArray[i];
                if (iM.IsPressed(player.Run, i))
                    // Let the player run
        			
                if (iM.IsPressed(player.Jump, i))
                    // Let the player jump
            }
        }
	}

### <a name="selectmp">Handling player selection

public class Peace : Game
    {
        Input JoinGame = Input.FaceButtonDown;
        Input LeaveGame = Input.FaceButtonRight;
        Input StartGame = Input.Start;
        List<int> activePlayerIds;
        // In multiplayer initialisation code
        public Peace()
        {
        	iM = new InputManager(this)
        	{
        		PlayerCount = 8 // Max joinable players
        	};
            activePlayerIds = new List<int>();
        }
        // In Update code
        protected override void Update(GameTime gameTime)
        {
            var count = iM.GetPlayerCount();
            bool start = false;
            for (int i = 0; i < count; i++)
            {
                if (activePlayerIds.Contains(i))
                {
                    if (iM.IsPressed(LeaveGame, i))
                        activePlayerIds.RemoveAll(id => id == i);
                    else if (iM.IsPressed(StartGame, i))
                        start = true;
                }
                else if (iM.IsPressed(JoinGame, i))
                    activePlayerIds.Add(i);

}
            if (start)
            {
                iM.SetActivePlayers(activePlayerIds);
                var playerCount = iM.GetPlayerCount();
                // Do something with player count
            }
        }
	}

## <a name="porting">Porting
If you plan to write an controller first game you may end up supporting other platforms.
To add keyboard or mouse support

iM.AddKeyboardPlayer(new Dictionary<Input, Keys>
    {
        { Input.Up, Keys.Up },
        { Input.Left, Keys.Left },
        { Input.Right, Keys.Right },
        { Input.Down, Keys.Down },
        { Input.Back, Keys.Space }
    });
    iM.AddMousePlayer(new Dictionary<Input, MouseInput>
    {
        { Input.Up, MouseInput.Button2 },
        { Input.Left, MouseInput.LeftButton },
        { Input.Right, MouseInput.RightButton },
        { Input.Down, MouseInput.Button1 },
        { Input.Back, MouseInput.MiddleButton }
    });

## <a name="enums">Enums

**For Gamepads**

Use the `Microsoft.Xna.Framework.Input.Buttons` or the more generic `Input` enum to identify which action has been pressed

enum Input
    {
        // Center
        Home,
        Start,
        Back,
        // D-Pad
        Up,
        Left,
        Down,
        Right,
        // Face buttons
        FaceButtonUp,
        FaceButtonLeft,
        FaceButtonDown,
        FaceButtonRight,
        // Shoulder buttons
        LeftShoulder,
        RightShoulder,
        // Triggers
        LeftTrigger,
        RightTrigger,
        // Left Stick
        LeftStick,
        LeftStickUp,
        LeftStickLeft,
        LeftStickDown,
        LeftStickRight,
        // Right Stick
        RightStick,
        RightStickUp,
        RightStickLeft,
        RightStickDown,
        RightStickRight
    }

**For Keyboard**

Use the `Microsoft.Xna.Framework.Input.Keys` enum to identify which action has been pressed

**For Mouse**

Use the `MouseInput` enum to identify which action has been pressed

public enum MouseInput
    {
        None,
        LeftButton,
        MiddleButton,
        RightButton,
        Button1,
        Button2
    }

## Types of configurations

- Singleplayer PC
- Singleplayer cross-platform
- Multiplayer cross-platform

# TODO

- Remove keyboardstates (&& mouse) if platform != Computer (just a simple boolean)
- [More deadzone options](http://www.third-helix.com/2013/04/12/doing-thumbstick-dead-zones-right.html)

# Licence

MIT
--

MonoGame.InputManager

MonoGame.InputManager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

MonoGame.InputManager

MonoGame.InputManager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README