MonoGame.Aseprite
6.1.0
dotnet add package MonoGame.Aseprite --version 6.1.0
NuGet\Install-Package MonoGame.Aseprite -Version 6.1.0
<PackageReference Include="MonoGame.Aseprite" Version="6.1.0" />
paket add MonoGame.Aseprite --version 6.1.0
#r "nuget: MonoGame.Aseprite, 6.1.0"
// Install MonoGame.Aseprite as a Cake Addin #addin nuget:?package=MonoGame.Aseprite&version=6.1.0 // Install MonoGame.Aseprite as a Cake Tool #tool nuget:?package=MonoGame.Aseprite&version=6.1.0
<h1 align="center"> <img src="https://raw.githubusercontent.com/AristurtleDev/monogame-aseprite/main/.images/banner.png" alt="MonoGame.Aseprite Logo"> <br/> A Cross Platform C# Library That Adds Support For Aseprite Files in MonoGame Projects.
</h1>
Monogame.Aseprite is a free and open source library for the MonoGame Framework that assists in importing Aseprite files into your game project. No need to export a spritesheet from Aseprite and have to deal with a PNG + JSON import. With MonoGame.Aseprite, you can use the Aseprite file directly.
Features
- MonoGame.Aseprite internally uses AsepriteDotNet to read and parse the aseprite files. This means you get all the features of AsepriteDotNet including
- Supports Aseprite files using RGBA, Grayscale, and Indexed color modes.
- Supports all Aseprite layer blend modes.
- Supports Aseprite tilesets, tilemap layers, and tilemap cels.
- Provides processors to convert the Aseprite data into common formats including:
- Sprite
- SpriteSheet
- TextureAtlas
- Tileset
- Tilemap
- AnimatedTilemap
Installation
Install via NuGet
dotnet add package MonoGame.Aseprite --version 6.1.0
Usage
Please refer to the Examples directory for samples of how to use this library. Each example is thoroughly commented with information to show you how to load the Aseprite file and use it within Monogame.
What Next?
- Read the documentation.
- Join the Discord to ask questions or keep up to date.
- Submit an issue on GitHub.
- Twitter.
Games Made With MonoGame.Aseprite
The following are games that have been made using MonoGame.Aseprite as part of the content workflow in MonoGame
Game | Developer Links |
---|---|
<h3 align="center">Superstar Strategy</h3> <img src="https://cdn.akamai.steamstatic.com/steam/apps/1756730/header.jpg?t=1696817764"> | <ul><li>Steam: <a href="https://store.steampowered.com/app/1756730/Superstar_Strategy/">https://store.steampowered.com/app/1756730/Superstar_Strategy/</a></li><li>Twitter: <a href="https://x.com/TalberonGames">https://x.com/TalberonGames</a></li></ul> |
<h3 align="center">Unnamed</h3> <img src="https://img.itch.zone/aW1nLzEzNjQ1MTM5LnBuZw==/original/yOAqCD.png"/> | <ul><li>Itch.io: <a href="https://fypur.itch.io/unnamed">https://fypur.itch.io/unnamed</a></li><li>Youtube: <a href="https://youtube.com/c/fypur">https://youtube.com/c/fypur</a></li></ul> |
Support
If you would like to support this project in any way, there are quite a few ways to do this no matter who you are.
- Tell others about this project.
- Contribute to this project (Please ensure you read the Contributing Guide).
- Submit an Issue if you find a problem
- Star this project on Github.
If you would prefer to send me a tip/donation, you can do so at my Ko-fi page. This is always appreciated and all donations go towards funding projects of mine such as this one.
You can also support me through GitHub Sponsors. This and the Ko-Fi links can both be found in the sidebar to the right on this repository page.
The following is a list of amazing people that have donated to sponsor this project. If you have donated but weren't added to the list, please get in contact with me.
License
MonoGame.Aseprite is licensed under the MIT License. Please refer to the LICENSE file for full license text.
Contributors
<a href="https://github.com/aristurtledev/monoame-aseprite/graphs/contributors"> <img src="https://contrib.rocks/image?repo=aristurtledev/monogame-aseprite" /> </a>
Made with contrib.rocks.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- AsepriteDotNet (>= 1.9.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on MonoGame.Aseprite:
Package | Downloads |
---|---|
MonoGame.Reload
Hot-reloading for MonoGame |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
6.1.0 | 156 | 9/27/2024 | |
6.0.7 | 274 | 8/19/2024 | |
6.0.6 | 183 | 7/16/2024 | |
6.0.5 | 221 | 5/31/2024 | |
6.0.4 | 122 | 5/2/2024 | |
6.0.3 | 171 | 4/2/2024 | |
6.0.2 | 159 | 4/2/2024 | |
6.0.1 | 115 | 4/2/2024 | |
6.0.0 | 134 | 3/26/2024 | |
5.1.3 | 172 | 3/13/2024 | |
5.1.3-beta-3 | 191 | 1/16/2024 | |
5.1.3-beta-2 | 129 | 1/12/2024 | |
5.1.3-beta-1 | 113 | 1/12/2024 | |
5.1.2 | 587 | 12/2/2023 | |
5.1.1 | 636 | 9/28/2023 | |
5.1.0 | 546 | 8/22/2023 | |
5.0.1 | 413 | 3/28/2023 | |
5.0.0 | 350 | 3/7/2023 | |
4.0.6 | 285 | 3/1/2023 | |
4.0.5 | 256 | 2/27/2023 | |
4.0.4 | 273 | 2/27/2023 | |
4.0.3 | 277 | 2/26/2023 | |
4.0.2 | 306 | 2/22/2023 | |
4.0.0 | 276 | 2/21/2023 | |
3.1.1 | 448 | 11/21/2022 | |
3.1.0 | 505 | 8/29/2022 | |
3.0.0-prerelease | 199 | 4/21/2022 | |
2.0.5 | 624 | 5/4/2022 | |
2.0.4.1 | 878 | 1/25/2021 | |
2.0.3.3 | 600 | 12/12/2020 | |
2.0.2-beta | 293 | 12/10/2020 | |
2.0.1-beta | 300 | 12/8/2020 | |
1.2.2 | 556 | 10/1/2020 | |
1.1.1 | 824 | 4/11/2019 | |
1.1.0 | 627 | 4/10/2019 | |
1.0.0 | 832 | 9/30/2018 |
Updated for MonoGame 3.8.2.1105 and net8.0