CORE/README.md

32 lines
1.3 KiB
Markdown
Raw Normal View History

# StarOpenSource CORE (aka. SOSCORE aka. CORE)
2023-03-18 16:34:12 +01:00
CORE is a framework that simplifies development for games and applications made in Godot 4.
# Documentaton
[You can access the documentation by clicking this text.](https://git.staropensource.de/StarOpenSource/core/wiki)
2023-03-18 16:34:12 +01:00
# For whom is it useful?
2023-03-18 18:43:40 +01:00
CORE is only useful for new projects. Already existing projects could break because CORE has certain requirements that must be met.
2023-03-18 16:34:12 +01:00
# Requirements
- No autoload singletons are allowed before CORE has initialized
- Startup scene must be res://CORE/background.tscn
2023-03-18 16:34:12 +01:00
- Scene management must be done with smgr (the CORE scene manager)
- Logging should be handled using the CORE logger
# How to install
- Clone CORE into your project root using `git clone https://git.staropensource.de/StarOpenSource/core.git CORE`
- Remove any autoload singletons
2023-03-18 16:34:12 +01:00
- Add three scripts to your autoload:
| Name | Path |
| ------------ | -------------------------- |
| coreloader | res://CORE/coreloader.gd |
| Logger | res://CORE/logger.gd |
| Preprocessor | res://CORE/preprocessor.gd |
- Select res://CORE/background.tscn as your startup scene
- [Follow the post-installation guide](https://git.staropensource.de/StarOpenSource/core/wiki/Using-CORE)
2023-03-18 16:34:12 +01:00
# How to update
- Close your project
2023-03-18 16:34:12 +01:00
- Pull new changes using `git pull`
- Reopen your project