https://github.com/cryru/emotion
A game engine.
https://github.com/cryru/emotion
c-sharp cross-platform emotion engine game game-development game-engine linux macos opengl
Last synced: 6 months ago
JSON representation
A game engine.
- Host: GitHub
- URL: https://github.com/cryru/emotion
- Owner: Cryru
- License: mit
- Created: 2016-10-11T13:34:07.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2025-04-02T20:14:25.000Z (6 months ago)
- Last Synced: 2025-04-09T14:14:10.277Z (6 months ago)
- Topics: c-sharp, cross-platform, emotion, engine, game, game-development, game-engine, linux, macos, opengl
- Language: C#
- Homepage:
- Size: 90.7 MB
- Stars: 56
- Watchers: 10
- Forks: 5
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Emotion
## What is it?
Emotion is a cross-platform game engine written in C# with minimal dependencies, for me to make games in. The engine is more targeted towards programmers and is alternative to stuff like MonoGame, FNA, and Love rather than Unity.
## Games
### [Electric Sleep](https://store.steampowered.com/app/1011620/Electric_Sleep/)
A visual novel for Windows, Linux, and x64 Mac.
The version this game was built on is kept in the "adfectus-backup" branch.
### [Escape the Arcana](https://store.steampowered.com/app/2953200/Escape_the_Arcana/)
A roguelike deckbuilder for Windows and Linux, with an Android version built but not published.
The version this game was built on is kept in the "EtA" branch.
## Documentation
Check out the "Tests" project for examples, the comments in code, and the [Emotion Examples project](https://github.com/Cryru/EmotionExamples) to learn more about how to use the engine. Proper documentation is a longterm goal.
## Requirements for Developers and Players:
- OpenGL 3.0 or higher supported hardware
- Or DirectX 11 if ANGLE is enabled
- Or a multi-core CPU if the Mesa software renderer is enabled
- WebGL 2.0 on Web
- Be able to run the Net 9 runtime.
- If older than Windows 10 you'll need the [C++ Redistributable 2015 Update 3](https://www.microsoft.com/en-us/download/details.aspx?id=52685)
- For Windows 7 you'll also need a specific security update [KB3063858](https://learn.microsoft.com/en-us/dotnet/core/install/windows?tabs=net60#dependencies)
- A supported platform:
- Windows 32 and 64 bit
- Linux 64 bit (Steam Deck works too)
- Android API 23+
- Or implement your own via PlatformBase :)
That's it.
## Developing and Building
It is recommended you develop with a cloned version of the Emotion repo linking Emotion.csproj in your solution. This way you have the most control over your code.
Using nuget packages, prebuilt dlls, and any other ways of linking Emotion is not supported.
## Projects Used
This includes dependencies and projects which were used for research references.
If you're distributing code using this project include the "LICENSE THIRD-PARTY" file from the repository.
| Library | License | Used For | Inclusion |
| -- | -- | -- | -- |
| .Net Core | MIT | Runtime | Nuget
| System.Numerics | MIT | Data structures and hardware intrinsics | Nuget
| [xxhash (pure C# implementation)](https://github.com/uranium62/xxHash) | MIT | Hashing data
| Forks
| [WinApi](https://github.com/prasannavl/WinApi) | Apache | Windows API Interop Headers | Platform/Implementation/Win32/Native
| [OpenGL.Net](https://github.com/luca-piccioni/OpenGL.Net) | MIT | OpenGL API | Platform/OpenGL
| [StbTrueType](https://github.com/nothings/stb/blob/master/stb_truetype.h) & [StbTrueTypeSharp](https://github.com/zwcloud/StbTruetypeSharp) | MIT & GPL3 | Font Rendering Option and Comparison | Referenced by Tests @ Tests/StbTrueType and Graphics/Text/StbGlyphRenderer
| [TiledSharp](https://github.com/marshallward/TiledSharp) | Apache 2.0 | .TMX Support | Uses custom XML and engine integration @ Standard/TMX
| Optional
| [Roslyn/Microsoft.CodeAnalysis.CSharp](https://github.com/dotnet/roslyn) | MIT | Runtime C# Script Compilation | Emotion.Plugins.CSharpScripting
| [CimGui](https://github.com/cimgui/cimgui) & [CimGui.Net](https://github.com/mellinoe/ImGui.NET) | MIT | Developer UI | Emotion.Plugins.ImGuiNet, Precompiled for Mac64, Linux64, and Win64
| [ANGLE](https://github.com/google/angle) | Google License | Compatibility | Precompiled for Win32 and Win64, Add "ANGLE" symbol
| [llvmpipe / Gallium / Mesa](https://mesa3d.org/) | MIT | Compatibility via Software Renderer | Precompiled for Win32 and Win64
| [Glfw](https://github.com/glfw/glfw) & [Glfw.Net](https://github.com/Chman/Glfw.Net) | Zlib | Mac and Linux Window Creation | Precompiled for Mac64, Linux64, Win32, and Win64, Add "GLFW" symbol
| [OpenAL-Soft](https://github.com/kcat/openal-soft) & [OpenAL.NetCore](https://github.com/nsglover/OpenAL.NETCore) | LGPL & MIT | Mac and Linux Audio | Precompiled for Mac64, Linux64, Win64, Add "OpenAL" symbol
| [Assimp](https://github.com/assimp/assimp) & [AssimpNet](https://github.com/assimp/assimp-net) | Modified BSD | Reading FBX files | The Emotion build tool
| [Assimp (Engine)](https://github.com/assimp/assimp) & [Silk.NET.Assimp](https://github.com/dotnet/Silk.NET/pkgs/nuget/Silk.NET.Assimp) | Modified BSD & MIT | 3D Model preview and conversion | Add "ASSIMP" symbol
| [SixLabors.ImageSharp](https://github.com/SixLabors/ImageSharp) | Six Labors Split License | Developer loading and conversion of unsupported image types such as "jpg" | Add "MORE_IMAGE_TYPES" symbol
| References
| [McGill Engineering](http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Samples.html) | X | Hardening WAV and Audio Implementation | None
| [PNGSuite](http://www.schaik.com/pngsuite/) | X | Hardening PNG Implementation | None
| [OpenType.JS](https://opentype.js.org/) | X | Font Parsing Reference | None
| [Nine.Imagine](https://github.com/yufeih/Nine.Imaging) | X | Image Parsing Comparison | None
| [ImageSharp](https://github.com/SixLabors/ImageSharp) | X | Quirky Image Format Reference | None
| [OpenAL-Soft](https://github.com/kcat/openal-soft/) | X | Audio Code Reference | None
| [NAudio](https://github.com/naudio/NAudio) | X | Audio Code Reference | None
| [Audacity](https://github.com/audacity) | X | Audio Code Reference | None
| [Astiopin's SDF generator](https://github.com/astiopin/sdf_atlas) | X | EmotionSDF4 atlas generation reference | None