Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prime31/CharacterController2D
https://github.com/prime31/CharacterController2D
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/prime31/CharacterController2D
- Owner: prime31
- Created: 2013-10-31T21:09:03.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-09-21T00:26:03.000Z (over 4 years ago)
- Last Synced: 2024-01-17T10:56:55.514Z (5 months ago)
- Language: C#
- Size: 12.9 MB
- Stars: 1,036
- Watchers: 106
- Forks: 250
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
Lists
- awesome-unity-open-source-on-github - CharacterController2D - Character Controller 2D (Character Controller)
- awesome-unity - CharacterController2D - A 2D controller that behaves very similarly to Unity's CharacterController component. (Character Controllers)
- awesome-unity3d - CharacterController2D - is similar to the built-in Unity CharacterController component. It has a similar API (mainly a move method that takes a delta movement) and provides a firm base with which to make a super solid controller using Unity's 2D system. (Open Source Repositories / Character Controllers 2D)
- awesome-unity - CharacterController2D - A 2D controller that behaves very similarly to Unity's CharacterController component. (Character Controllers)
- awesome-opensource-unity - CharacterController2D - Similar to the built-in Unity CharacterController component. It has a similar API (mainly a move method that takes a delta movement) and provides a firm base with which to make a super solid controller using Unity's 2D system. (Open Source Packages / Character Controllers 2D)
- awesome - prime31/CharacterController2D - (C\#)
- awesome-unity - CharacterController2D - A 2D controller that behaves very similarly to Unity's CharacterController component. (Character Controllers <a name="character-controllers"></a> / 2D Character Controllers <a name="2d-character-controllers"></a>)
- AwesomeUnityCommunity - CharacterController2D - A 2D controller that behaves very similarly to Unity's CharacterController component. (Character Controllers <a name="character-controllers"></a> / 2D Character Controllers <a name="2d-character-controllers"></a>)
- fucking-awesome-unity - CharacterController2D - A 2D controller that behaves very similarly to Unity's CharacterController component. (Character Controllers)
README
CharacterController2D
=====================
CharacterController2D is similar to the built-in Unity CharacterController component. It has a similar API (mainly a *move* method that takes a delta movement) and provides a firm base with which to make a super solid controller using Unity's 2D system.
A simple demo scene is included along with a few Spelunky sprites (which obviously should not be used in your game!). An overview video showing how to get started is available on the prime31studios YouTube channel [here](http://www.youtube.com/watch?v=KpnImAdiiaQ&feature=youtu.be).
Demo Scene
=====================
The included demo scene is minimal to keep things as simple as possible. It has very basic input detection (using the arrow keys to move, jump and fall through one way platforms) and a simple character sprite/Animator setup. This should be simple enough for anyone with a rudimentry knowledge of Unity to read through and understand.
Basic Setup
=====================
Setup is pretty simple: drag the CharacterController2D onto your player/enemy GameObject and set the *platformMask* in the inspector to contain any layers that you want the player to collide with. If you will be using one way platforms, you can set the *oneWayPlatformMask* as well. Note that one way platforms should be EdgeCollider2Ds. *ProTip*: make sure your player is on a separate layer than your platforms so that she doesn't try to collide with herself! You will also want to make sure you BoxCollider2D is centered and has a zero horizontal offset. Flipping requires setting the scale.x to -1 so a horizontal offset other than zero will result in the collider jumping around.
You can then tweak the *totalHorizontalRays* and *totalVerticalRays* to your liking. When in the editor rays will be drawn with *Debug.DrawRay* so that you can make sure the ray resolution is appropriate for your smallest platform size. To turn off ray debugging just comment out the *#define DEBUG_CC2D_RAYS* line at the top of the CharacterController2D.cs file.
To move the player around just call *move* and provide it a delta movement (the physical distance the player should move this frame). You can subscribe to the *onControllerCollidedEvent* to be notified of all collisions if you need them.
In order to be able to receive trigger events (onTriggerEnter/Stay/Exit) the CharacterController2D needs to be told which layers it should interact with. Select the layers that should fire trigger events via the *triggerMask* field in the inspector.
License
-----
[Attribution-NonCommercial-ShareAlike 3.0 Unported](http://creativecommons.org/licenses/by-nc-sa/3.0/legalcode) with [simple explanation](http://creativecommons.org/licenses/by-nc-sa/3.0/deed.en_US). You are free to use the CharacterController2D in any and all games that you make. You cannot sell the CharacterController2D directly or as part of a larger game asset.