Various scripts and utilities for controlling characters in Unity. The project is intended to be self-documenting. Drop into the Scenes folder and take a look at each of them.
This is open source, if it doesn't do what you need raise and issue to see if it's something we will add. It's much more likely to be added if you provide the code - but don't worry about simply making suggestions. Bug reports are especially valuable. Use the issue tracker please.
You can either install as a package or from source. We recommend installing from source since this is open source code and we'd love you to contribute fixes, documentations, demo scenes and more. Below are instructions on how to install.
Note if you are on 2018 you will have to checkout the code into your project as we do not release unity packages. The below methods are best for 2019+
This method is super easy and doesn't require Git. However, it will not autoupdate:
Window -> Package Manager
- Click the '+" in the top left
- Select 'Add package from Git URL'
- Paste in
https://github.com/TheWizardsCode/Character.git#release/stable
We are a big fan of enabling our users to improve Dev Logger, so we would encourage you to use the source code, it's not much harder than using the package manager method and has the advantage of auto updating your projects when you make local modifications or do git pull
:
- Fork and clone the repo and submodules into your preferred location with
git clone --recurse-submodules [YOUR_FORK_URL]
- In the project view select
Assets/DevTest PackageManifestConfig
- In the inspector click
Export Package Source
, this will export the package to a folder next to your checkout director called "Character-Release" - To use this package in your development environments go to
Window -> Package Manager
- Click the '+" in the top left
- Select 'Add package from disk ...'
- Point to the
package.json
file in theCharacter-Release
directory
If you find a bug or want to make an improvement do it inside the Character project in Unity. To make it available to your work projects repeat step 2 and 3 above. This will re-publish your package locally and will be automatically picked up when you next give your development environment focus.
Once you have tested the changes please issue a pull request against our repo so we can make the code better for everyone.
We use PackageTools to create our releases. To build a release:
- Alongside your working repository checkout the
release/stable
branch of this repo into a directory calledCharacter-Release
usinggit clone --single-branch --branch release/stable git@github.com:TheWizardsCode/Character.git Character-Release
- Update the version number in the
Release PackageManifestConfig
to match that inDevTest PackageManifestConfig
(both are in the root of theAssets
folder) - Increase the version number in the
DevTest PackageManifestConfig
to represent the next release number (not this release) - Click
Generate VersionConstants.cs
in the inspector from the release package manifest - Commit the new constants file to Git
- Click
Export Package Source
in the inspector for theRelease Candidate PackageManifestConfig
- Commit and push the changes in
DevLogger-Release
to GitHub [But SEE BELOW] - Click
Generate VersionConstants.cs
in the inspector from the DevTest package manifest
NOTE there is currently a bug in the package manager tool that prevents the above from working, at least on my machine. You can work around the bug with the following steps:
- Delete the existing package directory
- Export the package source
- cd into the package directory
git init
git remote add origin git@github.com:TheWizardsCode/Character.git
git fetch
git add .
git commit -m "Release v0.2.5
git branch -m master release/stable
git push -f -u origin release/stable