PalicoEngine

main

Metal-Based Game Engine in Swift 🐑
forkercat/PalicoEngine

Palico Engine: Metal-Based Game Engine in Swift 🐑

macOS license

platform-compatibility swift-version-compatibility

Implement a game engine on macOS using Metal API. Still in development. Currently I am working on a more capable entity-component-system MothECS :)

Palico Engine Screenshot

Palico - It is a cat-like combat companion in Monster Hunter!

This is Palico! Credits: Francesco

Palico Engine's Sprint Board on Jira (need permission request). Currently there are 65 issues in total!

🔧 Install & Run

# Clone
git clone https://github.com/forkercat/PalicoEngine.git
cd PalicoEngine

# Compile
swift build

# Run
swift run Editor

📝 User Guide

Mouse Controls:

  • Command + Left: Rotate camera
  • Right: Look around
  • Middle: Pan
  • Scroll: Zoom in/out

Keyboard Controls:

  • Tab: Select next in-scene object
  • F: Focus on object
  • Q: No action
  • W: Translate
  • E: Rotate
  • R: Scale

Create GameObject:

Palico Engine Screenshot

🍻 Dependencies

dependencies: [
    .package(url: "https://github.com/forkercat/OhMyLog.git", .branch("main")),
    .package(url: "https://github.com/forkercat/MathLib.git", .branch("main")),
    .package(url: "https://github.com/forkercat/MothECS.git", .branch("main")),
    .package(url: "https://github.com/forkercat/SwiftImGui.git", .branch("update-1.86-docking")),  // forked from @ctreffs
    .package(url: "https://github.com/forkercat/SwiftImGuizmo.git", .branch("master")),            // forked from @ctreffs
],

Thanks to SwiftImGui by @ctreffs I am able to use ImGui in this application.

I forked the repository and wrapped ImGui v1.86 and added new OSX backend file. Related PRs:

🥺 Future Development

Rendering:

  • Add skybox
  • Add shadow
  • Support PBR
  • Support deferred rendering (render pass has already been setup)

Model:

  • Load 3D models
  • Load textures in models
  • Load animation

Other:

  • Improve MothECS
  • Integrate ImGuizmo
  • Property/Inspector panel
  • Game object selection
  • Scene loading (yaml)
  • Content browser (Asset Panel)

🙏 Reference

Started by following game engine turotial series by TheCherno and wrote implementation in C++. Also check out Hazel Engine repository. It is a great learning resource!

Description

  • Swift Tools 5.3.0
View More Packages from this Author

Dependencies

Last updated: Fri Oct 18 2024 02:31:11 GMT-0900 (Hawaii-Aleutian Daylight Time)