First Readme
This commit is contained in:
parent
92d4871184
commit
e7dc0c7580
|
@ -0,0 +1,70 @@
|
||||||
|
# Movement
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Getting Started 2D (Quick)
|
||||||
|
|
||||||
|
1. Clone the module to a folder in your Assets folder
|
||||||
|
2. Add `MovementController` component to your Player `GameObject`
|
||||||
|
3. Add `GroundMovement1D` component to your Player `GameObject`
|
||||||
|
4. Connect your inputs to the `MovementController` ([Example with Input System](#input-system-example))
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Getting Started 2D (Longer)
|
||||||
|
|
||||||
|
1. Clone the module to a folder in your Assets folder
|
||||||
|
2. Add `ToggleStateMonoBehaviour` component to your Player `GameObject`
|
||||||
|
3. Add `MovementController` component to your Player `GameObject`
|
||||||
|
4. Add `AirMovement1D` component to your Player `GameObject`
|
||||||
|
5. Add `GroundMovement1D` component to your Player `GameObject` (make sure it's bellow `AirMovement1D`)
|
||||||
|
6. Add a new empty child `GameObject` and add `Box2DColliderTrigger` component to it and place and resize it under the player for ground detection, optionally you can set the `CollisionMask` field on it to make sure it only detects specific layers
|
||||||
|
7. Connect your inputs to the `MovementController` ([Example with Input System](#input-system-example))
|
||||||
|
8. (Optional) Add a jumping script to see the effects better
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
This should give you a movement where you can disable the controller through the `IToggleState`, and you should be able to see a the movement changes when the character is not touching the ground.
|
||||||
|
|
||||||
|
You can add your own movement implementations with bases under the `Bases` folder, or straight up from the `IMovement` interface.
|
||||||
|
|
||||||
|
Or if you want you can write your own `MovementController` with using the `IMovementController` interface, too, but it should be enough for most cases.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Input System Example
|
||||||
|
|
||||||
|
```cs
|
||||||
|
using Syntriax.Modules.Movement;
|
||||||
|
using UnityEngine;
|
||||||
|
using UnityEngine.InputSystem;
|
||||||
|
|
||||||
|
public class MovementInputs : MonoBehaviour, Inputs.IMovementActions
|
||||||
|
{
|
||||||
|
private Inputs inputs = null;
|
||||||
|
|
||||||
|
private IMovementController movementController = null;
|
||||||
|
|
||||||
|
public void OnMovement(InputAction.CallbackContext context) =>
|
||||||
|
movementController.Move(context.ReadValue<Vector2>());
|
||||||
|
|
||||||
|
private void OnEnable()
|
||||||
|
{
|
||||||
|
if (inputs == null)
|
||||||
|
{
|
||||||
|
inputs = new Inputs();
|
||||||
|
inputs.Movement.SetCallbacks(this);
|
||||||
|
}
|
||||||
|
|
||||||
|
movementController =
|
||||||
|
movementController ?? FindObjectOfType<MovementController>();
|
||||||
|
|
||||||
|
inputs.Enable();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnDisable()
|
||||||
|
{
|
||||||
|
inputs.Disable();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
|
@ -0,0 +1,7 @@
|
||||||
|
fileFormatVersion: 2
|
||||||
|
guid: f76e696e0c24ddc438f11868f8c9b855
|
||||||
|
TextScriptImporter:
|
||||||
|
externalObjects: {}
|
||||||
|
userData:
|
||||||
|
assetBundleName:
|
||||||
|
assetBundleVariant:
|
Loading…
Reference in New Issue