catgirl-engine

Crates.io	catgirl-engine
lib.rs	catgirl-engine
version
source	src
created_at	2023-06-09 04:59:50.977932
updated_at	2024-12-05 18:14:39.187841
description	A game engine for cool moddability and procedurally generated data
homepage	https://github.com/foxgirl-labs/catgirl-engine
repository	https://github.com/foxgirl-labs/catgirl-engine.git
max_upload_size
id	885998
Cargo.toml error:	TOML parse error at line 18, column 1 \| 18 \| autolib = false \| ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size	0

Alexis (lexi-the-cute)

documentation

https://docs.rs/catgirl-engine

README

What's This Repo

This repo is hosted on Codeberg, Github.

Why Yet Another Engine

This game engine is designed around moddability. This will allow people to make different games based on it, which should hypothetically all be compatible with each other. In order to enforce the spirit of the design, the game built into the engine will itself be a mod.

The engine will also allow transferring items and other entities between single player and multiplayer including transferring modded items from a modded server to a vanilla client.

Hypothetically, if a person develops a different game, like a horror game, it should be possible to join the server for that game from any other game made on the engine including the built in game.

I'm also considering the idea of inter-server communication, but for now, communication happens through the client transferring items and entities.

Download

Itch.io

Setup Build Environment

Debian x86_64

# Update APT
sudo apt update

# Install Required Packages
sudo apt install git gcc

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Run Cargo Environment Setup Script
source "$HOME/.cargo/env"

# Download Stable Toolchain
rustup default stable

# Download Stable Rust's Source Code
rustup component add rust-src --toolchain stable

# Download This Repo
git clone https://github.com/foxgirl-labs/catgirl-engine

# Switch To Project Root
cd catgirl-engine

Build

Desktop

# Compile Program
cargo build

Android

# Assuming In Project Root "catgirl-engine" From Debian x86_64

# Install Java If Not Already Installed
sudo apt -y install openjdk-17-jre-headless

# Add Build Targets Once
rustup target add armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android

# Install Cargo-NDK Once
cargo install cargo-ndk

# Workaround Cargo Gradle Plugin Bug Once
touch android/local.properties

# Build Android APK
cd android
./gradlew assembleDebug

# Copy Android APK To Project Root
cp app/build/outputs/apk/debug/*.apk ..

Others

Other build process can be read from the files stored in ./.github/workflows. Most build files build on x86_64 Ubuntu with the exception of Mac OSX which builds on 64 Bit OSX.

Running

On Linux, you can view more log messages by running RUST_LOG=catgirl_engine=debug path/to/engine or RUST_LOG=debug path/to/engine.

On Android, you can view more log messages with ADB by running adb logcat -v tag,color -s CatgirlEngineApp CatgirlEngine:D. You can clear the log by running adb logcat -c.

If you want to use traces, you can setup your own tracing subscriber if importing as a library.

Docs

Root
Client
Server
Utils
Macros
[Common][catgirl-engine-commons-docs]

GPG Keys

Main Key 0x1E4A9B8B9E3F25B9C3CD1664C7E8D57343655237

Signing Key 0xE382EE8AE2F4AFB1B18148DFD83603BC74A7BA9C

Commit count: 1204